Skip to main content

Upload Provider Bill Invoice

POST 

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

Attach the real invoice file to one provider bill. With invoice reading on, the file is queued to be read and compared with the provider bill (see Get Provider Bill); with it off the file is only attached. Nothing is written to Xero or QuickBooks.

Required scope: purchase-orders:write

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

Form fields (multipart):

  • file (required) - a PDF, PNG, JPG, JPEG, TIF or TIFF, max 25 MB.
  • connection_id (optional, integer).

Review fields: id, connection_id, remote_type, remote_id, status (pending, classified, committed, ignored, failed), classification (bill, purchase_invoice, ignored, or null), billable_type / billable_id (the SKU.io document once brought in), supplier_id, purchase_order_id, ignore_reason, provider_status, amount_due, total, currency_code, document_state (from_provider, uploaded, none), change_state (none, changed, voided - whether the provider bill changed after it was brought in), placeholder_number (true when the provider bill had no number and SKU.io gave it one), invoice_details (what was read from an uploaded invoice), error (why bringing it in failed), decided_at, refreshed_at.

A file already uploaded before is refused with 422. 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