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.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Body:
match_id(required, string, max 255) - a provider matchidfrom Check Bill for Duplicates, in the form{connection_id}:{remote_type}:{remote_id}.
Returns 422 when:
match_idis not a provider bill, or that provider bill is voided, deleted or already linked to another document (onmatch_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
- 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 — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
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.