940

Wire-ready X12 940 interchange

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

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/edi/outbound/940/{partner_id}' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "carrier_scac": "string",
  "items": [
    {
      "description": "Two-person tent, green — replacement for damaged pole set.",
      "quantity": "string",
      "sku": "SKU-TENT-2P-GRN",
      "sku_qualifier": "string",
      "uom": "string"
    }
  ],
  "order_number": "ORD-10042",
  "po_number": "ORD-10042",
  "requested_ship_date": "2026-08-31",
  "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"
  }
}'

Path parameters

partner_id · string · required

Partner ID

Request body

Ship940

carrier_scac · string

W6603 — carrier SCAC for routing.

items · ShipItem[] · required

order_number · string · required

W0502 — depositor (our) order number.

po_number · string

W0503 — the customer PO this order fulfills, when there is one.

requested_ship_date · string (date)

G62*10 — requested ship date.

ship_to · object

Response

No response body. Wire-ready X12 940 interchange.

Status codes

Code	Meaning
200	Wire-ready X12 940 interchange
403	Not this credential’s partner
422	Invalid payload or delimiter collision

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/edi/outbound/940/{partner_id}' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "carrier_scac": "string",
  "items": [
    {
      "description": "Two-person tent, green — replacement for damaged pole set.",
      "quantity": "string",
      "sku": "SKU-TENT-2P-GRN",
      "sku_qualifier": "string",
      "uom": "string"
    }
  ],
  "order_number": "ORD-10042",
  "po_number": "ORD-10042",
  "requested_ship_date": "2026-08-31",
  "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"
  }
}'