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 — those orders are hard-blocked from invoicing). Each item's requested quantity is validated against its still-invoiceable quantity, qty_to_invoice, before the invoice is created.

After the mutation, fetch the full invoice via adminInvoice(id:) or the REST GET /api/admin/invoices/{id} endpoint to get the embedded items and totals.

Prerequisites

The example targets an order with invoiceable items. If your order has no items with qty_to_invoice > 0 (already fully invoiced / closed / fraud / paypal_standard payment method) the mutation returns "There is nothing to invoice on this order." — pick an order with outstanding qty to invoice.

Operation

Operation	Type
createAdminInvoice	Mutation

Errors

Condition	Lang key	Message
Order is closed	bagistoapi::app.admin.order.actions.invoice.closed	Closed orders cannot be invoiced.
Order is fraud	bagistoapi::app.admin.order.actions.invoice.fraud	Fraud orders cannot be invoiced.
Order paid with PayPal Standard	bagistoapi::app.admin.order.actions.invoice.paypal-standard-blocked	Invoices cannot be created for orders paid through PayPal Standard.
Nothing to invoice	bagistoapi::app.admin.order.actions.invoice.nothing-to-invoice	There is nothing to invoice on this order.
No permission	bagistoapi::app.admin.order.actions.invoice.no-permission	You do not have permission to create invoices.
Items missing	bagistoapi::app.admin.order.actions.invoice.items-required	At least one item with a positive quantity is required.
Qty exceeds available	bagistoapi::app.admin.order.actions.invoice.qty-exceeds	Requested quantity (:requested) exceeds available quantity (:available) for SKU :sku.
Save failed	bagistoapi::app.admin.order.actions.invoice.failed	Could not create the invoice.