204

Wire-ready X12 204 load tender

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

cURL

curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.edi.stateset.com/v1/edi/outbound/204/{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 '{
  "bol_number": "string",
  "carrier_scac": "string",
  "orders": [
    {
      "po_number": "ORD-10042",
      "quantity": "2",
      "weight": "string"
    }
  ],
  "payment_method": "card",
  "pickup_date": "2026-08-31",
  "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"
  },
  "shipment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "weight": "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

Tender204

bol_number · string,null

L11*BM — bill of lading number.

carrier_scac · string · required

B202 — Standard Carrier Alpha Code of the tendered carrier.

orders · TenderOrder[] · required

Show TenderOrder

po_number · string · required

OID02 — the purchase order this freight covers.

quantity · string · required

OID04 — number of units.

weight · string,null

OID05/OID06 — weight, when given per order.

payment_method · string,null

B206 — method of payment: PP prepaid (default), CC collect.

pickup_date · string,null (date)

G62*69 — requested pickup date.

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

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

shipment_id · string · required

B204 — shipment identification (the carrier echoes it in the 990/214).

weight · string,null

AT803 — total shipment weight.

weight_uom · string,null

AT802 — weight unit (default L pounds).

Response

No response body. Wire-ready X12 204 load tender.

Status codes

Code	Meaning
200	Wire-ready X12 204 load tender
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/204/{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 '{
  "bol_number": "string",
  "carrier_scac": "string",
  "orders": [
    {
      "po_number": "ORD-10042",
      "quantity": "2",
      "weight": "string"
    }
  ],
  "payment_method": "card",
  "pickup_date": "2026-08-31",
  "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"
  },
  "shipment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "weight": "string",
  "weight_uom": "string"
}'