0% found this document useful (0 votes)
193 views9 pages

FBR Digital Invoicing System Guide

The Digital Invoicing System by FBR allows registered taxpayers to report invoices in real-time, offering benefits such as automated tax calculations and reduced manual errors. It is mandatory for taxpayers to use this system, which can be accessed via the IRIS portal, and offers both API and manual integration options. Users must complete a Sandbox testing phase before moving to the Production Environment, ensuring successful invoice submissions through specified scenarios.

Uploaded by

Haseeb Zia
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
193 views9 pages

FBR Digital Invoicing System Guide

The Digital Invoicing System by FBR allows registered taxpayers to report invoices in real-time, offering benefits such as automated tax calculations and reduced manual errors. It is mandatory for taxpayers to use this system, which can be accessed via the IRIS portal, and offers both API and manual integration options. Users must complete a Sandbox testing phase before moving to the Production Environment, ensuring successful invoice submissions through specified scenarios.

Uploaded by

Haseeb Zia
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd

Digital Invoicing FAQs

1. What is the Digital Invoicing System?


The Digital Invoicing System is an initiative by FBR to modernize invoice
reporting. It allows taxpayers to report invoices in real-time using PRAL's
integration platform.
2. What are the benefits of using the Digital Invoicing System?
• Real-time invoice submission and validation.
• Automated tax calculations.
• Seamless integration with ERP systems.
• Reduced manual errors and improved compliance.
• Auto population of invoices in Annexure C and Sales Tax Return.

3. Is the Digital Invoicing System mandatory?


Yes, as per FBR regulations defined in SRO 709(I)/2025, registered taxpayers
must use the system for issuing and managing digital invoices.

4. How do I access the Digital Invoicing System?


You can access the system via the IRIS portal using your registration number and
password. Navigate to Digital Invoicing from the dashboard. Detailed
documentation available on FBR website.

5. What are the two integration modes available?


API Integration: For automated real-time invoice submission.
Manual Invoice Generation: For manual entry of invoices (limited functionality).

6. Is integration with PRAL mandatory?


No. Taxpayers can choose PRAL or any other FBR-licensed integrator. However,
PRAL offers free services, while others may charge a fee.
7. How do I register for Digital Invoicing through PRAL?
PRAL provides free integration services, including Sandbox testing. You will need
to:
• Submit technical details (contact person, ERP details, etc.).
• Provide IP whitelisting details (mandatory step).
• Complete assigned scenarios on the basis of selected business nature and
activity in sandbox environment before moving to Production.

8. What if I choose another Licensed Integrator?


You must select the LI from the dropdown list and submit your application. The
LI will review and approve your request. The remaining process (IP whitelisting,
Sandbox, etc.) will be handled by the LI.

9. What technical details are required for registration?


Technical contact person details (name, mobile, email).
• ERP or any other invoicing system provider information.
• Software type (Cloud/On-Premises) and version.
• CRM User ID and password for support.

10. What is IP Whitelisting, and why is it required?


IP whitelisting ensures secure communication between taxpayer’s system and
PRAL's servers. You must provide:
• Hosting server details (company name, country).
• Up to 3 IP addresses or upload a file for multiple IPs.

11. How do I upload multiple IPs?


Use the downloadable Excel template, enter IP details, and upload. File should
be less than or equal to 1 MB in .xls format.
12. How long does IP whitelisting approval take?
PRAL typically approves or rejects IP whitelisting requests within 2 working
hours.
13. What is the Sandbox Environment?
The Sandbox is a testing environment where you can simulate invoice
submissions before going live. It helps ensure your integration works correctly.

14. How do I access the Sandbox Environment?


After IP whitelisting approval, navigate to the Sandbox Environment tab to:
• View Web API details.
• Access sample JSON formats and code snippets.
• Submit scenarios-based test invoices.

15. What happens after Sandbox access is granted?


• Get Sandbox token
• Use test credentials and endpoints
• Submit invoices using scenario-based testing according to your
sector/business type

16. What test invoices should I submit?


Submit invoices that match the Business Nature and Sector selected during
registration. Each submission will generate a unique Invoice Number.

17. What are scenarios in Sandbox testing?


Scenarios are predefined test cases (e.g., standard rate sales, exempt goods)
based on your business activity. Refer to the Point # 9 Scenarios for Sandbox
Testing section of Technical Document.

18. How do I know which testing scenarios to use?


The eligible scenarios will be viewable in sandbox environment. Further you may
check the point # 10 “Applicable Scenarios based on Business Activity” in the
technical document. E.g., textile manufacturers must test SN001, SN002, SN005,
SN006, etc.
19. How do I know if my Sandbox test is successful?
The system will validate your test invoices.
Upon successful completion of all assigned scenarios, a Production Token will
be auto generated.

20. How much invoices of each scenario I need to complete?


