Guide

FBR digital invoice guide: setup from start to finish

What actually happens between deciding to go digital and your first invoice reaching FBR successfully. A practical walkthrough, not just theory.

By FBR Invoice Atsolhive Team · Updated July 15, 2026 · 5 min read

Before you start

Before touching any software, confirm two things: your business's current sales tax registration status (your NTN and STRN, sales tax registration number), and whether your specific sector and turnover currently fall under FBR's mandatory e-invoicing requirement. This determines urgency, not whether it's worth doing — most businesses benefit from digital invoicing regardless of mandate status.

Step 1: Verify your FBR registration details

Your business's NTN, STRN, registered address, and business category all need to match what's on file with FBR exactly. A mismatch here is one of the most common reasons a business's first few invoice submissions get rejected — not because of anything wrong with the invoice itself, but because the account-level details don't line up.

Step 2: Map your products to HS codes

Every item you sell needs a Harmonized System (HS) code, which determines its applicable sales tax rate. For a business with a large catalogue — a textile mill with dozens of fabric types, for instance — this mapping is the most time-consuming part of setup, but it only has to be done once per product.

Example: A pharmacy with 2,000 SKUs doesn't map all 2,000 individually by hand — a proper onboarding process groups products by category and applies the correct HS code and tax treatment per group, which turns a weeks-long task into a few days.

Step 3: Connect to FBR's API

This is the technical integration step — your invoicing software authenticates with FBR's system using your business's credentials, so that from this point on, invoices can be submitted programmatically rather than through FBR's manual web portal. With a properly built invoicing platform, this connection is set up during onboarding and doesn't require your own developer.

Step 4: Test before going live

FBR's e-invoicing system typically supports testing in a sandbox environment before submissions count as real, live filings. Running a handful of test invoices through this stage — checking that HS codes, tax rates, and buyer details all validate correctly — catches configuration mistakes before they become a compliance problem on a real transaction.

Step 5: Go live and monitor

Once testing passes, invoices start submitting for real. The first few weeks are worth watching closely — checking submission status daily rather than assuming everything is working silently in the background — until the pattern of validated, submitted, and (rarely) rejected invoices becomes predictable.

Terms you'll run into

A few terms come up repeatedly during setup: NTN (National Tax Number, your business's core tax identifier), STRN (Sales Tax Registration Number), HS code (Harmonized System code, determines tax treatment per product), sandbox (a test environment separate from live filings), and invoice reference number (the identifier FBR returns once an invoice is validated).

FAQs

Frequently asked questions

For most businesses, 2–5 working days from account verification through go-live, though catalogue size and HS code complexity can extend that for larger manufacturers.
No, if you're using a platform like FBR Invoice Atsolhive — the onboarding team handles the API connection and configuration.
Sandbox submissions are test runs that validate against FBR's rules without counting as an official filing; production submissions are real, live invoices that count toward your compliance record.
You'll need to correct the mismatch with FBR directly (or through your tax consultant) before submissions will validate correctly — this is usually the first thing to check if early submissions are getting rejected.
Yes, many multi-branch businesses roll out one location first, confirm it's working smoothly, then extend to the rest.
They remain as historical records in whatever system you used before; some platforms let you import that history for reference, though it won't retroactively submit to FBR.
FBR doesn't charge a separate fee for e-invoicing API access itself; your cost is the invoicing software subscription that handles the integration on your behalf.

Ready to stop doing this by hand?

Get started and see FBR Invoice Atsolhive handle it for your business.