Skip to main content

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.

Required scope: purchase-orders:write

Grant 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) or ignored.
  • 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 when classification is purchase_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) - with ignored, 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​

OK

Response Headers
    Content-Type