> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 753

> Wire-ready X12 753 routing request

### 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.

**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.

**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).

**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](/spec/edi.json) for declared schemas and alternatives.
This page also includes documented corrections from the [spec overlays](https://github.com/stateset/docs/tree/main/spec/overlays).
Example IDs and values are illustrative; replace them with records from your workspace.

```bash cURL theme={null}
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"
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.