How to Integrate Your Business with FBR Digital Invoicing (Step by Step)

Connecting your business to FBR Digital Invoicing can feel daunting from the outside, but it follows a logical sequence. Once you know the steps, the process becomes a checklist rather than a mystery. This guide walks through each stage — from getting registered to going live with real invoices carrying an IRN and QR code.

If you have not yet read our overview of what FBR Digital Invoicing is, that is worth a look first. Here, we focus purely on the practical path to getting connected.

Step 1: Make sure you are sales tax registered

Digital invoicing reports sales tax invoices on goods, so you need a sales tax registration and an STRN (Sales Tax Registration Number) with FBR. If you are not yet registered, that is the first thing to sort out. Our guide to sales tax registration and the STRN covers how this works.

Step 2: Confirm whether the system applies to you

FBR has rolled digital invoicing out in phases, starting with larger and specified categories of registered persons and widening over time. Before investing effort, confirm your current obligation with FBR or your tax adviser. Our post on who must register explains the scope in more detail.

Step 3: Choose how you will connect

You have two broad routes to the FBR platform:

• Compliant accounting software that already speaks to FBR — the simplest route for most businesses, because the connection is built in.
• A custom integration built against FBR's API, which suits businesses with in-house systems or unusual needs. See our API integration guide for what that involves.

Most small and medium businesses are far better served by ready-made software than by building their own bridge.

Step 4: Obtain your FBR credentials and token

To report invoices to the live environment, you need the right credentials from FBR — typically a token or set of details tied to your registration. Your software uses these to authenticate each submission. Keep them secure; they are effectively the keys to reporting under your business's identity.

Step 5: Test in the sandbox first

FBR provides a sandbox environment that mirrors the live system but does not create real, filed invoices. This is where you prove your setup works before anything counts. In the sandbox you can:

1. Send test invoices and confirm they are accepted;
2. Check that the IRN comes back and the QR renders correctly on your invoice template;
3. Deliberately send bad data to see how errors are handled;
4. Test both single and bulk reporting if you issue high volumes.

Do not skip this stage. Our comparison of sandbox versus production explains why testing here saves you from live headaches.

Step 6: Get your master data right

Many integration problems are really data problems. Before going live, make sure your records are clean:

• Correct buyer registration details for business-to-business sales;
• Accurate tax rates on every item — standard 18% GST, zero-rated, or exempt as appropriate;
• Consistent item descriptions and units;
• Your own registration details entered correctly.

Step 7: Switch to production and go live

Once the sandbox looks clean, you move your credentials over to the live (production) environment. From that point, invoices you report are real submissions that feed into your sales record and monthly return. Start carefully — watch the first day's invoices closely to confirm each one comes back with an IRN.

Tip: keep a note of who at FBR or which adviser you can contact if something breaks on day one. A little support planning goes a long way during go-live.

Step 8: Build reporting into daily habits

After go-live, integration is not "done" — it is ongoing. Make sure someone checks that invoices are reporting successfully, that rejected invoices are corrected promptly, and that your books and returns stay in sync with what FBR has on record.

Frequently asked questions

How long does integration take?

It depends on your route. With ready-made compliant software the connection can be quick once your credentials are in place; a custom build against the API takes longer. Sandbox testing time varies with how clean your data is.

Do I need a technical team?

Not if you use compliant software — the technical work is already done. A custom API integration does need developers. For most businesses, software is the practical choice. See our FAQ for more.

Can I test without affecting my real records?

Yes — that is exactly what the sandbox is for. Nothing you submit there becomes a real filed invoice.

Iris Accounts comes connected to FBR Digital Invoicing out of the box, so the credentials, sandbox testing and IRN and QR handling are built into the software rather than being a project you have to manage yourself.