Without items: every line's remaining quantity (refund: every invoiced and not yet refunded quantity), with what remains of the order's charges. With items: those lines, never beyond what remains (409). Charges sent win; includeOrderCharges fills the others from what remains of the order. Refused for a canceled order, a DSCO channel, and (until P4b) an order with payments waiting for an invoice.

Scope: invoices:write, channel:write or admin. A permission group made before the Channel API scopes existed grants it as invoices:manage.

Idempotency: send Idempotency-Key; a retry with the same key replays the first answer.

Rate limit: write class, 1,200 requests per minute per tenant by default (read class 6,000). Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset; a refusal is 429 rate_limited with Retry-After.