Get AWD Re-anchor Preview
GET/api/amazon/unified/awd/re-anchor/preview
Propose restating AWD stock so each product matches the quantity Amazon last reported holding.
Read-only — nothing is written by this request.
An incorrect opening balance cannot be repaired by importing the ledger again, because every later balance is built on it. The correction restates each product at the counted quantity and lets the ledger run forward from there.
canRun must be true before applying. When it is false, blockedReason is one of:
no_snapshot— Amazon's position has never been captured.ledger_behind_snapshot— the ledger does not yet reach the counted moment. Amazon publishes AWD ledger entries one to two days after the movement, so correcting now would absorb movements that have already happened, and those would be deducted a second time when their entries arrive. Import a ledger export covering the counted date and retry.
available is false with reason no_awd_warehouse when the account has none, or multiple_awd_warehouses when several are in scope — pass warehouse_id to choose one.
shipmentsInGapWindow counts AWD-to-FBA shipments for this integration that left between the last ledger entry and the count. Zero means nothing moved unrecorded.
overConsumedLayers lists stock records consumed beyond their own quantity. Applying repairs those belonging to the products being corrected, and each product's baseline already includes that repair, so the figures returned here are the figures that land.
Each row shows the position at the counted moment (skuioAsOfSnapshot), the counted quantity (amazonAtSnapshot) and the resulting adjustment. isWholeCarton indicates the difference is an exact number of cases, which is typical of a counting difference.
reference identifies the counted instant and is unique to it. proposalHash fingerprints every included row — both must be sent back when applying, so a proposal that changed while it was being reviewed is refused rather than silently applied with different numbers.
Authentication: requires a Bearer token.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Request
Responses
- 200
- 401
- 403
- 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.
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.