How do I use the sales order number as the QuickBooks invoice number?

Last updated: November 6, 2026

By default, the invoice number (DocNumber) that Luminous creates in QuickBooks Online is your QuickBooks prefix plus the Luminous invoice ID, for example lum_4880. You can change this so the number is built from the sales order number instead. For Shopify orders, that is the Shopify order number.

Turn it on

  1. Go to Settings, open the QuickBooks settings, then open the Invoice Settings tab.

  2. Under QuickBooks Invoice Number, choose Sales order number. The other choice is Luminous invoice ID, which is the default.

  3. Click Save Invoice Settings.

How the numbers are built

  • The number is the prefix plus the order number, for example lum_2621. A leading # on the order number is dropped.

  • This mode always uses the prefix, even if the prefix option is turned off for invoice-ID numbering.

  • If one order has several invoices, the first has no suffix. Later ones get -2, -3 and so on, in the order the invoices were created.

  • Luminous falls back to the prefix plus the invoice ID in these cases:

    • the invoice has no sales order

    • the order number is blank

    • the order number contains a quote or backslash

    • the result would be longer than QuickBooks' 21-character limit. Luminous never truncates an order number.

  • Estimates always use the invoice-ID numbering.

Good to know

  • Only new invoices use the new setting. Invoices already in QuickBooks keep their numbers.

  • If a number is already used by a different Luminous invoice, Luminous will not adopt or overwrite that QuickBooks document. This can happen when two channels share an order number.

  • Create, void and payment sync still find your invoices correctly under the new numbering.