curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/810/{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 '{
"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": [
{
"qualifier": "string",
"value": "49.00"
}
],
"line_number": "string",
"quantity": "2",
"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",
"transaction_type": "string"
}'
810
Wire-ready X12 810 interchange
POST
/
v1
/
edi
/
outbound
/
810
/
{partner_id}
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/edi/outbound/810/{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 '{
"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": [
{
"qualifier": "string",
"value": "49.00"
}
],
"line_number": "string",
"quantity": "2",
"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",
"transaction_type": "string"
}'
Path parameters
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; changed JSON payload returns 409.
Request body
Invoice810
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.
Show Allowance
Show Allowance
string
required
SAC05 — amount in the invoice currency (serialized N2, two implied decimals).
string
required
SAC02 — service/promotion/allowance/charge code, e.g.
D240 freight, A170 discount, G830 handling.string,null
SAC15 — free-text description.
string
required
SAC01 —
A allowance (reduces the invoice), C charge (adds to it).string (date)
required
BIG01.
string
required
BIG02.
InvoiceLine[]
required
string
required
BIG04 — the PO being invoiced.
integer,null (int32)
Minimum:
0.string,null
integer,null (int32)
ITD payment terms, e.g. net days. Minimum:
0.string
required
Total invoice amount in the partner’s currency. Serialized into TDS with implied two decimals, per spec.
string,null
BIG07 transaction type code:
CR sends a credit memo, DR a debit memo; absent is an ordinary invoice.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 |
409 | Idempotency-Key reused with a different payload |
422 | Invalid payload or delimiter collision, or blocked by the partner’s outbound compliance policy (issues in error.issues). Sent documents carry X-EDI-Compliance-Warnings with the pre-send issue count |
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/edi/outbound/810/{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 '{
"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": [
{
"qualifier": "string",
"value": "49.00"
}
],
"line_number": "string",
"quantity": "2",
"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",
"transaction_type": "string"
}'
Last modified on October 20, 2026