curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/846/{partner_id}' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header "Idempotency-Key: ${IDEMPOTENCY_KEY:?Set a unique key for this operation; preserve it on retries}" \
--header 'Content-Type: application/json' \
--data @inventory-advice.json
"string"
Send inventory advice (846)
Build and dispatch an X12 846 inventory advice. Save the payload validated for your trading partner as inventory-advice.json and use that partner’s identifier…
POST
/
v1
/
edi
/
outbound
/
846
/
{partner_id}
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/846/{partner_id}' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header "Idempotency-Key: ${IDEMPOTENCY_KEY:?Set a unique key for this operation; preserve it on retries}" \
--header 'Content-Type: application/json' \
--data @inventory-advice.json
"string"
Build and dispatch an X12 846 inventory advice. Save the payload validated for your trading partner as inventory-advice.json and use that partner’s identifier. The successful response is wire-ready X12, not JSON; dispatch and partner acceptance require separate verification.
Path parameters
string
required
Partner ID
Headers
string,null
Stable unique request key (1–128 ASCII letters/digits or -_.:). Requires Postgres. Retries return the original EDI bytes; changed JSON payload returns 409.
Request body
InventoryAdvice846
string,null (date)
BIA04.
InventoryItem[]
required
Show InventoryItem
Show InventoryItem
string,null
PID05 of the F-format description, when present.
ProductId[]
required
string,null
LIN01 — assigned line number (optional in the spec).
InventoryQuantity[]
required
QTY segments for this item, one per reported quantity kind.
Party[]
string
required
BIA01 — transaction set purpose (00 original, 05 replace, …).
string
required
BIA03 — the sender’s reference identification for this report.
string
required
BIA02 — report type code (e.g.
PQ product activity, SI current summary inventory).Response
Returnsapplication/edi-x12 — Wire-ready X12 846 interchange.
Status codes
| Code | Meaning |
|---|---|
200 | Wire-ready X12 846 interchange |
403 | Not this credential’s partner |
409 | Idempotency-Key reused with a different payload |
422 | Invalid payload or delimiter collision |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/846/{partner_id}' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header "Idempotency-Key: ${IDEMPOTENCY_KEY:?Set a unique key for this operation; preserve it on retries}" \
--header 'Content-Type: application/json' \
--data @inventory-advice.json
"string"
Last modified on October 20, 2026