753

Wire-ready X12 753 routing request

POST /v1/edi/outbound/753/{partner_id}

cURL

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

partner_id · string · required

Partner ID

Headers

Idempotency-Key · 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

orders · RoutingOrder[] · required

One entry per purchase order the shipment covers.

Show RoutingOrder

cartons · integer (int32) · required

OID04/OID05 — number of cartons (packaging code CTN). Minimum: 0.

po_number · string · required

OID02 — the retailer’s PO number.

reference · string,null

OID01 — an optional supplier reference for this PO’s freight (e.g. the supplier’s order or shipment line id).

volume · string,null

OID09 — volume of this PO’s freight, when measured.

weight · string · required

OID07 — gross weight of this PO’s freight.

pallets · integer,null (int32)

Total pallets in the shipment (AT804). Omit for floor-loaded freight. Minimum: 0.

ready_date · string (date) · required

G62 — date the freight is ready to ship (qualifier from ready_date_qualifier, default 10).

ready_date_qualifier · string,null

G62 date qualifier for ready_date. Guides differ; override when the retailer’s routing guide calls for another code.

request_date · string,null (date)

BGN03 — date the request was created. Defaults to ready_date.

request_id · string · required

BGN02 — the supplier’s routing-request identifier (the retailer echoes it in the 754).

ship_from · Party · required

N1*SF loop — where the freight is picked up.

Show Party

address_lines · string[]

city · string,null

country · string,null

id · string,null

id_qualifier · string,null

N103/N104 — identification qualifier and code (e.g. 92 + store #).

name · string · required

postal_code · string,null

role · string · required

N101 entity identifier code: ST ship-to, BT bill-to, SF ship-from, VN vendor, BY buyer, …

state · string,null

ship_to · Party,null

An N1 party loop (N1/N2/N3/N4).

Show Party

address_lines · string[]

city · string,null

country · string,null

id · string,null

id_qualifier · string,null

N103/N104 — identification qualifier and code (e.g. 92 + store #).

name · string · required

postal_code · string,null

role · string · required

N101 entity identifier code: ST ship-to, BT bill-to, SF ship-from, VN vendor, BY buyer, …

state · string,null

volume_uom · string,null

Volume unit for every volume in the request (AT806/OID08; default E cubic feet).

weight_uom · 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

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"
}'