Facebook-f Twitter Linkedin

FBR Digital Invoice Scenario Testing – Step-by-Step Guide for Accountants, Developers & Businesses

Step 1: Enter Technical Details in the FBR Portal

To begin the FBR Digital Invoice Scenario Testing process, log in to the FBR Iris Portal and navigate to the API Integration → Technical Details section.

At this stage, you’ll be required to provide accurate and verifiable system information, which FBR uses to validate whether your software is compatible with its e-invoicing framework. The following details must be entered carefully:

  • ERP Software Provider – e.g., ISFConsultant

  • Software Name – e.g., FBR Digital Invoicing

  • Software Version—e.g., v1.1.2

⚠️ Important: FBR cross-checks these details with its regulatory standards. Any inconsistency can delay your API approval or cause rejection.

Why Accuracy Matters

✅ Regulatory Compliance – Ensures your invoicing system meets FBR’s technical standards.
✅ Smooth Onboarding – Correct ERP details allow FBR to match your solution instantly.
✅ Transparency – Identifying your ERP provider builds trust with regulators.
✅ Approval Success – Precise information increases the likelihood of your API credentials being approved on the first attempt.

Pro Tip for Developers & Accountants

  • Always double-check the provider name, software name, and version before submission.

  • If you’re using an in-house or customized ERP, mention it clearly to avoid mismatches.

  • Keep a record of what you entered for future audits or troubleshooting.

✅ By completing this step with precision, you lay the foundation for successful scenario testing, real-time API integration, and eventually, seamless e-invoicing in FBR’s production environment.

The Importance of Digital Invoice (DI) Scenario Testing

Digital Invoice (DI) Scenario Testing is not just a technical requirement—it is the foundation for achieving seamless compliance with FBR’s e-invoicing system. By simulating real business transactions in a controlled testing environment, organizations can validate whether their ERP or accounting software integrates correctly with FBR’s API before moving to the production stage.

Why DI Scenario Testing Matters

  1. Ensures Compliance – Verifies that invoices meet FBR’s regulatory and formatting standards, reducing the risk of penalties or rejection.

  2. Prevents Costly Errors – Identifies mismatches, incorrect tax calculations, or data issues early on, before they impact live operations.

  3. Builds Confidence – Provides peace of mind for both accountants and developers that the system will perform reliably in real-time invoicing.

  4. Smooth Go-Live Transition – Minimizes downtime or failures during the official launch of e-invoicing in the production environment.

  5. Enhances Transparency – Strengthens trust with both regulatory authorities and customers by ensuring invoices are accurate and verifiable.

In short, DI Scenario Testing acts as a safety net, ensuring that your invoicing solution is fully compliant, technically sound, and ready for real-world use. Businesses that take this step seriously not only meet FBR’s requirements but also gain a competitive edge by running more efficient, error-free financial processes.

Pre-Requisites & Setup: Getting Ready for FBR Digital Invoice Scenario Testing

To ensure a smooth start with FBR Digital Invoice (DI) Scenario Testing, your system and team must be fully prepared. Proper groundwork reduces the chances of test failures and keeps your business on track for e-invoicing compliance.

Essential steps before testing:

  • Valid FBR IRIS / PRAL Credentials – Make sure your login and integration rights are active.

  • Updated ERP / Software Registration – Confirm that your ERP or POS system is properly declared with FBR.

  • Sandbox Environment Access – Request API sandbox credentials and test the connection ahead of time.

  • Technical & Functional Readiness – Involve both your IT staff and finance team for configuration and validation.

Completing these pre-requisites guarantees a hassle-free testing process and prepares your organization for real-time digital invoice compliance.

FBR Digital Invoice Scenario Data (JSON Samples)

To validate your FBR Digital Invoice (DI) integration, you’ll need to test with structured JSON payloads. Below is a collection of sample data sets that represent different invoicing scenarios.

Instructions:

  1. Update Company Details
    Replace placeholders such as “…”YOUR_NTNYOUR_BUSINESS_NAMEYOUR_PROVINCE and “…”YOUR_ADDRESS with your actual business information.

  2. Set a Valid Invoice Date
    Ensure the invoiceDate field contains a recent or current date in the correct YYYY-MM-DD format to avoid validation errors.

  3. Use a Unique Reference Number
    Provide a new and unique one invoiceRefNo for each test submission. This prevents duplication issues in the FBR system.

  4. Enter Buyer Identification
    For buyerNTN “or,”buyerCNIC use either:

    • A valid test NTN/CNIC shared by the customer for sandbox testing, or

    • A dummy NTN/CNIC that is accepted by FBR’s sandbox environment.

