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

# 940

> Wire-ready X12 940 interchange

### Path parameters

<ParamField path="partner_id" type="string" required>
  Partner ID
</ParamField>

### Request body

`Ship940`

<ParamField body="carrier_scac" type="string">
  W6603 — carrier SCAC for routing.
</ParamField>

<ParamField body="items" type="ShipItem[]" required />

<ParamField body="order_number" type="string" required>
  W0502 — depositor (our) order number.
</ParamField>

<ParamField body="po_number" type="string">
  W0503 — the customer PO this order fulfills, when there is one.
</ParamField>

<ParamField body="requested_ship_date" type="string (date)">
  G62\*10 — requested ship date.
</ParamField>

<ParamField body="ship_to" type="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 |

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://edi.stateset.com/v1/edi/outbound/940/{partner_id}' \
    --header 'Authorization: Bearer YOUR_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"
    }
  }'
  ```
</RequestExample>