FBR Invoice Number Explained for Shopify Merchants

Shopify assigns an order ID and displays a configurable order name. Your accounting process may assign its own invoice number. After a valid digital-invoice submission, FBR returns an FBR invoice number. None should be silently overwritten by another.

FBR technical documentation describes returning a unique invoice number for valid submissions and printing the FBR invoice number with the QR code. S.R.O. 69(I)/2025 also connects the unique FBR invoice number to QR generation in the electronic-invoicing rules.

Keep the FBR number, Shopify immutable order ID, display name, merchant invoice reference, submission time and raw response. Make all safe identifiers searchable. This lets accounts answer an FBR query and customer support start from the Shopify order.

The merchant can create its own reference before submission, but it should not invent an FBR invoice number. Only store the returned value after a valid response. A timeout should remain “unknown” until checked, not receive a placeholder that looks official.

Before submission, check whether the order is already linked to a valid FBR number. After an ambiguous response, query the available invoice-detail or status process before retrying. Preserve failed attempts and never recycle an FBR number onto another order.

On the order screen, show the merchant reference, FBR status, FBR number, submission time and last error without exposing the token or unnecessary buyer data. Make the valid number copyable, but do not let an operator edit it. Corrections should create an auditable action rather than changing the stored response.

On the customer invoice, label the Shopify reference and FBR invoice number clearly so support can ask which one the customer is reading. A long FBR number may wrap on small receipt printers, so test templates using realistic values rather than a short placeholder.

Export a daily list of eligible Shopify orders and compare it to valid FBR numbers. Look for one order with multiple valid numbers, one number attached to multiple orders, accepted invoices with no rendered document and orders left in an unknown state. Counts alone are insufficient; include gross and tax values.

If a number appears incorrect, do not overwrite it. Preserve the returned response and investigate whether the wrong order was submitted, the display is mapped incorrectly, or a correction process is required under current FBR rules and adviser guidance.