Send a purchase-order change acknowledgment (865)

Build and dispatch an X12 865 change acknowledgment. Save a partner-approved payload with at least one line as po-change-ack.json…

POST /v1/edi/outbound/865/{partner_id}

cURL

curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.edi.stateset.com/v1/edi/outbound/865/{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 @po-change-ack.json

200

"string"

Build and dispatch an X12 865 change acknowledgment. Save a partner-approved payload with at least one line as po-change-ack.json. The successful response is wire-ready X12, not JSON; inspect delivery and partner acknowledgments separately.

Path parameters

partner_id · string · required

Partner ID

Headers

Idempotency-Key · 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

Ack865

ack_date · string (date) · required

ack_type · string

BCA02 acknowledgment type: AC accept, AD accept with detail, AK acknowledge no detail, RJ reject.

lines · ChangeAckLine[] · required

Show ChangeAckLine

change_type · string

POC02 change/response type: CA changes, QD quantity decrease, QI quantity increase, DI delete item, AI add item, NC no change.

ids · ProductId[]

Show ProductId

qualifier · string · required

value · string · required

line_number · string · required

quantity · string · required

POC03 — quantity ordered after the change.

status · string

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

status_quantity · string,null

ACK02 — quantity the status applies to; defaults to the line quantity.

unit_price · string,null

uom · string

po_date · string,null (date)

BCA06 — original PO date.

po_number · string · required

BCA03 — the changed PO being acknowledged.

Response

Returns application/edi-x12 — Wire-ready X12 865 interchange.

Status codes

Code	Meaning
200	Wire-ready X12 865 interchange
403	Not this credential’s partner
409	Idempotency-Key reused with a different payload
422	Invalid payload or delimiter collision

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

curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.edi.stateset.com/v1/edi/outbound/865/{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 @po-change-ack.json

200

"string"