Minimum 1 invoice of each scenario must be successful to mark it complete.
Note: The successful, pending and unsuccessful scenarios will be viewable in
sandbox environment.

21. What if a test invoice fails?


Use the error code returned to fix issues. Refer to detailed error code list
provided in the technical document (Sales/Purchase Errors).

22. How do I move from Sandbox to Production?


Once all test invoices are successfully submitted, the system will generate
a Production Token. Use this token to complete integration in the Production
Environment.

23. What details are available in the Production Environment?


• Production API details.
• Security Token for real-time invoice submissions.

24. How do I go live?


• Use Production Token
• Switch endpoints
• Start real-time invoice posting
25. What are the key APIs to use?
postinvoicedata (Real-time invoice posting)
validateinvoicedata (Validation before posting)
Reference APIs for:
• Province Code
• HS Code
• Rate ID
• UOM ID
• SRO Items
• STATL Status
(Available in Technical document Point # 4 Digital Invoicing APIs)
26. How do I authenticate API requests?
Include the Security Token in the request header as follows:
Authorization: Bearer <Your_Security_Token>

27. What is the API endpoint for posting invoices?


Sandbox: [Link]
Production: [Link]

28. What is the JSON structure for invoice submission?


Refer to the point # 4.1.1 & 4.1.2 in Technical Documentation for sample JSON
structures for both Sandbox and Production.
29. How do I test APIs using Postman?
Set the Authorization header: Bearer <Your_Token>
For Production:
• Use POST for /postinvoicedata
• Use POST for /validateinvoicedata
For Sandbox:
• Use POST for /postinvoicedata_sb
• Use POST for /validateinvoicedata_sb

30. Do Sandbox and Production have separate URLs?


Yes, as mentioned in Technical document point # 4.1 & 4.2.

31. What format is required for invoices?


JSON object with fields like invoiceType, sellerNTNCNIC, hsCode, rate, etc. Refer
to the sample JSONs in the technical document.

32. Where can I get the list of valid HS Codes, UOMs, or SROs?
Use the Reference APIs:
[Link] (HS Codes)
[Link] (UOM)
[Link] (SROs)
For further details refer to the point # 5 Reference APIs in technical document.
33. How do I handle errors in API responses?
Check the point # 7 Sales Error Codes and point # 8 Purchase Error Codes in the
Technical Documentation for detailed error descriptions and resolutions.
34. What do I do if I get an error code?
Refer to the detailed error code tables:
Sales Errors (e.g., Code 0046: "Provide rate.")
Purchase Errors, Each code includes description and resolution suggestion

35. My invoice returns Invalid but has no error message.


Check your JSON validity and check the nested invoiceStatuses array; each line
item may have its own error.

36. Why am I getting "Calculated Tax Not matched in 3rd Schedule" error??
This occurs when sales tax isn't calculated correctly for 3rd Schedule goods.
Use fixedNotifiedValueOrRetailPrice instead of sale value for tax calculation.
"fixedNotifiedValueOrRetailPrice": 1000,
"salesTaxApplicable": 180 // 18% of fixed value

37. How do I fix "Invalid UOM" error?


This means your Unit of Measurement is incorrect.
• UOM values are case-sensitive (use "KG" not "kg")
• Verify correct UOM from Reference API
([Link]
38. What causes "Wrong sale type is selected with invoice" error?
This occurs when your sale type doesn't match the transaction. Match sale
type to your business scenario. Use the correct sales type as provided in the
reference APIs.
Common valid types:
• "Goods at standard rate (default)"
• "Exempt Goods"
• "3rd Schedule Goods"
39. Why does the system say "Provide rate" when I've entered one?
This occurs when your rate doesn't match the required rate for the sale type.
Check required rates using:
[Link]
40. How should I format HS Codes to avoid errors?
HS Codes must follow strict formatting.
Requirements:
• 4 digits before decimal
• 4 digits after decimal
• Example: 0101.2100
Verify codes using: [Link]
41. What does "Unauthorized token" mean and how do I fix it?
This means your security token is invalid or expired. Use correct token for your
environment (Sandbox vs Production).
Correct header format: Authorization: Bearer <Your_Valid_Token>

42. Why does the system say my seller NTN is invalid?


Your NTN must be registered with FBR and match API credentials.
• Ensure NTN is active
Format: "sellerNTNCNIC": "1234567890123"
43. How should I set buyer registration type correctly?
This must accurately reflect buyer's status.
Options:
• "Registered" (FBR-registered)
• "Unregistered" (not registered)
Example: "buyerRegistrationType": "Unregistered"
44. What's the correct way to enter province information?
Provinces must use exact official names. Refer to reference APIs in technical
document.
Incorrect: "Karachi", "Lahore" (use province names)
Correct Format:
"buyerProvince": "Punjab",
"sellerProvince": "Sindh"

45. How do I raise a new case in CRM?


• Log in to the CRM. ([Link]
• Click + New Case.
• Fill in mandatory fields (priority, query type, title, description).
• Attach supporting documents (PDF, max 20MB).

46. How can I track my support case?


• Use the Case List to view existing cases.
• Search by case number or title.
• Click View to check updates or add correspondence.

47. Where can I find more help?


• Refer to the User Manual and Technical Documentation.
Contact PRAL support via CRM [Link] or email
[Link]@[Link]

Common questions

Powered by AI

If a taxpayer does not have a Production Token after completing Sandbox testing, it implies that the testing scenarios were not satisfactorily completed, preventing transition to the Production Environment. The absence of a Production Token indicates incomplete integration validation, thereby stalling real-time invoice processing in live environments . Taxpayers should revisit their Sandbox testing to identify and rectify any incomplete or failed scenarios. They should also review error codes and rectify discrepancies to successfully generate the Production Token needed for going live .

The two main integration modes in the Digital Invoicing System are API Integration and Manual Invoice Generation. API Integration allows for automated real-time invoice submission, providing a seamless process that reduces manual input and the potential for errors . On the other hand, Manual Invoice Generation involves entering invoices manually, which offers limited functionality compared to the automated approach .

IP Whitelisting is a security measure that ensures secure communication between the taxpayer's systems and PRAL's servers by allowing only specified IP addresses to connect . This step is necessary as it not only enhances security by preventing unauthorized access but also enables system communication integrity. For secure data transmission, taxpayers must provide hosting server details and specify up to three IP addresses or submit a file with multiple IPs . Given the sensitivity of financial data, IP Whitelisting plays an essential role in protecting system communications within the Digital Invoicing System.

To handle API response errors effectively, taxpayers should first refer to the detailed error code tables for Sales and Purchase Errors, which include descriptions and resolution suggestions for each error . Understanding these codes allows taxpayers to diagnose and rectify issues systematically. Taxpayers should also ensure their JSON data follows the correct structure, checking for specific errors within the nested invoiceStatuses array for line-item issues . By adhering to these steps and validating their JSON format, taxpayers can efficiently troubleshoot and resolve errors in the digital invoicing process.

Submitting scenario-based test invoices in the Sandbox Environment helps ensure that the integration works correctly by replicating real-world business activities . Taxpayers must submit invoices matching their Business Nature and Sector, which allows them to test the system's response to their specific transaction types . Successfully completing these scenarios validates the system's readiness and generates a Production Token, enabling taxpayers to transition to the Production Environment confidently . This thorough testing reduces the risk of errors and provides assurance before real-time operations commence.

The Digital Invoicing System offers several benefits that enhance both compliance and efficiency for taxpayers. These benefits include real-time invoice submission and validation, which streamlines the invoicing process and leads to timely tax reporting. Automated tax calculations reduce human error, ensuring accurate tax liability computations . Furthermore, integration with ERP systems facilitates efficient data handling and reduces the likelihood of manual errors, thereby improving overall compliance. Additionally, the system automatically populates invoices in Annexure C and Sales Tax Returns, simplifying the tax filing process .

If an incorrect Unit of Measurement (UOM) is used in invoices, it can lead to errors such as 'Invalid UOM' during submission, disrupting the invoice processing and resulting in potential delays . To resolve this, taxpayers should ensure their UOM values are case-sensitive and conform to the standards specified by the system, using correct values like 'KG' instead of 'kg' . They should also verify the correct UOM from the Reference API to ensure compatibility . These steps help maintain data accuracy and compliance with system requirements.

An 'Unauthorized token' error indicates that the security token used in API requests is either invalid or expired, disrupting secure communications and preventing successful API operations . This issue can be addressed by ensuring the appropriate token for the operational environment (Sandbox or Production) is in use. Taxpayers should verify that the token matches the intended environment and is placed correctly in the API request header as 'Authorization: Bearer <Your_Valid_Token>' . Effectively managing tokens mitigates unauthorized access issues and facilitates smooth transaction processing.

To access the Sandbox Environment in the Digital Invoicing System, taxpayers must first have their IP whitelisting approved. Once approved, they can navigate to the Sandbox Environment tab to view Web API details, access sample JSON formats and code snippets, and submit scenario-based test invoices . The Sandbox Environment is crucial as it allows taxpayers to simulate invoice submissions and ensure their integration functions correctly before going live. This testing helps avoid potential issues in the Production Environment .

To register for the Digital Invoicing System through PRAL, taxpayers must submit technical details like contact and ERP details, provide IP whitelisting information, and complete scenarios in the Sandbox environment based on their business activity . These registration requirements ensure secure system integration by verifying the taxpayer’s technical readiness and validating compatibility through testing scenarios . Completing these steps not only confirms the secure communication parameters with PRAL servers but also assures correct functional integrations suited to the taxpayer’s specific business operations.

You might also like