Bring Provider Bills into SKU.io
POST/api/accounting/provider-bills/review/commit
Bring every classified provider bill on the connection into SKU.io: expense bills become SKU.io bills and purchase invoices are created on their purchase orders. Each one is marked as already booked in the provider and linked to it, with its payment status and files carried over. Nothing is written to Xero or QuickBooks.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Runs in the background. The response carries tracked_job_log_id; poll GET /api/tracked-job-logs/{trackedJobLog} for progress and the result.
Each bill is brought in on its own, so one failure does not stop the rest; a failed bill gets status: failed and an error on its review row. Bills already brought in are left alone, so the call is safe to repeat.
Optional fields (query or body): connection_id. Returns 404 when the tenant has no Xero or QuickBooks connection.
Authentication: Requires Bearer token. Scope: purchase-orders (read/write). The user must hold the Review provider bills permission (bills.review_provider).
remote_ids (optional): the provider bill ids shown for confirmation. When sent, only those classified bills are brought in; bills classified later, or outside this list, wait for the next run. Omit to bring in every classified bill on the connection.
Request
Responses
- 200
- 401
- 403
- 404
- 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.
Not Found
Response Headers
Unprocessable Content
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.