Sales & CRMMu Mutation

invoiceOrder

Topics: Commerce

Generate an invoice from an order and its lines. Rejects orders that already have an invoice, including concurrent retries. Requires invoice:write.

Returns

InvoiceOrderPayload!

Arguments

Order to invoice, its invoice number, and optional dates, terms and notes.

Examples

Invoice Commerce Order

mutation InvoiceCommerceOrder($input: InvoiceOrderInput!) {
  invoiceOrder(input: $input) {
    invoice { id invoiceNumber status totalAmount paidAmount currency }
    invoiceLines { id }
    errors { path message }
  }
}

Variables

{
  "input": {
    "orderId": "ord_01h455vb4pex5vsknk084sn02q",
    "invoiceNumber": "INV-2042",
    "issueDate": "2026-10-21T09:00:00.000Z",
    "dueDate": "2026-11-20T09:00:00.000Z"
  }
}
Exact field SDL
"""
Generate an invoice from an order and its lines. Rejects orders that already have an invoice, including concurrent retries. Requires invoice:write.
"""
invoiceOrder(
  """
  Order to invoice, its invoice number, and optional dates, terms and notes.
  """
  input: InvoiceOrderInput!
): InvoiceOrderPayload! @topic(names: ["commerce"]) @topic_example(names: ["commerce.invoice-order"])

Declared on Mutation. Access is checked by the platform for each operation.