FBR Sandbox vs Production: Testing Your Digital Invoicing Setup

Before your business starts reporting real invoices to FBR, there is a safety net you should use: the sandbox. FBR Digital Invoicing offers two environments — a sandbox for testing and a production environment for live, filed invoices. Understanding the difference is the key to a calm, error-free go-live rather than a stressful one.

This guide explains what each environment is for, what you should test before switching, and how to move across safely. It pairs well with our step-by-step integration guide.

What is the sandbox environment?

The sandbox is a practice version of FBR's Digital Invoicing platform. It behaves like the real thing — accepting invoices, validating them, and returning an IRN and QR — but nothing you submit there becomes a real, filed invoice. It exists so you can experiment freely without any consequence to your records or returns.

What is the production environment?

The production environment is the live system. Every invoice you report here is a genuine submission that feeds into your sales record and your monthly sales tax return. Once you are in production, accuracy matters, because real invoices are being created against your business's identity.

Sandbox vs production at a glance

Why testing in the sandbox matters

Skipping the sandbox is a false economy. Testing first lets you catch problems while they are harmless. In the sandbox you should confirm that:

• Your invoices are accepted and the IRN is returned correctly;
• The QR code renders properly on your printed and PDF invoice templates;
• Standard, zero-rated and export invoices all report as expected;
• Both single and bulk reporting behave correctly if you issue high volumes;
• Errors are handled gracefully — try sending bad data on purpose to see what happens.

What to test before you go live

A useful pre-launch checklist:

1. Report a normal local sale at the standard 18% GST rate.
2. Report a zero-rated or export invoice and confirm the 0% rate is accepted.
3. Report a sale to an unregistered buyer where further tax may apply.
4. Deliberately submit an invoice with a wrong registration number to see the error.
5. Check that your books show the IRN stored against each test invoice.

Moving from sandbox to production

When your sandbox tests are consistently clean, you switch your credentials over to the production environment. The change is usually a matter of configuration — pointing the system at the live platform with your live token rather than the test one. From that moment, invoices are real. A few sensible habits during the switch:

• Go live at a quiet time if you can, not during your busiest hour;
• Watch the first batch of real invoices closely to confirm each gets an IRN;
• Keep someone on hand to fix any early rejections quickly.

Golden rule: never use production as your testing ground. Every experiment belongs in the sandbox, where it costs you nothing.

Keep using the sandbox after go-live

A common mistake is to treat the sandbox as a one-time hurdle you clear before launch and then forget. In reality it stays useful for the life of your business. Any time you change something that touches invoicing, the sandbox is where you prove the change is safe before it reaches real customers. Good moments to return to it include:

• When you start selling a new type of product with different tax treatment;
• When you update your invoice template or receipt layout;
• When you begin issuing export or zero-rated invoices for the first time;
• When you switch on bulk reporting to handle higher volumes;
• When something behaves oddly in production and you want to reproduce it safely.

Because nothing in the sandbox is ever filed, you can be as thorough — even as reckless — as you like, and learn exactly how your setup behaves without any risk to your records or your return.

Frequently asked questions

Do sandbox invoices count towards my return?

No. Sandbox invoices are never filed and never affect your sales tax return. That is the whole point of a test environment.

Can I keep using the sandbox after going live?

Yes. The sandbox stays useful whenever you change your setup, add new invoice types, or want to test something without risk. See our FAQ for related questions.

What if something breaks after go-live?

Fix the data and re-report the affected invoice. If a wider issue appears, you can reproduce and diagnose it in the sandbox before applying the fix to production.

Iris Accounts lets you test against FBR's sandbox and then switch to live production reporting from the same system, so your go-live is a configuration change rather than a leap of faith.