Pakistan FBR Digital Invoicing (PRAL) for Magento 2

Key Features

FBR/PRAL digital invoicing submission via queued, retry-safe REST service contract wired in di.xml — each Magento invoice is posted to IRIS at issue time

Invoice Reference Number (IRN) and FBR-prescribed QR code returned, persisted against the Magento invoice, and rendered on the invoice PDF and customer order view

Sales tax (17%), further tax, extra tax, and provincial/federal handling mapped from your Magento tax rules to the FBR invoice JSON schema

Exempt, zero-rated, and reduced-rate line handling so mixed carts submit correct tax breakdowns per line item

NTN and STRN capture and format validation for buyer and seller, stored on customer and store config

Dual environment support — FBR sandbox for certification and production endpoints, toggled from admin config without code changes

Order/invoice lifecycle integration through Magento observers and plugins (interceptors) — no core file edits

Admin configuration under Stores → Configuration with ACL resources so only authorized roles can manage FBR credentials and toggles

Admin grid showing per-invoice FBR status (submitted, IRN issued, failed, pending) with manual re-submit action

Cron-based reconciliation job that automatically retries deferred or failed submissions and logs FBR responses

Structured logging and error capture of every PRAL request/response for audit and FBR dispute resolution

Compatible with Magento 2 Open Source and Adobe Commerce; REST/GraphQL-safe so headless and PWA storefronts can trigger submission server-side

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

You order

Start with a one-time build price. We scope it with you at kickoff.

We build & install

ECOSIRE builds, configures and installs it on your Magento 2.

Go live + support

You go live in about 2–4 weeks, with a post-launch support window.

About this Product

Pakistan's Federal Board of Revenue (FBR) has brought sales-tax registered businesses into mandatory real-time digital invoicing through the PRAL/IRIS platform. Every taxable sale must be transmitted to FBR at the moment of issue, validated, and returned with an Invoice Reference Number (IRN) and an FBR-prescribed QR code printed on the customer's invoice. Magento 2 ships nothing for this — there is no native FBR connector in Open Source or Adobe Commerce.

ECOSIRE builds this integration to order for your specific store. We deliver a proper Magento 2 module under app/code/Ecosire/FbrDigitalInvoicing that hooks into the order/invoice lifecycle via observers and plugins (interceptors), maps your Magento order, tax, and customer data to the FBR invoice JSON schema, and posts it to the PRAL REST endpoints using a queued, retry-safe di.xml-wired service contract. On a successful FBR response the IRN and QR are persisted against the Magento invoice and rendered on the PDF and the customer's order view.

Because it is built to order, we tailor the field mapping to your exact tax setup: standard sales tax (17%), further tax, extra tax, provincial vs federal handling, exempt and zero-rated lines, and your NTN/STRN identifiers with validation on capture. We wire admin configuration under Stores → Configuration with ACL-protected access, support both the FBR sandbox and production endpoints, add a cron-based reconciliation job for any deferred or failed submissions, and expose an admin grid showing FBR status per invoice. After purchase, ECOSIRE installs the module on your environment, runs sandbox certification with you, switches you to production, and provides ongoing support and updates as FBR's schema evolves. Honest lead time and scope are confirmed before any build begins.

What you get

Custom Magento 2 module (Ecosire_FbrDigitalInvoicing) delivered under app/code, composer-installable, namespaced and PSR-4 compliant

FBR/PRAL API integration layer with sandbox certification completed with your FBR credentials before go-live

IRN + QR rendering on Magento invoice PDF and customer-facing order/invoice views

Admin configuration section, ACL resources, and per-invoice FBR status grid with re-submit

Cron reconciliation job and structured request/response logging for audit

Installation on your staging and production environments by ECOSIRE, plus a short admin walkthrough and handover documentation

Who this is for

Sales-tax registered Magento merchant in FBR scope

A Pakistani online retailer or wholesaler newly required to file real-time digital invoices with FBR and needing each Magento sale to carry a valid IRN and QR without disrupting checkout.

Finance and tax compliance manager

Responsible for accurate sales-tax (17%), further-tax, and exempt-line reporting to FBR, who needs reliable per-invoice status, audit logs, and automatic retry of failed submissions.

Magento agency or in-house developer

Wants a clean, observer- and plugin-based module under app/code with proper di.xml service contracts and ACL — no core hacks — that they can maintain alongside the rest of the store.

How Pakistan FBR Digital Invoicing (PRAL) for Magento 2 Compares

Criterion	ECOSIRE	Custom Build	Competitor
Real-time FBR/PRAL invoice submission with IRN and QR	Included	Partial support	Not included
Mapped to your exact tax setup (17% sales tax, further/extra tax, exempt/zero-rated)	Included	Partial support	Not included
NTN/STRN capture and validation	Included	Partial support	Not included
Sandbox certification and production cutover handled for you	Included	Not included	Not included
Built with clean Magento patterns (di.xml, observers, plugins, ACL) — no core edits	Included	Partial support	Partial support
Cron reconciliation and retry of failed submissions	Included	Partial support	Not included
Ongoing support and updates as FBR schema changes	Included	Not included	Partial support
Works on both Open Source and Adobe Commerce	Included	Partial support	Partial support

Frequently Asked Questions about Pakistan FBR Digital Invoicing (PRAL) for Magento 2

How long until the extension is delivered and live?

This is a build-to-order extension, not an instant download. After we confirm your tax setup, FBR/PRAL credentials, and Magento version, a typical build, sandbox certification, and production go-live runs about 2 to 4 weeks depending on scope. We agree the exact lead time and scope in writing before any work starts, and we install it on your environments ourselves.

Do I get ongoing support and updates as FBR changes its schema?

Yes. FBR's PRAL/IRIS schema and validation rules evolve, so ECOSIRE provides ongoing support and maintains the integration against those changes. Support terms (response times and update coverage) are set out at purchase. We monitor FBR schema updates and apply the necessary mapping changes so your submissions keep passing.

Is this a ready-made Adobe Commerce Marketplace extension I can self-install?

No. There is no official FBR connector in the Adobe Commerce Marketplace or Magento core. ECOSIRE builds this module specifically for your store and installs it for you. You receive the actual source under app/code, but the integration is configured and certified against FBR by us.

Does it work with both Magento Open Source and Adobe Commerce?

Yes. The module is built with standard Magento 2 mechanisms — modules under app/code, di.xml service contracts, observers, and plugins (interceptors) — so it runs on both Open Source and Adobe Commerce. It is server-side and REST/GraphQL-safe, so headless and PWA storefronts are supported too.

How are sandbox and production FBR environments handled?

Both endpoints are supported and switchable from the admin configuration. We first complete certification against the FBR sandbox using your test credentials, validate IRN and QR generation end to end, then switch you to the production endpoint for live submission. No code change is needed to move between environments.

What happens if FBR is unreachable or rejects an invoice?

Submissions are queued and retry-safe. Failed or deferred invoices are logged with the full FBR response and automatically retried by a cron reconciliation job. The admin grid shows each invoice's status and lets an authorized user re-submit manually, so no taxable sale is silently lost.