Back to Articles
FBR ComplianceFeatured

FBR Digital Invoice Compliance: A Complete Guide for Pakistani Retailers

Everything you need to know about FBR Digital Invoicing (DI) requirements for Pakistani retailers — from registration to real-time invoice submission and common error fixes.

GT

GridX Team

Business Solutions Team

10 May 2025 8 min read

The Federal Board of Revenue (FBR) launched its Digital Invoice (DI) system to modernize Pakistan's tax infrastructure and reduce evasion. If you run a retail store, restaurant, or wholesale business in Pakistan, understanding and implementing FBR DI compliance is no longer optional — it's a legal requirement.

This guide explains everything you need to know to stay compliant, avoid penalties, and submit invoices correctly.

What is FBR Digital Invoicing?

FBR Digital Invoicing (also called the POS Integration system) requires registered businesses to:

  1. Connect their POS system to FBR's servers via the Digital Invoice API
  2. Submit every sale invoice to FBR in real-time (within seconds of the transaction)
  3. Print a QR code on every customer receipt that customers can scan to verify authenticity
  4. Maintain digital records of all submitted invoices for audit purposes

The key regulation: Any business with annual turnover above a threshold set by FBR must use an FBR-registered POS system and submit invoices digitally.

Which Businesses Must Comply?

FBR DI compliance is mandatory for:

  • Tier 1 retailers — large retail chains, shopping malls
  • Restaurants and food service businesses
  • Electronics dealers registered under FBR's special schemes
  • Pharmaceutical distributors and retailers
  • Steel and construction material suppliers

Check the FBR website for the current list of notified sectors and annual turnover thresholds.

Understanding FBR Sale Scenarios (SN001–SN028)

FBR has defined 28 different invoice scenarios depending on:

  • Whether the buyer is registered (has NTN) or unregistered (consumer)
  • The applicable tax rate (standard 18%, reduced 5%, exempt, zero-rated)
  • The type of goods (standard, pharmaceutical, steel sector, electricity, etc.)

Here are the most commonly used scenarios:

| Scenario | Description | Tax Rate | Buyer Type | |----------|-------------|----------|------------| | SN001 | Standard rate — registered buyer | 18% GST | NTN holder | | SN002 | Standard rate — unregistered buyer | 18% GST | Consumer | | SN005 | Reduced rate (8th Schedule) | 5% | Either | | SN006 | Exempt supplies | 0% | Either | | SN007 | Zero-rated exports (5th Schedule) | 0% | Either | | SN008 | 3rd Schedule (fixed/notified price) | Special | Either | | SN026 | Further tax applicable | 18% + 3% | Unregistered |

Most retail stores will use SN001 (for NTN buyers) and SN002 (for regular consumers).

Step-by-Step: Registering Your Business on FBR DI

Step 1: Register for a Sales Tax Number (STN)

If you're not already registered for sales tax, apply through:

  • IRIS portal: iris.fbr.gov.pk
  • Required documents: NTN, CNIC, bank account details, business address

Step 2: Get FBR DI API Credentials

Once registered:

  1. Log in to IRIS
  2. Navigate to Digital Invoice Registration
  3. Request API credentials (Bearer token)
  4. Note your POSID and Business ID

Step 3: Connect Your POS System

Your POS software (like ClearRing) needs to be configured with:

  • FBR staging URL (for testing): https://gw.fbr.gov.pk/pdi/v1/
  • Your Bearer token
  • Your seller NTN and province code

Step 4: Test in Staging Mode

Always test in FBR's staging environment first. Submit a few sample invoices and verify:

  • Status code 00 = Valid (accepted)
  • QR code generates correctly
  • No error codes in the response

Step 5: Go Live

Once staging tests pass, switch your POS to LIVE mode and start submitting real invoices.

Common FBR DI Errors and How to Fix Them

Error 0052 — "HS Code does not match with provided sale type"

Cause: The HS code you assigned to a product doesn't match the FBR scenario.

Fix:

  • For exempt goods (SN006): leave sroScheduleNo empty
  • For 8th Schedule goods (SN005): use the correct HS code subcategory

Error 0096 — "UOM not valid for this HS code"

Cause: Wrong unit of measure for the product type.

Fix:

  • Electricity (SN013): must use KWH
  • Steel (SN003): must use MT (metric tonnes)

Invoice Rejected After Submission

If FBR accepts the submission but rejects the invoice:

  1. Check the invoiceStatuses array in the FBR response
  2. Each item shows errorCode and error message
  3. Fix the specific field and retry

A good POS system (like ClearRing) stores the full FBR response and lets you retry with overrides without losing the original submission record.

FBR Compliance Checklist for Retailers

Use this checklist to ensure you're fully compliant:

  • ✅ Sales Tax Number (STN) registered with FBR
  • ✅ FBR DI API credentials obtained
  • ✅ POS software connected to FBR staging
  • ✅ All products assigned correct HS codes and UOMs
  • ✅ Buyer type (Registered/Unregistered) set correctly
  • ✅ Staging test invoices passing with status 00
  • ✅ Live mode enabled and invoices being submitted in real-time
  • ✅ QR codes printing on all receipts
  • ✅ Failed/rejected invoices retried within FBR's allowed window

How ClearRing Handles FBR DI

ClearRing (by GridX) is purpose-built for FBR compliance:

  • All 28 scenarios supported — SN001 through SN028
  • Real-time submission via BullMQ job queue — sale completes even if FBR is temporarily down
  • Auto-retry with exponential backoff (5 attempts, 30s → 4 min delays)
  • Rejection tracking — full FBR response stored, retry-with-overrides available
  • QR code on receipt — standard on all printed receipts
  • Staging and live mode — test without risk, switch to live with one setting
  • HS code search — search the FBR HS code database directly from product settings

Start your free 30-day trial →

Final Thoughts

FBR Digital Invoicing is here to stay. Businesses that implement it correctly will not only avoid penalties but also build a digital paper trail that simplifies audits, improves financial management, and builds customer trust.

If you're looking for a POS system that handles all of this automatically — check out ClearRing by GridX.

#FBR#Digital Invoice#POS Pakistan#Tax Compliance#FBR DI

Ready to get started with ClearRing?

Free 30-day trial, FBR-compliant cloud POS, no credit card required.

Start Free Trial →