Confirm AWD Receipt
POST/api/purchase-orders/:purchase_order/awd-receipt-assessment/confirm
Close an AWD purchase order as received from Amazon's AWD shipment record.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Only allowed when Get AWD Receipt Assessment returns amazon_confirms_received. Records the cases Amazon received but never posted to its AWD Inventory Ledger as received on the order, so the order closes as Received and the units stop counting as in transit. AWD on-hand stock and its value do not change — AWD stock follows Amazon's ledger.
The receipt appears on the AWD Inventory Ledger as a row with facility SKUIO on the shipment, paired with an equal negative adjustment (reference SKUIO-CONFIRMED-<shipment id>). Once closed, a second call is refused.
No request body.
Permissions: requires the purchase order receive permission.
Authentication: Requires Bearer token.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.