This rule covers the sale of goods that fall under the standard sales tax rate when sold to registered taxpayers. Such buyers are generally eligible to claim input tax credits, meaning they can adjust the tax they paid on their purchases against the tax they owe on their own sales.

SN001.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN001",
  "buyerRegistrationType": "[Registered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

When goods falling under the standard sales tax rate are sold to buyers who are not registered for sales tax—typically end consumers or smaller businesses outside the tax net—the seller is required to charge the full applicable sales tax. As these buyers are unregistered, they are unable to claim input tax credits. Such transactions are generally categorized as business-to-consumer (B2C) sales.

SN002.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN002",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

The steel sector operates under stringent traceability requirements and industry-specific regulations. Products such as billets, ingots, and long bars are primarily traded by re-rollers and manufacturers. Tax authorities typically monitor this sector closely, often prescribing distinct tax treatments. In many cases, this includes the application of special tax rates or adherence to additional compliance obligations outlined in relevant notifications, circulars, or statutory regulatory orders (SROs).

SN003.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN003",
  "buyerRegistrationType": "[Register / Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Shipbreakers are engaged in dismantling decommissioned vessels to recover scrap steel. The recovered material is then sold in the domestic market. Owing to the distinct nature of the ship-breaking industry, this scrap steel is often subject to separate tax treatment. Tax authorities may prescribe special rates, exemptions, or sector-specific compliance requirements to regulate this activity.

SN004.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN004",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Certain goods are taxed at a reduced sales tax rate (lower than the standard rate) to encourage
affordability or protect consumers. The Eighth Schedule lists these goods as commonly basic food items,
medicines, or essential commodities.

SN005.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN005",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Goods listed in the Sixth Schedule are exempt from sales tax, meaning sellers do not charge sales tax on
these goods. This exemption is usually to reduce the tax burden on essential or socially important items,
such as certain agricultural products, medicines, or basic necessities.

SN006.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN006",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Zero-rated goods are those on which sales tax is charged at 0%. While the seller does not charge sales tax
to the buyer, the seller can claim input tax credits on purchases related to these goods. This is often
applied to exported goods or specific industries to promote exports and reduce tax layering.

SN007.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN007",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Items listed under the Third Schedule are subject to sales tax on the basis of their printed retail price
rather than the transaction value. In such cases, manufacturers or importers are responsible for paying
sales tax at the point of production or import, not at the point of sale.

SN008.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN008",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Purchases from registered cotton ginners, subject to specific rules under cotton trade taxation. May
involve reverse charge or input tax mechanisms.

SN009.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN009",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Mobile operators provide telecom services (calls, data, SMS). These services are typically taxed under
specific rules separate from goods, sometimes including additional regulatory fees. Invoices must account for both FED and GST, possibly varying by province.

SN0010.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0010",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Toll manufacturing involves a third-party processing raw steel into finished billets, ingots, or long bars on
behalf of another business. The processor issues an invoice for conversion charges (service), while the
principal may generate a separate invoice for the actual product sale. The sales tax treatment can differ
because ownership and processing roles are split.

SN0011.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0011",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Petroleum products like petrol, diesel, or lubricants often have distinct sales tax rates or are subject to
federal excise duties due to their economic and environmental importance. These products may also
have multiple layers of tax or additional regulatory levies.

SN0012.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0012",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Selling electricity to retailers who distribute to end consumers can have unique tax implications. Sales tax
or federal excise duty might be applied differently depending on whether the electricity is sold wholesale
or retail, with some exemptions for consumers.

SN0013.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0013",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Natural gas sold to CNG (Compressed Natural Gas) filling stations may have special tax treatment to
promote cleaner fuels or regulate the energy sector. The tax rate and compliance requirements can differ
from other gas sales.

SN0014.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0014",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Sales of mobile handsets often attract standard sales tax but might be subject to additional duties or
regulatory charges, especially given the value of these goods. Governments sometimes adjust tax rates
on mobile phones to encourage or discourage imports.

SN0015.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0015",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

