Digital Invoicing User Manual
Confidential Information: The information provided in this document is intended solely for the use of Digital
Invoicing. The contents of this document may not be reproduced or divulged outside the intended organizations
without the express written permission of PRAL.
PAKISTAN REVENUE AUTOMATION (PVT.) LTD
PRAL – Head office, Software Technology Park-III, Plot No. 156, Service Road (North), Industrial Area, I-9/3,
Islamabad. Pakistan
Digital Invoicing User Manual
Document Information
Category Information
Document User Manual
Project-Module Title Digital Invoicing User Manual
Version 1.0
Author Muhammad Umair Siddique
Status Issued
Reviewer(s) Mehboob ur Rehman
Review Date 05-April-2025
Updated By
Updated Date
Approver SPM Team
Issue Date 05-April-2025
Distribution SD Wing
Document Category Internal External
Privacy Level Public PRAL Confidential Customer Confidential
Disclaimer This document contains confidential information. Do not distribute this
document without prior approval from PRAL.
Document Version:1.0 PRAL © 2024 – All rights reserved Page 2 of 12
Digital Invoicing User Manual
Table of Contents
Introduction ........................................................................................................................... 4
Objective ............................................................................................................................... 4
Scope of the Document.......................................................................................................... 4
Digital Invoicing User Manual ................................................................................................. 5
Taxpayer’s End .................................................................................................................................... 5
IF “Proceed with PRAL as Licensed Integrator” ............................................................................. 7
IF “Proceed with Other Licensed Integrator” ................................................................................ 9
License Integrator’s End .................................................................................................................... 11
Document Version:1.0 PRAL © 2024 – All rights reserved Page 3 of 12
Digital Invoicing User Manual
Introduction
This document serves as a comprehensive guide for understanding and utilizing the Digital Invoicing
System developed by Pakistan Revenue Automation Limited (PRAL) for the Federal Board of Revenue
(FBR), Pakistan. The Digital Invoicing System is a pivotal step towards modernizing the taxation
process by streamlining invoice management and fostering compliance. It provides an integrated
platform for taxpayers, license integrators, and tax officers to collaborate effectively in managing
and validating digital invoices in accordance with FBR regulations.
Objective
To provide clear guidance on effectively using the Digital Invoicing System developed by PRAL for
FBR to streamline invoice management and ensure compliance with tax regulations.
Scope of the Document
This document provides detailed guidance on the following aspects of the Digital Invoicing System:
• Taxpayer Responsibilities:
o Submission and management of digital invoices.
o API integration.
• License Integrator Responsibilities:
o Reviewing taxpayer applications.
o Accepting or rejecting applications.
o Transitioning accepted applications to production for invoice management.
• System Functionalities:
o Real-time invoice management and viewing (daily, monthly, Quarterly and Yearly).
o Seamless integration with FBR’s broader taxation infrastructure.
Document Version:1.0 PRAL © 2024 – All rights reserved Page 4 of 12
Digital Invoicing User Manual
Digital Invoicing User Manual
Taxpayer’s End
1. Log In
• Access the IRIS portal by using the designated link and entering your Registration number
and Password. Upon logging in, you will be directed to the dashboard.
• Navigate to Digital Invoice by selecting the Digital Invoicing.
Document Version:1.0 PRAL © 2024 – All rights reserved Page 5 of 12
Digital Invoicing User Manual
1. Integration Mode
• You will land on the Integration Mode screen where two Modes can be seen: API Integration
and Manual Invoice Generation.
2. API Integration (PRAL)
Proceed to the API Integration tab and Choose Licensed Integrator. PRAL will Provide Free
of Cost Licensed Integrator Services along with Sandbox Testing, whereas Other Licensed
Integrators may charge certain fee.
Document Version:1.0 PRAL © 2024 – All rights reserved Page 6 of 12
Digital Invoicing User Manual
IF “Proceed with PRAL as Licensed Integrator”
o Select “Proceed with PRAL as Licensed Integrator” and click on Submit button.
o Provide Technical Details and click on Next button.
▪ Technical Contact Person
▪ Technical Contact Mobile
▪ Technical Contact Email
▪ ERP Provider
▪ Software Type
▪ Software version
o Enter IP Whitelisting details.
▪ Hosting Server Company Name
▪ Hosting Server Country
▪ IP Address
OR
o Upload file for multiple IPs
▪ Click on Download Sample File Link.
▪ Fill details and upload.
▪ File type must be xls with up to 1 MB size.
Document Version:1.0 PRAL © 2024 – All rights reserved Page 7 of 12
Digital Invoicing User Manual
o The IPs detail will be displayed in below table:
o By clicking on “Submit button” application will be submitted to PRAL successfully.
You need to wait for up to 2 days for approval.
o Click on Sandbox Environment to view below information to generate test invoices:
▪ View Web API Details
▪ View Sample JSON Format
▪ View Sample Code
o The LI (PRAL) will initiate the Sandbox Testing.
Document Version:1.0 PRAL © 2024 – All rights reserved Page 8 of 12
Digital Invoicing User Manual
o Click on Production Environment to view below details:
▪ View Production API Details
▪ View Security Token
IF “Proceed with Other Licensed Integrator”
o Select “Proceed with Other as Licensed Integrator” and chose license integrator
from drop down list.
o Click on Submit button to navigate on “API Integration” Screen.
o Provide Technical Details.
o After the acceptance of application by the chosen Licensed Integrator, remaining
menu links will be available.
Note: Rest of the process will remain same as explained in if proceed with PRAL as license Integrator.
Document Version:1.0 PRAL © 2024 – All rights reserved Page 9 of 12
Digital Invoicing User Manual
3. Invoice Dashboard
Navigate to Invoice Dashboard, in Summary Dashboard, the invoices from a certain Month
and year can be viewed.
o View real time invoice value graph data in four formats:
▪ Daily
▪ Monthly
▪ Quarterly
▪ Yearly
o The invoice value graph is available in three formats:
▪ Sale Invoice
▪ Debit Note
▪ Credit Note
o In search invoice you can find invoices by selecting time period and invoice type and
export in pdf.
Document Version:1.0 PRAL © 2024 – All rights reserved Page 10 of 12
Digital Invoicing User Manual
License Integrator’s End
1. Log In
Access the IRIS portal by using the designated link and entering your Registration number
and Password. Upon logging in, Navigate to Digital Invoicing. You will land on the inbox
where three major tabs can be seen: Request Received, Integration Status, and Invoice
Dashboard
2. Review Application
In the Request Received, the application of taxpayer will appear on your screen. You can
review technical details by selecting “Registration Number” or click on “View Details”.
3. Accept or Reject
Use the green tick buttons to Accept or red cross button to Reject the application.
4. Integration Status
In the Integration Status, click on registration number to view below details:
o Technical Details
o IP Details
o Sandbox Environment Details (API, Token Code)
o Production Environment Details (API, Token Code)
Document Version:1.0 PRAL © 2024 – All rights reserved Page 11 of 12
Digital Invoicing User Manual
5. Initiate Sandbox
In Sandbox Environment tab, click on initiate sandbox.
6. Production Environment Token Generation:
You can view API details and generate token by selecting “Production Environment Details
(API, Token, Code)” tab.
7. Invoice Dashboard
You can view summary dashboard and search invoices as explained in taxpayer’s end.
Document Version:1.0 PRAL © 2024 – All rights reserved Page 12 of 12
