Get Reconciliation
GET/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/tracking/reconciliation
Per-shipment reconciliation grid for a draft inbound plan: shipped vs received per item with the discrepancy delta, discrepancy status, and resolution state. Products are resolved through the plan's items by MSKU — product is null when the MSKU is not (or no longer) on the plan.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Shipment fields: id, name, shipment_confirmation_id, amazon_status, claim_deadline (date|null, shipped_at + 60 days), claim_days_remaining (integer|null, negative once lapsed), items[].
Item fields:
id(integer) — shipment item id (use for the resolve/unresolve endpoints)msku/fnsku(string)quantity_shipped/quantity_received(integer)discrepancy(integer) —quantity_received - quantity_shipped(negative = short, positive = over)discrepancy_status(string|null) —PENDING,MATCH,SHORT,OVER, or null when the shipment is not yet RECEIVING/CLOSEDdiscrepancy_resolved_at(datetime|null) /resolution_note(string|null) — the acknowledge-resolution overlay (does not changediscrepancy_status)product(object|null) —id,sku,name,image_url
Discrepancy mapping (per item, recomputed on every sync):
amazon_statusNOT in (RECEIVING,CLOSED) →null(too early to judge)- received == shipped →
MATCH - received > shipped →
OVER - received < shipped and
amazon_status=CLOSED→SHORT(final shortage) - received < shipped and
amazon_status=RECEIVING→PENDING(still being received)
Authentication: Bearer token (PAT).
Request
Responses
- 200
- 401
- 403
- 404
- 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.
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.