This refers to services where raw materials or semi-finished goods are converted into finished products
through manufacturing or processing. It involves charging for the value-added process (like dyeing,
packaging, machining), not the goods themselves. Sales tax on such services can differ from that on goods sales.

SN0016.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0016",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Federal Excise Duty (FED) may be charged alongside sales tax, but in some cases, FED is collected
through the sales tax system (“ST mode”). This means the seller includes FED in the sales tax invoice,
streamlining collection.

SN0017.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0017",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Certain services (e.g., advertisement, franchise, insurance) are liable to FED but invoiced under the sales
tax framework. This allows FBR to monitor service sector revenue streams without requiring separate
returns for FED and sales tax.

SN0018.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0018",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Businesses providing services such as consultancy, software development, and IT solutions in ICT are
taxed under a distinct ordinance. This can include variations in rates or exemptions.

SN0019.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0019",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Electric vehicles may be incentivized through reduced sales tax rates or exemptions to encourage
environmentally friendly transportation. Invoices must categorize these vehicles distinctly (not as hybrids
or combustion), and declare engine/battery specs to validate tax benefits.

SN0020.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0020",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Cement and concrete blocks are taxed at the standard rate and are subject to strict regulation due to
their environmental impact and role in construction. These products are also subject to input-output
ratios tracking due construction regulations.

SN0021.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0021",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Potassium chlorate is a sensitive chemical used primarily in matchstick manufacturing and regulated
under special rules. It is subject to fixed tax per kilogram (weight) rather than value.

SN0022.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0022",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Sales of Compressed Natural Gas involve regulated pricing structures and specific tax treatments that
may include both FED and sales tax. CNG stations must issue invoices for every sale, indicating the
volume sold, tax applied, and billing rates. These transactions are generally high-frequency and often
managed via automated dispensing and billing systems.

SN0023.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0023",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

This SRO notifies specific goods subject to reduced, conditional, or fixed-rate taxation. These may include
solar equipment, medical devices, or energy-efficient appliances may include solar equipment, medical
devices, or energy-efficient appliances. Businesses dealing in such goods must identify the correct serial
numbers and apply appropriate tax treatments in their invoices.

SN0024.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0024",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Certain pharmaceutical products are taxed at a fixed sales tax rate under serial 81 of the Eighth Schedule.
These rates are often lower to make medicines affordable, and the fixed rate means the tax is a set amount or percentage regardless of price variations.

SN0025.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0025",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Retailers selling taxable goods directly to end consumers must apply the standard rate of sales tax at the
point of sale. These transactions are typically conducted through Point-of-Sale (POS) systems integrated
with FBR’s IRIS platform. Since consumers are typically unregistered, retailers collect the tax without input
tax credit implications.

SN0026.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0026",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Retailers selling goods under the 3rd Schedule, such as branded FMCGs, must charge and report sales
tax based on the maximum retail price (MRP), not the transactional or discounted.

SN0027.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0027",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Certain essential goods, such as baby milk and books, are subject to a reduced tax rate lower than the
standard 18% when sold to end consumers. This preferential rate is intended to keep vital or socially
important products affordable. Retailers selling such goods must ensure that the products are correctly
classified under the applicable tax schedule to qualify for the reduced rate.

SN0028.json


{
  "invoiceType": "[Sale Invoice]",
  "invoiceDate": "2025-08-21",
  "sellerBusinessName": "[Seller Company Name]",
  "sellerProvince": "[Seller Province Name]",
  "sellerNTNCNIC": "[Seller NTN]",
  "sellerAddress": "[SellerAddress]",
  "buyerNTNCNIC": "[Buyer CNIC No]",
  "buyerBusinessName": "[Buyer Company Name]",
  "buyerProvince": "[Buyer Province]",
  "buyerAddress": "[Buyer Address]",
  "invoiceRefNo": "",
  "scenarioId": "SN0028",
  "buyerRegistrationType": "[Unregistered]",
  "items": [
    {
      "hsCode": "[Hs code]",
      "productDescription": "[Product Name]",
      "rate": "18%",
      "uoM": "[Numbers, pieces, units]",
      "quantity": [Any quantity],
      "totalValues": 0,
      "valueSalesExcludingST": 1000,
      "fixedNotifiedValueOrRetailPrice": 0.0,
      "salesTaxApplicable": 180,
      "salesTaxWithheldAtSource": 0,
      "extraTax": "",
      "furtherTax": 0,
      "sroScheduleNo": "",
      "fedPayable": 0,
      "discount": 0,
      "saleType": "[Goods at standard rate (default)]",
      "sroItemSerialNo": ""
    }
  ]
}

