Skip to main content

Link Bill to Provider Bill

POST 

/api/bills/:bill/link-provider-document

Link a bill to the bill already in the connected accounting system that it duplicates. The provider's bill becomes this bill's record there, any pending send of the bill is closed, and nothing is sent to the provider, now or later, unless the bill is edited in SKU.io afterwards. A paid provider bill is linked read-only.

Required scope: purchase-orders:write

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

Body:

  • match_id (required, string, max 255) - a provider match id from Check Bill for Duplicates, in the form {connection_id}:{remote_type}:{remote_id}.

Returns 422 when:

  • match_id is not a provider bill, or that provider bill is voided, deleted or already linked to another document (on match_id).
  • the bill is already booked in or linked to the accounting system, has not reached the ledger yet (a line has no account), or is being sent right now (on bill).

Authentication: Requires Bearer token. Permission: edit bills (bills.update). Scope: purchase-orders (read/write).

Request​

Responses​

OK

Response Headers
    Content-Type