Get Inventory Reconciliation Chain
GET/api/ledger/reconciliation/inventory/chain
The cumulative reconciliation CHAIN for one earmarked inventory control account, since the baseline: SKU inventory moved (physical) -> SKU ledger moved (SKU's own accounting books) -> provider (Xero) moved (actual GL). Two checkpoints fall out of it: check_a = ledger - inventory (does SKU's ledger reflect its inventory? an internal booking discrepancy) and check_b = provider - ledger (did the ledger reach the provider? sync status plus any direct-in-Xero or synced-then-deleted residual). divergence = provider - inventory = check_a + check_b. The ledger split (synced/awaiting/excluded) shows how much of Check B is just pending sync. rows give the per-transaction-type detail behind each. Done cumulatively so the monthly batch-sync lag washes out. Authenticate with a Personal Access Token. Reads cached data only. Every measure above is a MOVEMENT since the baseline; the balance fields are the absolute closing positions those movements land on — what inventory is actually worth in SKU (sku_balance) against what the provider's account says (provider_balance), and the resulting balance_difference = provider_balance - sku_balance. The opening trio (opening_sku_balance, opening_provider_balance, opening_difference) states the same three at the baseline. Because divergence only measures how much the gap GREW since the baseline, the total gap on the books is balance_difference = opening_difference + divergence — the two coincide only when the baseline opened reconciled.
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.