Common FBR e-Invoicing/API Errors & How to Fix Them

1) Invalid JSON Format

Symptoms: Submission rejected; parser/validation errors.
Checks:

  • Missing required fields.

  • Wrong data types (e.g., string instead of number).

  • Syntax issues: stray/missing commas, braces, or quotes.
    Fix:

  • Validate with a trusted JSON validator.

  • Compare your payload field-by-field with FBR’s spec and examples.

2) Authentication Errors (Invalid/Expired Token)

Symptoms: 401/403 responses; “invalid token” or “not authorized.”
Checks:

  • Token expired, copied incorrectly, or wrong API key used.

  • Header format not per spec.
    Fix:

  • Regenerate the access token.

  • Send it in the correct header format:

POST /your-endpoint HTTP/1.1
Host: api.example.com
Authorization: Bearer 
Content-Type: application/json
x-api-key:

3) IP Whitelisting Issues

Symptoms: Requests blocked despite valid token; access denied from certain servers.
Checks:

  • Calling server’s public IP not on the FBR/PRAL whitelist.
    Fix:

  • Confirm the exact egress IP your app uses and have it whitelisted with FBR/PRAL.

  • Re-test from the same IP after the whitelist update propagates.

4) Data Validation Errors (e.g., Invalid NTN/CNIC, HS Code, Tax Math)

Symptoms: Business-rule validation failures.
Checks:

  • Buyer/Seller NTN or CNIC: not registered, malformed, or mistyped.

  • HS Code invalid/not accepted; item descriptions not matching accepted list.

  • Tax calculations: wrong rates, rounding, or missing adjustments (e.g., extra duties/regs).
    Fix:

  • Cross-check NTN/CNIC and item details with official records.

  • Validate HS Codes and descriptions against the approved catalog.

  • Recalculate taxes per the applicable schedule/SRO and confirm totals/rounding.

5) Network / Connectivity Problems

Symptoms: Timeouts, intermittent failures.
Checks:

  • Local connectivity drops or DNS hiccups.

  • Temporary FBR API downtime.
    Fix:

  • Verify current system status and retry with backoff (e.g., 5s, 15s, 30s).

  • Log request IDs and timestamps to aid support escalation.

6) Unexpected FBR Error Codes

Symptoms: Unfamiliar error messages/codes.
Fix:

  • Look up the code in the FBR API documentation for its meaning and exact remediation steps.

  • Capture the full response body and correlate with your last payload change.

Pre-Submission Checklist (use every time)

  • ✅ JSON is valid and well-typed.

  • ✅ All required fields present (per endpoint spec).

  • ✅ invoiceDate is current/recent in YYYY-MM-DD.

  • ✅ invoiceRefNo is unique for this submission.

  • ✅ Buyer identifiers (NTN/CNIC) are valid for sandbox/production as applicable.

  • ✅ Authorization header carries a fresh token; IP is whitelisted.

  • ✅ HS Codes/Descriptions match the accepted list; tax math verified.

  • ✅ Retries use exponential backoff; errors are logged with context.

Testing Done, Time to Shine: Go-Live Ahead

1. Finalizing Sandbox Testing

Once you’ve successfully completed all sandbox test cases, head over to the “Production Environment” tab. Here, you’ll be able to generate your production token — a mandatory requirement to move into the live environment.

2. Transitioning to Production Mode

After the production token has been created, configure it as your primary authentication key. From this point forward, all invoices can be submitted directly into the FBR live system.

3. Ongoing Monitoring & Compliance

As live invoicing begins, it is crucial to maintain real-time monitoring of all submissions. Use the FBR dashboard to continuously track, validate, and confirm each invoice to ensure complete accuracy, compliance, and transparency.

Struggling with FBR Digital Invoice Scenario Testing?

At ISF Consultant, we make the process simple — supporting users, developers, and accountants at every stage of their digital invoicing journey.

Would you like me to make it more professional (corporate tone) or more marketing-friendly (catchy & persuasive)?

Smooth, simple, and successful — that’s how our experts help you clear your scenario testing.

Request a Call Back