Replace the invoice's allocation set

PUT 
/invoices/:code/allocations

Submit the full intended allocation set: target POs (same supplier), per-PO line assignments, and the buyer-entered shares of shared VAT, charges, and allowances. Validates same-supplier scope, complete line assignment, and per-bucket coverage against the document totals before persisting atomically

Request

Responses

200

OK

400

Bad request - malformed body

401

Unauthorized

403

Forbidden - no access to this invoice or to a target purchase order

404

Invoice not found or not accessible

409

Invoice progressed into accounting, carries a collective allocation, or a target purchase order is canceled (type purchase-order-canceled) or completed (type purchase-order-completed, credit notes exempt)

422

Allocation invariant violated (supplier, lines, or coverage)

429

Too many requests - rate limited by the API firewall; wait out the Retry-After delay before retrying

Response Headers

Retry-After

Delay in seconds a client must wait before retrying the request

500

Internal server error