Get Inbound Order Reconciliation
GET/api/tiktok-shop/:integrationInstance/fbt/inbound-orders/:order/reconciliation
Sent-versus-received reconciliation for one inbound order: a row per plan line with the sent, received and variance quantities, the unit and total cost, and any discrepancies raised on that line.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
A line only reads short once the inbound order is fully received — before that a low received count means "not received yet", so the line reads pending.
allowed_resolutions lists the resolutions this inbound order's source actually supports: a warehouse-sourced shipment can be returned to source, a supplier-sourced one can raise a supplier credit instead.
pending_inbound is null until the shipment has departed and a pending inbound record exists for it.
Permission: none beyond a valid token.
Response additions: each rows[].discrepancies[] entry now carries allowed_resolutions[] — the resolutions executable for THAT discrepancy, which differs per row (an over receipt cannot be returned to source even on a warehouse-sourced inbound). summary.receipt_evidence_incomplete is true when the channel gave no per-goods received figure for at least one line, meaning those quantities are assumed rather than observed.
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.