If you are running a business in Pakistan and using — or planning to use — Odoo ERP, one question comes up faster than any other: “Does Odoo connect to FBR?”
The answer is yes. But the better question is: “How does it work, what exactly does it do, and how do I get it set up correctly?”
FBR’s digital invoicing mandate has changed everything for Pakistani businesses. Manufacturers transmitting B2B invoices. Tier-1 retailers generating FBR receipts at every counter sale. Pharmaceutical distributors handling hundreds of mixed-tax invoices daily. Construction companies managing subcontractor WHT. All of it now flows — or should flow — through FBR’s IRIS portal in real time.
Odoo, configured correctly by a certified Pakistani partner, handles all of this automatically. This guide explains exactly how Odoo FBR integration works, what it covers, and how to get it implemented for your business.
What Is FBR IRIS and Why Does Your Business Need to Connect to It?
FBR IRIS (Integrated Revenue Information System) is FBR’s central digital tax management portal. It is where:
- All registered businesses transmit their B2B sales invoices in real time
- Tier-1 retailers transmit every counter sale receipt
- Monthly sales tax returns are filed
- WHT statements are submitted
- Input tax credit is claimed and verified
Who must connect to IRIS:
| Business Type | Requirement |
|---|---|
| Tier-1 Retailers | Every sale transmitted via FBR-integrated POS in real time |
| GST-Registered Manufacturers | Every B2B invoice transmitted in real time |
| GST-Registered Distributors | Every B2B invoice transmitted in real time |
| GST-Registered Importers | Purchase invoices documented for input tax claims |
| Service Tax Registered (PRA/SRB) | Service invoices per provincial requirements |
| Exporters (Zero-Rated) | Export invoices documented for zero-rating and input tax claims |
Failure to comply means: penalties (PKR 10,000+ per non-transmitted invoice), business sealing, input tax claim rejection, and FBR audit priority.
What Is Odoo FBR Integration — Exactly?
Odoo FBR integration is a technical connection between Odoo ERP and FBR’s IRIS API — enabling automatic, real-time transmission of invoice data from Odoo to FBR without any manual action by your team.
Here is what it does:
On every confirmed sales invoice:
- Odoo formats the invoice data in FBR’s required schema (NTN, STRN, buyer details, tax breakdown, invoice date, line items)
- Odoo sends this data to FBR’s IRIS API endpoint in real time
- IRIS processes the data and returns a unique FBR invoice number
- Odoo stores this FBR number against the invoice permanently
- The FBR number and QR code appear on the printed or emailed invoice PDF
For your monthly sales tax return:
- All transmitted invoices are stored in Odoo with their IRIS responses
- Monthly return data is compiled automatically — categorized by tax type
- Your accountant reviews and files — not manually compiling from scratch
What your team does: Nothing extra. The transmission happens automatically when the invoice is confirmed. No portal logins. No manual uploads. No copy-paste between systems.
Two Types of FBR Integration in Odoo
Type 1: Odoo B2B Invoice FBR Integration
This is for businesses issuing invoices to other registered businesses — manufacturers, distributors, importers, service companies.
How it works:
- Sales order confirmed → delivery done → invoice generated in Odoo
- Invoice automatically transmitted to FBR IRIS via API
- FBR number received and stored — visible on invoice PDF
- Buyer can verify the invoice on FBR’s verification portal using the FBR number or QR code
Tax handling:
- Standard 17% GST applied per product category — auto-configured
- Zero-rated for exports — fiscal position applied per customer
- Mixed invoices (exempt + taxable + zero-rated on one invoice) — all handled automatically
- Federal Excise Duty where applicable — tax component configuration
WHT handling:
- When a buyer deducts WHT from payment — recorded in Odoo against the invoice
- When you deduct WHT from vendor payments — calculated automatically per Section 153/154/155
- Monthly WHT statements generated from Odoo data
Type 2: Odoo POS FBR Integration (Tier-1 Retailers)
This is for businesses making retail counter sales — shops, pharmacies, supermarkets, restaurants, clothing stores, electronics retailers — that fall under FBR’s Tier-1 retailer definition.
What makes Tier-1 POS integration different:
- Must work in real time at the counter — customer is standing there
- Must work offline if internet drops — sales cannot stop
- FBR receipt must print immediately after payment
- QR code on receipt must be verifiable by customer instantly
How Odoo POS FBR integration works:
Step 1: Customer brings items to counter. Cashier scans barcodes or searches products.
Step 2: Odoo POS calculates the total with the correct FBR tax rate per product — automatically. No cashier selects tax manually.
Step 3: Customer pays. Payment confirmed in Odoo POS.
Step 4: Odoo POS sends invoice data to FBR IRIS API instantly — under 3 seconds.
Step 5: IRIS returns a unique FBR invoice number.
Step 6: Receipt prints with:
- FBR invoice number
- QR code (scannable by customer to verify on FBR portal)
- Correct tax breakdown
- All required FBR fields
Step 7: Transaction posts to inventory (stock reduced) and accounting (revenue and tax liability recorded) simultaneously.
Total time added by FBR integration: Under 3 seconds. Customer never notices.
Offline mode: If internet drops, Odoo POS continues working. Transactions are queued locally and transmitted to IRIS automatically when connectivity returns. No sales are lost. Compliance is maintained.
What MantechIT’s Odoo FBR Integration Covers
MantechIT has built and maintains Pakistan’s most comprehensive Odoo FBR integration. Here is exactly what it includes:
FBR IRIS API Connection
- Live connection to FBR’s production IRIS API endpoint
- Secure authentication and session management
- Automatic retry on failed transmissions — no manual intervention needed
- Complete transmission log — every request and response stored in Odoo
Invoice Data Mapping
All required FBR invoice fields correctly mapped from Odoo:
- Seller NTN and STRN
- Buyer NTN/STRN (for B2B) or CNIC (for B2C retail)
- Invoice date and unique sequential invoice number
- Line-item tax breakdown (tax type, rate, taxable amount, tax amount)
- Total invoice value and total tax
- FBR invoice category (B2B, B2C, export)
Tax Configuration
- Standard GST (17%): Configured per product category — auto-applied
- Zero-rated exports: Fiscal position maps tax to zero per export customer
- Exempt products: Zero tax applied without reporting requirement
- Federal Excise Duty: Tax component added where applicable
- PRA/SRB service tax: Configured for service businesses in Punjab and Sindh
- Mixed invoices: Multiple tax rates on one invoice — all transmitted correctly
FBR Number & QR Code
- FBR invoice number received from IRIS and stored against each Odoo invoice
- QR code generated and embedded in invoice PDF template
- Customer receipt (POS) and B2B invoice PDF both updated with FBR number and QR code
Monthly Sales Tax Return Compilation
- All IRIS-transmitted invoices available in Odoo tax reports
- Monthly return data categorized: standard, exempt, zero-rated
- Input tax from vendor bills with FBR numbers tracked separately
- Net tax payable calculated automatically
- Data exportable in FBR-compatible format
WHT Automation
- Section 153 WHT on purchases from manufacturers: Auto-deducted
- Section 154 WHT on exports: Tracked per shipment
- Section 155 WHT on rent and services: Configured per payment type
- Monthly WHT statement generated for FBR filing
- CPR reconciliation maintained in Odoo
Error Handling & Alerts
- IRIS rejection errors displayed clearly in Odoo with resolution guidance
- Failed transmission alerts to designated email/WhatsApp
- Dashboard showing transmission status for all invoices (transmitted / pending / failed)
- Automatic retry for transient IRIS failures
Odoo POS FBR Integration — Technical Requirements
For Tier-1 retailers implementing Odoo POS with FBR integration:
Hardware:
- Any modern computer, tablet, or POS terminal running Odoo POS
- Receipt printer (thermal, compatible with Odoo)
- Barcode scanner (USB or Bluetooth)
- Internet connection (with offline mode fallback)
- Optional: Cash drawer, customer display
Software:
- Odoo 16 or 17 (Community or Enterprise)
- MantechIT’s FBR IRIS integration module
- FBR POS registration for each branch location
Network:
- Stable internet connection recommended
- Offline capability built in — no sales interruption during outages
- Minimum 1 Mbps for smooth IRIS transmission
FBR Registration:
- Your business must be registered with FBR as a Tier-1 retailer
- Each branch location must be registered in FBR’s POS system
- POS terminal IDs linked to your FBR registration
MantechIT handles the FBR registration and technical setup as part of the POS implementation.
Industries Using Odoo FBR Integration in Pakistan
Manufacturing Companies
Scenario: A Lahore textile manufacturer receives purchase orders from distributors across Pakistan. Each sale generates a B2B invoice that must be transmitted to IRIS.
With Odoo FBR integration: Every invoice auto-transmitted on confirmation. FBR number on every invoice PDF. Monthly return compiled in under 3 hours. Zero manual IRIS uploads.
Wholesale Distributors
Scenario: A Lahore pharmaceutical distributor delivers to 300+ pharmacies and hospitals monthly — generating 1,000+ invoices with mixed tax treatment (exempt, zero-rated, standard).
With Odoo FBR integration: Each invoice transmitted automatically with correct tax per line item. No cashier selects tax. No accountant manually uploads. Pharmacist receives invoice with FBR number for their own input tax claim.
Retail Chains (Tier-1)
Scenario: A Lahore fashion brand with 8 branches in DHA, Gulberg, Bahria Town, and Packages Mall. Every counter sale must generate an FBR receipt instantly.
With Odoo POS FBR integration: Every sale at every branch transmits to IRIS in under 3 seconds. FBR QR code on every receipt. Works offline if internet drops. All 8 branches managed from one Odoo instance.
Pharmaceutical Companies
Scenario: A pharma distributor on Brandreth Road, Lahore selling medicines with 3 different tax treatments on the same invoice — some exempt, some zero-rated, some standard GST.
With Odoo FBR integration: Tax rates configured per product. Mixed invoice generated correctly. IRIS receives correct data for each line item. Monthly return shows accurate input and output tax by category.
Construction Companies
Scenario: A Lahore construction contractor invoicing clients for construction services (PRA 16%) and deducting WHT from subcontractor payments (Section 153).
With Odoo FBR integration: PRA 16% applied automatically on client invoices. Section 153 WHT deducted automatically on subcontractor payments. Monthly WHT statement generated for filing.
Common FBR Integration Problems — And How Odoo Solves Them
Problem 1: Wrong NTN/STRN on buyer invoices Most common reason IRIS rejects B2B invoices. With Odoo, buyer NTN/STRN stored in their profile — auto-populated on every invoice. Human error eliminated.
Problem 2: Wrong tax rate applied Manual tax selection leads to errors — especially on mixed invoices. Odoo applies the correct rate per product category automatically. Zero manual tax decisions at invoice creation.
Problem 3: Non-sequential invoice numbers IRIS rejects invoices with duplicate or non-sequential numbers. Odoo generates sequential invoice numbers in the correct FBR format — no gaps, no duplicates, ever.
Problem 4: Transmission failures going undetected Manual systems miss failed uploads. Odoo’s integration monitors every transmission and alerts designated staff when any invoice fails to transmit — with clear error details for resolution.
Problem 5: Monthly return does not match IRIS data When invoices are manually uploaded, discrepancies between accounting records and IRIS data are common. With Odoo, the monthly return is compiled directly from IRIS-transmitted invoice data — perfect reconciliation guaranteed.
How to Get Odoo FBR Integration for Your Business
Step 1: Initial Consultation (Free)
Contact MantechIT. We assess your business: registration status, business type, invoice volume, tax regime (GST, PRA, SRB, zero-rating, FED), and current invoicing process. Time: 1–2 hours | Cost: Free
Step 2: Project Scoping
We provide a written project scope covering Odoo modules required, FBR integration configuration, timeline, and fixed cost — before you commit to anything. Time: 3–5 business days | Cost: Free
Step 3: Odoo Installation & Configuration
Odoo deployed on your hosting environment. Tax rules configured per your product catalogue and customer base. Customer NTN/STRN database set up. Invoice templates configured with FBR fields. Time: 1–2 weeks
Step 4: FBR IRIS Integration Setup
MantechIT’s FBR integration module installed and connected to your FBR credentials. Test invoices transmitted in FBR’s sandbox environment. Each tax scenario tested and verified. Time: 1 week
Step 5: Staff Training
Your accounts team trained on invoice creation, tax selection (simplified — mostly automatic), FBR number verification, and monthly return review. For POS: cashiers trained on counter operations and receipt handling. Time: 1–3 days
Step 6: Go-Live
First live invoices transmitted to FBR production IRIS. MantechIT monitors transmissions for the first week. Any IRIS responses or errors resolved immediately. Time: 1 week monitoring
Step 7: Ongoing Support
Monthly FBR regulatory changes applied. Odoo updates maintained. New tax categories added when your product range expands. Annual FBR registration renewals assisted. Time: Ongoing
Why Choose MantechIT for Odoo FBR Integration in Pakistan
MantechIT is Pakistan’s Official Odoo Partner — certified by Odoo S.A. We have deployed Odoo FBR integration across:
- Pharmaceutical distributors on Brandreth Road, Lahore
- Textile manufacturers in Sundar Industrial Estate
- Retail chains across DHA, Gulberg, and Packages Mall
- Construction contractors in Lahore’s commercial districts
- Chemical distributors on Shah Alam Market
- Food & beverage manufacturers in Quaid-e-Azam Industrial Estate
Frequently Asked Questions
Conclusion: Odoo FBR Integration Is Not Optional — Get It Done Right
FBR’s e-invoicing requirements are not going away. They are expanding — covering more businesses, more transaction types, and more reporting requirements with every passing year. Pakistani businesses that automate FBR compliance through proper Odoo integration stay ahead of every regulatory change. Those that continue with manual uploads face increasing penalties, audit risk, and operational inefficiency.
Odoo + MantechIT’s FBR integration is the most comprehensive, reliable, and Pakistan-proven approach available in 2026:
- Real-time IRIS transmission — B2B and Tier-1 retail
- All tax regimes covered — GST, PRA, SRB, WHT, FED, zero-rating
- Mixed tax invoices handled automatically
- Monthly return compiled in under 3 hours
- Error handling with automatic retry and alerts
- Regulatory updates included in support
- Live demo before you commit
Whether you are a manufacturer in Sundar Industrial Estate, a distributor on Brandreth Road, a retail chain in DHA, or a pharmaceutical company in Kot Lakhpat — MantechIT has the Odoo FBR integration expertise to make your business fully compliant and operationally efficient.
Book Your Free Odoo FBR Integration Demo
See MantechIT’s Odoo FBR integration working live — real invoice transmitted to IRIS, FBR number returned, QR code generated. No theory. No slides. Just the real thing.
📞 Call: +92 (345) 888-0987 📍 Visit: Office 8, 1st Floor, Block E, Johar Town, Lahore 🌐 Book Free Demo → 🗺️ Serving: Lahore · Karachi · Islamabad · Faisalabad · Sialkot · Gujranwala · Rawalpindi · All of Pakistan
