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

# Preview an order response

> Prepare an 855, 856 or 810 without dispatch. Inspect the prepared payload, findings and revision…

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

**partner\_id** `string` *required*

Partner

**po\_number** `string` *required*

Purchase order

**set** `string` *required*

855, 856 or 810

### Request body

`Ack855Overrides | Asn856Overrides | Invoice810Overrides`

**ack\_date** `string,null (date)`

**ack\_type** `string,null`

**lines** `AckLineOverride[]`

**AckLineOverride**

**line\_number** `string` *required*

The PO line (PO101) being acknowledged.

**quantity** `string,null`

ACK02 — the quantity committed.

**status** `string,null`

ACK01: IA accepted, IB backordered, IQ quantity changed, IR rejected.

### Response

`object`

**success** `boolean` *required*

**data** `object` *required*

**data**

**document** `object` *required*

Prepared 855, 856 or 810; retain exact business content.

**overrides** `Ack855Overrides | Asn856Overrides | Invoice810Overrides` *required*

Select the override schema matching the set path parameter; do not combine transaction types.

**overrides**

**Option 1: Ack855Overrides**

855 overrides. Listed lines change status and/or committed quantity; unlisted lines stay accepted. A quantity without a status becomes `IQ` (quantity changed) — or `IR` when zero.

**ack\_date** `string,null (date)`

**ack\_type** `string,null`

**lines** `AckLineOverride[]`

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

**bol\_number** `string,null`

**carrier\_scac** `string,null`

**cartons** `CartonOverride[]`

**lines** `LineQuantity[]`

**packages** `integer,null (int32)`

Minimum: `0`.

**ship\_date** `string,null (date)`

**ship\_from** `Party,null`

An N1 party loop (N1/N2/N3/N4).

**ship\_time** `string,null`

**ship\_to** `Party,null`

An N1 party loop (N1/N2/N3/N4).

**shipment\_id** `string,null`

**tracking\_number** `string,null`

**transport\_method** `string,null`

**weight** `string,null`

**weight\_uom** `string,null`

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

**allowances** `array,null`

**invoice\_date** `string,null (date)`

**invoice\_number** `string,null`

**lines** `InvoiceLineOverride[]`

**terms\_discount\_days** `integer,null (int32)`

Minimum: `0`.

**terms\_discount\_percent** `string,null`

**terms\_net\_days** `integer,null (int32)`

Minimum: `0`.

**order\_revision** `string` *required*

**passed** `boolean` *required*

No error findings; not transport or partner acceptance.

**issues** `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](/spec/edi.json) for declared schemas and alternatives.
This page also includes documented corrections from the [spec overlays](https://github.com/stateset/docs/tree/main/spec/overlays).
Example IDs and values are illustrative; replace them with records from your workspace.

```bash cURL theme={null}
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 '{}'
```

```json 200 theme={null}
{
  "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": [
      {}
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.