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
Go to Settings, open the QuickBooks settings, then open the Invoice Settings tab.
Under QuickBooks Invoice Number, choose Sales order number. The other choice is Luminous invoice ID, which is the default.
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,-3and 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.