Is FBR digital invoicing mandatory, and who has to comply?
Yes. Under SRO 709(I)/2025 and the Sales Tax Act 1990, sales-tax-registered persons in Pakistan must transmit sales tax invoices to FBR electronically in real time through the FBR Digital Invoicing API. Both corporate and non-corporate registered persons are covered. If you are registered for sales tax, you need an integrated digital invoicing setup rather than manual IRIS entry.
How do I get an FBR sandbox token from the IRIS portal?
Log in to the IRIS portal at iris.fbr.gov.pk with your business NTN or CNIC, open the digital invoicing section, and generate a sandbox token for your registered NTN. The token is a Bearer credential you paste into Settings here, and it is what authorises every API call while you test. Generate the production token the same way once your scenarios pass.
What are IRN, USIN and the invoice QR code?
When FBR accepts a digital invoice it returns an IRN (Invoice Registration Number) and a USIN (Unique Sales Invoice Number), plus a QR code your buyer can scan to verify the invoice. These identifiers are what make the invoice valid for sales tax purposes, and they are printed automatically on the branded PDFs this app generates.
What is a licensed integrator, and do I need one?
FBR requires invoices to reach its core system through a licensed integrator. PRAL (Pakistan Revenue Automation Private Limited) acts as a licensed integrator free of cost, and on the IRIS integration screen you can choose to proceed with PRAL. This app connects to that Digital Invoicing API for you, so you do not have to build the integration yourself.
What is scenario testing and how do I go live?
Before FBR enables production, you work through the sales and debit/credit note scenarios that apply to your business in the sandbox environment, confirming each one returns a valid response. Once your scenarios pass, generate your production token in IRIS, switch the environment in Settings, and your invoices start going to the live FBR system.
What is the difference between Validate and Submit?
Validate checks your invoice with FBR without posting it. Submit sends the invoice to FBR for a permanent invoice number. Always validate first when you are unsure about buyer or line-item details.
Sandbox vs production — which should I use?
Use sandbox while testing tokens, HS codes, and flows. Switch to production only when you are ready to issue live invoices. You can set the default environment in Settings.
Where do I add my FBR token?
Go to Settings and open FBR configuration for sandbox and/or production. Paste the token from IRIS, save, then try Validate on a draft invoice.
Why do I need buyer companies?
Saved buyers store NTN/CNIC, address, province, and registration type. On the invoice form you can pick a buyer in one click instead of retyping details that often cause FBR rejections.
What are HS codes and UOM?
HS code classifies the product for FBR. UOM is the unit of measure (for example Nos or KG). Use the lookups on the invoice form — wrong HS/UOM pairs are a common rejection reason.
My account says pending approval. What next?
An administrator must approve new taxpayer accounts. After approval you complete a short onboarding (business profile + FBR token), then you can create invoices.
I got a cryptic FBR error. What should I do?
Open the invoice — we show plain-language tips under the raw FBR message when we recognize common codes. Fix the listed fields, save, validate again, then submit. If it still fails, open a Support ticket with the invoice number.
How do branded PDFs work?
After FBR accepts an invoice you can download a PDF. Add your business name, address, and logo in Settings so the PDF matches your company.
What does the monthly subscription cover?
An active subscription keeps taxpayer access open for creating, validating, and submitting invoices. If it expires, contact your administrator to record payment.
How do I contact support?
Use Support in the app to open a ticket, or email subhani.lhr57@gmail.com. Include your account email and invoice number when reporting FBR failures.
