curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/operations/orders/{partner_id}/{po_number}/preview/{set}' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header 'Content-Type: application/json' \
--data '{}'
{
"success": true,
"data": {
"document": {},
"overrides": {
"ack_date": "2026-08-31",
"ack_type": "string",
"lines": [
{
"line_number": "string",
"quantity": "2",
"status": "pending"
}
]
},
"order_revision": "string",
"passed": true,
"issues": [
{}
]
}
}
Preview an order response
Prepare an 855, 856 or 810 without dispatch. Inspect the prepared payload, findings and revision…
POST
/
v1
/
operations
/
orders
/
{partner_id}
/
{po_number}
/
preview
/
{set}
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/operations/orders/{partner_id}/{po_number}/preview/{set}' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header 'Content-Type: application/json' \
--data '{}'
{
"success": true,
"data": {
"document": {},
"overrides": {
"ack_date": "2026-08-31",
"ack_type": "string",
"lines": [
{
"line_number": "string",
"quantity": "2",
"status": "pending"
}
]
},
"order_revision": "string",
"passed": true,
"issues": [
{}
]
}
}
Prepare an 855, 856 or 810 without dispatch. Inspect the prepared payload, findings and revision. Freeze the returned date overrides and retain them with the original key and revision for a reviewed send. A preview is not authorization or partner acceptance.
Path parameters
string
required
Partner
string
required
Purchase order
string
required
855, 856 or 810
Request body
Ack855Overrides | Asn856Overrides | Invoice810Overrides
string,null (date)
string,null
AckLineOverride[]
Response
object
boolean
required
object
required
Show data
Show data
object
required
Prepared 855, 856 or 810; retain exact business content.
Ack855Overrides | Asn856Overrides | Invoice810Overrides
required
Select the override schema matching the set path parameter; do not combine transaction types.
Show overrides
Show overrides
Show Option 1: Ack855Overrides
Show Option 1: Ack855Overrides
Show Option 2: Asn856Overrides
Show Option 2: Asn856Overrides
856 overrides. With
cartons, the shipment is exactly the carton contents (S→O→P→I with SSCC-18s); else with lines, exactly those line quantities; else every line’s remaining quantity.string,null
string,null
CartonOverride[]
LineQuantity[]
integer,null (int32)
Minimum:
0.string,null (date)
Party,null
An N1 party loop (N1/N2/N3/N4).
string,null
Party,null
An N1 party loop (N1/N2/N3/N4).
string,null
string,null
string,null
string,null
string,null
Show Option 3: Invoice810Overrides
Show Option 3: Invoice810Overrides
810 overrides. With
lines, the invoice bills exactly those lines (a line without quantity bills its remaining quantity; unit_price defaults to the PO price). The total is always recomputed.array,null
string,null (date)
string,null
InvoiceLineOverride[]
integer,null (int32)
Minimum:
0.string,null
integer,null (int32)
Minimum:
0.string
required
boolean
required
No error findings; not transport or partner acceptance.
object[]
required
Status codes
| Code | Meaning |
|---|---|
200 | Prepared document, date-pinned overrides, revision and policy verdict. Sends no EDI. |
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/operations/orders/{partner_id}/{po_number}/preview/{set}' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header 'Content-Type: application/json' \
--data '{}'
{
"success": true,
"data": {
"document": {},
"overrides": {
"ack_date": "2026-08-31",
"ack_type": "string",
"lines": [
{
"line_number": "string",
"quantity": "2",
"status": "pending"
}
]
},
"order_revision": "string",
"passed": true,
"issues": [
{}
]
}
}
Last modified on October 20, 2026