curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/orders/{po_number}/{set}/{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 'If-Order-Revision: REPLACE_WITH_IF_ORDER_REVISION' \
--header 'Content-Type: application/json' \
--data @reviewed-overrides.json
Send a reviewed order document
Send the frozen overrides from an 855, 856 or 810 preview. Retain the original Idempotency-Key and If-Order-Revision before dispatch…
POST
/
v1
/
orders
/
{po_number}
/
{set}
/
{partner_id}
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/orders/{po_number}/{set}/{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 'If-Order-Revision: REPLACE_WITH_IF_ORDER_REVISION' \
--header 'Content-Type: application/json' \
--data @reviewed-overrides.json
Send the frozen overrides from an 855, 856 or 810 preview. Retain the original Idempotency-Key and If-Order-Revision before dispatch; PostgreSQL is required for guarded sends. Read the preview and review its prepared document and blockers first. After an uncertain response, recover this original operation rather than constructing another key or payload. See /stateset-edi/orders-and-recovery.
Path parameters
string
required
Buyer PO number (BEG03)
string
required
855, 856 or 810
string
required
Partner ID
Headers
string,null
Stable unique request key (1–128 ASCII letters/digits or -_.:). Requires Postgres. Retries return the original EDI bytes; a changed overrides body returns 409.
string,null
Revision returned by order preview; requires Idempotency-Key. Atomic acceptance rejects stale order or partner configuration.
Request body
Ack855Overrides | Asn856Overrides | Invoice810Overrides
string,null (date)
string,null
AckLineOverride[]
Response
No response body. Wire-ready X12 interchange; X-EDI-Compliance-Warnings carries the issue count.Status codes
| Code | Meaning |
|---|---|
200 | Wire-ready X12 interchange; X-EDI-Compliance-Warnings carries the issue count |
403 | Not this credential’s partner |
404 | Unknown partner, or no accepted 850 for this PO |
409 | PO cancelled, nothing remaining, or Idempotency-Key reused with a different body |
422 | Invalid overrides, or blocked by outbound compliance (issues in error.issues) |
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 --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/orders/{po_number}/{set}/{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 'If-Order-Revision: REPLACE_WITH_IF_ORDER_REVISION' \
--header 'Content-Type: application/json' \
--data @reviewed-overrides.json
Last modified on October 20, 2026