Bulk Classify Provider Bills
PATCH/api/accounting/provider-bills/review/bulk
Save the same decision for several provider bills at once, for example every bill from one contact. Nothing is created yet; classified bills are brought in by Bring Provider Bills into SKU.io. Nothing is written to Xero or QuickBooks.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Bills already brought in are skipped. The whole batch is saved or none of it is. Returns saved, the number of bills whose decision was saved.
Request fields:
remote_ids(required, array of 1-1000 strings, each max 191) - the provider bill IDs.classification(required) -bill(expense bill),purchase_invoice(an invoice on a purchase order) orignored.supplier_id(optional, integer) - the SKU.io supplier. Saved as the contact's mapping for next time. When omitted, the contact's saved mapping or a supplier with the same name is used.create_supplier(optional, boolean) - create a service supplier named after the provider contact instead of choosing one.purchase_order_id(required whenclassificationispurchase_invoice, integer) - the purchase order this bill invoices. It must belong to the same supplier.ignore_reason(optional, max 255) - why the bill is ignored.always_ignore(optional, boolean) - withignored, also ignore every future bill from this contact.connection_id(optional, integer).
Expense bills need a service supplier; a goods supplier's bill must be a purchase invoice or ignored.
Returns 422 when a field is invalid or the decision cannot apply to one of the bills. 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).
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.