Accept a purchase order: its sales order is created in the same transaction; a second accept answers the same order

Every line must name a product (422 unresolved_reference otherwise). The order is created through the orders create unit (lines, totals, tagging rules), then the purchase order is marked accepted with its sales order, and the 855 acknowledgment follows through the po-accepted message. The order ships from the warehouse the purchase order names (the sales channel default when it names none). Send upload940AdapterId to have the order sent to that warehouse 3PL as an EDI 940: it must be the 3PL adapter of the ship-from warehouse (422 unresolved_reference otherwise). outcome updated the first time, unchanged after.

Scope: purchase-orders:write, channel:write or admin.

Idempotency: send Idempotency-Key; a retry with the same key replays the first answer.

Rate limit: write class, 1,200 requests per minute per tenant by default (read class 6,000). Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset; a refusal is 429 rate_limited with Retry-After.

Path Params
string
required
length between 1 and 300

The uuid, the record's 24-hex id, or ext:: (URL-encoded).

Body Params
string
^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|[0-9a-fA-F]{24})$

The 3PL adapter the accepted order is sent to as an EDI 940 warehouse order: a uuid, or its 24-hex id. It must be the 3PL adapter of the warehouse the purchase order ships from (422 unresolved_reference otherwise). Omit for a warehouse you fulfil yourself.

Headers
string
length between 7 and 50

Any string of 7 to 50 characters that identifies this request (an order number, a webhook id). A retry with the same key and the same body answers the first result with Idempotent-Replayed: true; the same key with a different body is 422 idempotency_key_reused; a concurrent request with the same key is 409 in_progress with Retry-After. Recommended on every write.

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json