Mark a purchase order as received
POST/purchase-orders/:code/receive
Transitions a purchase order from ORDERED to RECEIVED status with delivery details. A purchase order already COMPLETED and carrying no delivery confirmation accepts one after the fact and keeps its status: it was closed by full invoicing before anyone confirmed the delivery. Only a flawless condition is accepted there, because a completed order has no transition to DISPUTED left. When the optional "lines" array is present, the server derives "condition", "ordered_amount" and "received_amount" from it and ignores any values sent for those three fields. Each line_item_id must belong to the purchase order's purchase request, and each quantity must not exceed that line's ordered quantity.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
Successfully marked purchase order as received
Bad request - code missing, invalid status, or validation error
Unauthorized
Forbidden - request denied by authorization, or blocked by the API firewall
Purchase order not found
Too many requests - rate limited by the API firewall; wait out the Retry-After delay before retrying
Response Headers
Delay in seconds a client must wait before retrying the request
Internal server error