Skip to main content

Get Provider Bill

GET 

/api/accounting/provider-bills/review/:remoteId

Get one provider bill with its lines, its saved decision, its files and a comparison against the uploaded invoice.

Required scope: purchase-orders:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Response fields:

  • bill - the bill row (fields below).
  • lines - the provider's lines: description, account, quantity, amount, tax.
  • documents - files kept with the review: id, file_name, source (provider_bill_invoice uploaded, provider_bill_attachment fetched from the provider), created_at.
  • ocr - the invoice read: status (none, ocr_off, or the read's status) and extraction_id.
  • compare - provider versus invoice rows: field, provider, invoice, result, tone (success or warning). The provider's values always win; empty until an invoice is read.
  • provider_url - link to the bill in the provider.

Bill row fields: remote_id, contact_id, contact_name, number, date, due_date, total, amount_due, currency, status (the provider's status), has_number, has_detail (has line detail), file (provider fetched from the provider, uploaded, in_provider the provider has a file not yet fetched, none, unknown), line_count, lines_summary, supplier (the matched SKU.io supplier: id, name, type), suggestion (classification, purchase_order, reason), possible_match (an existing SKU.io document with the same supplier, total and date), and review (the saved decision, or null).

Returns 422 when the bill is not in SKU.io's copy of the provider's 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