curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/753/{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 '{
"orders": [
{
"cartons": 1,
"po_number": "ORD-10042",
"reference": "ORD-10042",
"volume": "string",
"weight": "string"
}
],
"pallets": 1,
"ready_date": "2026-08-31",
"ready_date_qualifier": "string",
"request_date": "2026-08-31",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ship_from": {
"address_lines": [
"548 Market St"
],
"city": "San Francisco",
"country": "US",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id_qualifier": "string",
"name": "Two-Person Tent",
"postal_code": "94107",
"role": "string",
"state": "CA"
},
"ship_to": {
"address_lines": [
"548 Market St"
],
"city": "San Francisco",
"country": "US",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id_qualifier": "string",
"name": "Two-Person Tent",
"postal_code": "94107",
"role": "string",
"state": "CA"
},
"volume_uom": "string",
"weight_uom": "string"
}'
753
Wire-ready X12 753 routing request
POST
/
v1
/
edi
/
outbound
/
753
/
{partner_id}
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/753/{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 '{
"orders": [
{
"cartons": 1,
"po_number": "ORD-10042",
"reference": "ORD-10042",
"volume": "string",
"weight": "string"
}
],
"pallets": 1,
"ready_date": "2026-08-31",
"ready_date_qualifier": "string",
"request_date": "2026-08-31",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ship_from": {
"address_lines": [
"548 Market St"
],
"city": "San Francisco",
"country": "US",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id_qualifier": "string",
"name": "Two-Person Tent",
"postal_code": "94107",
"role": "string",
"state": "CA"
},
"ship_to": {
"address_lines": [
"548 Market St"
],
"city": "San Francisco",
"country": "US",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id_qualifier": "string",
"name": "Two-Person Tent",
"postal_code": "94107",
"role": "string",
"state": "CA"
},
"volume_uom": "string",
"weight_uom": "string"
}'
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
RoutingRequest753
RoutingOrder[]
required
One entry per purchase order the shipment covers.
Show RoutingOrder
Show RoutingOrder
integer (int32)
required
OID04/OID05 — number of cartons (packaging code
CTN). Minimum: 0.string
required
OID02 — the retailer’s PO number.
string,null
OID01 — an optional supplier reference for this PO’s freight (e.g. the supplier’s order or shipment line id).
string,null
OID09 — volume of this PO’s freight, when measured.
string
required
OID07 — gross weight of this PO’s freight.
integer,null (int32)
Total pallets in the shipment (AT804). Omit for floor-loaded freight. Minimum:
0.string (date)
required
G62 — date the freight is ready to ship (qualifier from
ready_date_qualifier, default 10).string,null
G62 date qualifier for
ready_date. Guides differ; override when the retailer’s routing guide calls for another code.string,null (date)
BGN03 — date the request was created. Defaults to
ready_date.string
required
BGN02 — the supplier’s routing-request identifier (the retailer echoes it in the 754).
Party
required
N1*SF loop — where the freight is picked up.
Party,null
An N1 party loop (N1/N2/N3/N4).
string,null
Volume unit for every volume in the request (AT806/OID08; default
E cubic feet).string,null
Weight unit for every weight in the request (AT802/OID06; default
L pounds).Response
No response body. Wire-ready X12 753 routing request.Status codes
| Code | Meaning |
|---|---|
200 | Wire-ready X12 753 routing request |
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/753/{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 '{
"orders": [
{
"cartons": 1,
"po_number": "ORD-10042",
"reference": "ORD-10042",
"volume": "string",
"weight": "string"
}
],
"pallets": 1,
"ready_date": "2026-08-31",
"ready_date_qualifier": "string",
"request_date": "2026-08-31",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ship_from": {
"address_lines": [
"548 Market St"
],
"city": "San Francisco",
"country": "US",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id_qualifier": "string",
"name": "Two-Person Tent",
"postal_code": "94107",
"role": "string",
"state": "CA"
},
"ship_to": {
"address_lines": [
"548 Market St"
],
"city": "San Francisco",
"country": "US",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id_qualifier": "string",
"name": "Two-Person Tent",
"postal_code": "94107",
"role": "string",
"state": "CA"
},
"volume_uom": "string",
"weight_uom": "string"
}'
Last modified on October 20, 2026