943

Wire-ready X12 943 interchange

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

cURL

curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.edi.stateset.com/v1/edi/outbound/943/{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 '{
  "carrier_scac": "string",
  "items": [
    {
      "quantity": "2",
      "sku": "SKU-TENT-2P-GRN",
      "sku_qualifier": "string",
      "uom": "string"
    }
  ],
  "ship_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",
  "transfer_number": "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

Transfer943

carrier_scac · string,null

W2702 — carrier SCAC.

items · TransferItem[] · required

Show TransferItem

quantity · string · required

sku · string · required

sku_qualifier · string

W0404 identifier qualifier (SK / VN / UP).

uom · string

ship_date · string (date) · required

W0603 / G62*11 — ship 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

W0604 — the shipment identification for this transfer.

transfer_number · string · required

W0602 — depositor (our) order/transfer number.

Response

No response body. Wire-ready X12 943 interchange.

Status codes

Code	Meaning
200	Wire-ready X12 943 interchange
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/943/{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 '{
  "carrier_scac": "string",
  "items": [
    {
      "quantity": "2",
      "sku": "SKU-TENT-2P-GRN",
      "sku_qualifier": "string",
      "uom": "string"
    }
  ],
  "ship_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",
  "transfer_number": "string"
}'