Create Invoice

Creates an invoice for one or more order items. The same eligibility checks as the admin Invoice screen apply (the order must not be closed, marked fraud, or paid through PayPal Standard). Each item's requested quantity is validated against its still-invoiceable quantity, qty_to_invoice (rejected per-SKU with a message carrying the requested vs available quantity) before the invoice is created.

Endpoint

Endpoint	Method
/api/admin/orders/{orderId}/invoices	POST

Request body

Field	Type	Required	Notes
items	array of { orderItemId, quantity }	yes	At least one entry with quantity > 0. Each quantity must be ≤ that item's qty_to_invoice.
can_create_transaction	boolean	no	Default false. The admin Create Transaction checkbox — when true, also records an order transaction for the invoice amount against the order's payment method.

Errors

HTTP	Message
422	Closed orders cannot be invoiced.
422	Fraud orders cannot be invoiced.
422	Invoices cannot be created for orders paid through PayPal Standard.
422	There is nothing to invoice on this order.
422	You do not have permission to create invoices.
422	At least one item with a positive quantity is required.
422	Requested quantity exceeds the available quantity for the given SKU (the message names the SKU and both quantities).
422	Could not create the invoice.

Sample 422 response

{
    "type": "/errors/422",
    "title": "Bad Request",
    "status": 422,
    "detail": "Requested quantity (5) exceeds available quantity (3) for SKU WS-12-S."
}