Post Inventory Reconciliation Adjustment
POST/api/ledger/reconciliation/inventory/adjustment
Post the adjusting journal to bring the provider's inventory control account into line with SKU. The amount and direction are recomputed server-side from the divergence (the client can't post an arbitrary figure); the balanced journal is posted to the provider as a manual journal. An already-aligned or locked-period account is rejected 422.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Authentication: Requires Bearer token.
Body: connection_id (required), nominal_code_id (required), counter_nominal_code_id (required), effective_date (required, date), note (optional, max 500 chars).
Response: { data: { adjustment_id }, message }.
Pass net_pending=true for the ongoing true-up (targets the residual = divergence + pending). The amount and direction are always recomputed server-side.
Request
Responses
- 200
- 401
- 403
- 422
- 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.
Unprocessable Entity
Response Headers
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.