curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/856/{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 '{
"shipment_id": "SHIP-123",
"ship_date": "2026-10-20",
"carrier_scac": "UPSN",
"orders": [
{
"po_number": "PO-123",
"cartons": [
{
"sscc": "000123456000000012",
"items": [
{
"sku": "SKU-123",
"quantity": "3",
"sku_qualifier": "SK",
"uom": "EA"
}
]
}
]
}
]
}'
856
Wire-ready X12 856 interchange
POST
/
v1
/
edi
/
outbound
/
856
/
{partner_id}
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/856/{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 '{
"shipment_id": "SHIP-123",
"ship_date": "2026-10-20",
"carrier_scac": "UPSN",
"orders": [
{
"po_number": "PO-123",
"cartons": [
{
"sscc": "000123456000000012",
"items": [
{
"sku": "SKU-123",
"quantity": "3",
"sku_qualifier": "SK",
"uom": "EA"
}
]
}
]
}
]
}'
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
Asn856
string,null
REF*BM — bill of lading.
string,null
TD503 — Standard Carrier Alpha Code.
AsnOrder[]
required
Show AsnOrder
Show AsnOrder
AsnPack[]
Carton/pack level: each carton carries an SSCC-18 (emitted as
HL*…*P with MAN*GM) and the items packed in it. When non-empty, the ASN uses the S→O→P→I hierarchy retailers like QVC require, and items is ignored.AsnItem[]
AsnPallet[]
Pallet (tare) level: each pallet carries its own SSCC-18 (emitted as
HL*…*T with MAN*GM) and the cartons stacked on it, giving the S→O→T→P→I hierarchy. Pallets are emitted before any loose cartons (cartons shipped under the order without a pallet). When non-empty, items is ignored. Empty by default, so existing payloads (and their wire output) are unchanged.string
required
PRF01 — the buyer’s PO number this shipment fulfills.
integer,null (int32)
TD101 / TD102 — packaging code and lading quantity (e.g. CTN25 × 3). Minimum:
0.string (date)
required
Party,null
An N1 party loop (N1/N2/N3/N4).
string,null
HHMM; defaults to 0000 on the wire when absent.
Party,null
An N1 party loop (N1/N2/N3/N4).
string
required
BSN02 — shipment identification.
string,null
REF*CN — carrier pro / tracking number.
string,null
TD504 — transportation method (M motor, A air, …).
string,null
TD107/TD108 — total weight and unit.
string,null
Response
No response body. Wire-ready X12 856 interchange.Status codes
| Code | Meaning |
|---|---|
200 | Wire-ready X12 856 interchange |
403 | Not this credential’s partner |
409 | Idempotency-Key reused with a different payload |
422 | Invalid payload or delimiter collision, or blocked by the partner’s outbound compliance policy (issues in error.issues). Sent documents carry X-EDI-Compliance-Warnings with the pre-send issue count |
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/856/{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 '{
"shipment_id": "SHIP-123",
"ship_date": "2026-10-20",
"carrier_scac": "UPSN",
"orders": [
{
"po_number": "PO-123",
"cartons": [
{
"sscc": "000123456000000012",
"items": [
{
"sku": "SKU-123",
"quantity": "3",
"sku_qualifier": "SK",
"uom": "EA"
}
]
}
]
}
]
}'
Last modified on October 20, 2026