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

# 810

> Wire-ready X12 810 interchange

### Path parameters

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

### Request body

`Invoice810`

<ParamField body="allowances" type="Allowance[]">
  Header-level allowances and charges (SAC) — freight, discounts, handling, promotional allowances. Retailers chargeback when these don't reconcile, so they are first-class, not folded silently into the unit price.
</ParamField>

<ParamField body="invoice_date" type="string (date)" required>
  BIG01.
</ParamField>

<ParamField body="invoice_number" type="string" required>
  BIG02.
</ParamField>

<ParamField body="lines" type="InvoiceLine[]" required />

<ParamField body="po_number" type="string" required>
  BIG04 — the PO being invoiced.
</ParamField>

<ParamField body="terms_discount_days" type="integer (int32)" />

<ParamField body="terms_discount_percent" type="string" />

<ParamField body="terms_net_days" type="integer (int32)">
  ITD payment terms, e.g. net days.
</ParamField>

<ParamField body="total_amount" type="string" required>
  Total invoice amount in the partner's currency. Serialized into TDS with implied two decimals, per spec.
</ParamField>

### Response

No response body. Wire-ready X12 810 interchange.

### Status codes

| Code  | Meaning                                |
| ----- | -------------------------------------- |
| `200` | Wire-ready X12 810 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/810/{partner_id}' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
    "allowances": [
      {
        "amount": "49.00",
        "code": "string",
        "description": "Two-person tent, green — replacement for damaged pole set.",
        "indicator": "string"
      }
    ],
    "invoice_date": "2026-08-31",
    "invoice_number": "ORD-10042",
    "lines": [
      {
        "ids": [],
        "line_number": "string",
        "quantity": "string",
        "unit_price": "49.00",
        "uom": "string"
      }
    ],
    "po_number": "ORD-10042",
    "terms_discount_days": 5,
    "terms_discount_percent": "5.00",
    "terms_net_days": 1,
    "total_amount": "102.12"
  }'
  ```
</RequestExample>