Skip to main content

Get AWD Receipt Assessment

GET 
/api/purchase-orders/:purchase_order/awd-receipt-assessment

Compare an AWD purchase order's unreceived quantity with Amazon's own AWD shipment record.

Required scope: purchase-orders:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

An AWD purchase order is received only from RECEIVED rows on the AWD Inventory Ledger you upload. Amazon's AWD shipment record (synced automatically) carries its own count of cases received. This endpoint sets the two against each other, per merchant SKU, and returns a verdict:

  • matched — nothing to reconcile.
  • shipment_open — Amazon has not closed the shipment; receipts may still arrive.
  • settling — Amazon closed the shipment, but no uploaded ledger reaches 7 days past the close yet (Amazon posts ledger rows late). settles_after is the date the uploaded ledger must reach.
  • amazon_confirms_received — Amazon received every case, but its ledger export never posted some of them. can_confirm_received is true: close the order with Confirm AWD Receipt.
  • amazon_confirms_short — Amazon received fewer cases than expected and the missing cases match the ledger shortfall exactly: a real loss. can_record_shortage is true: record an inbound shortage on the order's pending inbound.
  • needs_review — the two records disagree in a way neither close can explain (over-received SKUs, a shortfall that is not whole cases, a SKU on no order line, or part loss / part missing rows). reason says which.

lines lists only SKUs where the records disagree. Use verdict rather than the order's receipt status to tell a ledger gap from a genuine shortage.

Returns 422 for an order that is not bound for AWD or has no linked AWD shipment.

Authentication: Requires Bearer token.

Request​

Responses​

OK

Response Headers
    Content-Type