Get Inventory Reconciliation Period Entries
GET/api/ledger/reconciliation/inventory/period-entries
The individual ledger entries behind ONE transaction-type concept of a period's ongoing reconciliation, with both sides of the comparison on every row.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Each entry carries what SKU booked on this account (net_amount) alongside what the accounting provider actually recorded for that same entry (provider_amount, matched through the sync link) and the difference between them (check_b). That is what makes a residual traceable to specific postings instead of stopping at the transaction type.
provider_amount is null when no provider document is linked to the entry — meaning nothing reached the provider, so the whole net_amount is outstanding. This is NOT the same as the provider recording 0.00, which comes back as 0. check_b follows the same rule and is null exactly when provider_amount is. Treat the two cases differently when rendering.
provider_journal_date is when the provider posted it, which for a batched type routinely trails the entry's own date by a month — batches close in one period and sync in the next. That lag is expected and is not a gap.
can_sync is whether the entry can be pushed to the provider right now — the same eligibility the bulk sync action enforces — so an already-synced entry is false, and an entry whose sync_status is awaiting can still be false when it belongs to a batch that has not closed yet (it syncs with the batch, not on its own). An entry with net_amount 0 is still a real posting (its debit and credit legs cancel on this one account) and can be pushed like any other.
Paginated, and sorted, filtered and searched across the WHOLE set before the page is cut. The meta block re-states the concept's own summary figures (so this can never contradict the period summary) and reports set-wide counts a single page cannot express — including syncable_count, which respects the active status filter.
Authenticate with a Personal Access Token. Reads cached data only (no live provider call).
Each posting also carries the inventory side of the accounting period it covers: sku_moved is what SKU's stock did over that period and check_a is net_amount minus it. Both are null — never 0 — when the period holds more than one posting of the scope requested, because nothing in an inventory movement says which of them it belongs to; narrowing with type is usually what makes them answerable. meta.check_a_per_posting says whether any posting in the set carries them, and meta.sku_unattributed_to_period is how much of the period-scoped inventory movement lands in no period at all (stock in transit is valued as a running balance, and an accounting lock can shift a posting out of the period its stock moved in).
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.