Pakistan FBR Digital Invoicing (PRAL) for Magento 2

核心功能

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

按需定制，全程代劳

无需自行搭建——由 ECOSIRE 构建、安装并提供支持的可用应用。

您下单

以一次性构建价格开始。我们在启动时与您共同确定范围。

我们构建与安装

ECOSIRE 在您的 Magento 2 上构建、配置并安装。

上线 + 支持

约 2–4 周内上线，并提供上线后的支持期。

关于此产品

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.

你得到什么

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

这是给谁的

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.

Pakistan FBR Digital Invoicing (PRAL) for Magento 2 如何比较

标准	伊科西尔	定制建造	竞争对手	Magento 2 原生
Real-time FBR/PRAL invoice submission with IRN and QR	包含	部分支持	不包括在内	不包括在内
Mapped to your exact tax setup (17% sales tax, further/extra tax, exempt/zero-rated)	包含	部分支持	不包括在内	不包括在内
NTN/STRN capture and validation	包含	部分支持	不包括在内	不包括在内
Sandbox certification and production cutover handled for you	包含	不包括在内	不包括在内	不包括在内
Built with clean Magento patterns (di.xml, observers, plugins, ACL) — no core edits	包含	部分支持	部分支持	不包括在内
Cron reconciliation and retry of failed submissions	包含	部分支持	不包括在内	不包括在内
Ongoing support and updates as FBR schema changes	包含	不包括在内	部分支持	不包括在内
Works on both Open Source and Adobe Commerce	包含	部分支持	部分支持	部分支持

关于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.