Unlink Inbound Shipment from Invoice
DELETE/api/purchase-invoices/:purchaseInvoice/inbound-shipments/:inboundShipment
Remove the link between this purchase invoice and an inbound shipment, reversing Link Inbound Shipment to Invoice.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
The shipment, its lines, and its receipts are not modified — only the association is removed. Line-level pairings to this invoice's lines are cleared, and a derived due date falls back to the purchase order's own dates. A manually set due date is left untouched, and the shipment's links to any other invoices are not affected.
The invoice remembers the shipment it was unlinked from: the shipment matcher (automatic matching and Auto-Link Inbound Shipments) will never re-link it on its own, and it is reported as partial with the reason "Unlinked from this bill earlier". Link it again by hand to undo.
Returns 422 when the shipment is not linked to this invoice.
Authentication: Requires Bearer token.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
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
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.