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.3
Author Muhammad Umair Siddique
Status Issued
Reviewer(s) Mehboob Ur Rehman
Review Date 05-Apr-25
Updated By Muhammad Umair Siddique
Updated Date 24-May-25
Approver
Issue Date 05-April-25
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.
Review History
Sr. # Reviewer R/V Date Remarks
1. Mehboob Ur Rehman 05-Apr-25 Initial Document
2. Arslan Nazir 03-Jun-25 Screens Update, Enhancements & CRM
Focused solely on the taxpayer
3. Mehboob Ur Rehman 05-Jun-25
registration process and CRM.
4.
Document Number:1.0 PRAL © 2025 – All rights reserved Page 2 of 15
Digital Invoicing User Manual
Table of Contents
Introduction ........................................................................................................................... 4
Objective ............................................................................................................................... 4
Scope of the Document.......................................................................................................... 4
Digital Invoicing User Manual ................................................................................................. 5
Taxpayer’s Registration Process ......................................................................................................... 5
IF “Proceed with PRAL as Licensed Integrator” ............................................................................. 7
IF “Proceed with Other Licensed Integrator” .............................................................................. 11
DI CRM Manual: ................................................................................................................... 13
Document Number:1.0 PRAL © 2025 – All rights reserved Page 3 of 15
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 Number:1.0 PRAL © 2025 – All rights reserved Page 4 of 15
Digital Invoicing User Manual
Digital Invoicing User Manual
Taxpayer’s Registration Process
1. Log In
• Access the IRIS portal using the designated link by 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 Number:1.0 PRAL © 2025 – All rights reserved Page 5 of 15
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
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 Number:1.0 PRAL © 2025 – All rights reserved Page 6 of 15
Digital Invoicing User Manual
IF “Proceed with PRAL as Licensed Integrator”
o Select “Proceed with PRAL as Licensed Integrator” and click the “Submit” button.
Technical Details:
o Provide Technical Details and click on Next button.
▪ Technical Contact Person
▪ Technical Contact Mobile
▪ Technical Contact Email
▪ ERP/System Provider
▪ Software Type (Cloud/On Premises)
▪ Software Version
▪ CRM User ID for Authorized Person (Email that will be used to register
complaint or seek support at our “Customer Relationship Management”.
▪ CRM Password
o Specify Business Types (for Sandbox Testing Only)
▪ Business Nature (Multiple Can be Selected)
▪ Sector (Select One Only)
o Click on “Next” button.
Document Number:1.0 PRAL © 2025 – All rights reserved Page 7 of 15
Digital Invoicing User Manual
IP Whitelisting:
o Enter IP Whitelisting details.
▪ Hosting Server Company Name
▪ Hosting Server Country
▪ IP Address (minimum 1 and maximum 3)
OR
o Upload file for multiple IPs
▪ Click the Download Sample File Link.
▪ Fill details and upload.
▪ File type must be xls with up to 1 MB size.
o The IPs detail will be displayed in below table:
o By clicking the “Submit” button, the application will be successfully submitted to
PRAL. The PRAL Data Centre will accept or reject the IPs submitted by the taxpayer
within 2 working hours. This will automatically initiate Sandbox testing.
Document Number:1.0 PRAL © 2025 – All rights reserved Page 8 of 15
Digital Invoicing User Manual
Sandbox Environment:
o Click on Sandbox Environment to view below information to complete integration
for testing:
▪ View Web API Details
▪ View Sample JSON Format
▪ View Sample Code
o Upon completing the integration in the Sandbox Environment, the taxpayer must
submit scenario-based invoices that align with the selected combination of “Business
Nature” and “Sector” as specified in the Technical Details section.
o To begin, use the Sandbox Environment token to get access to the available JSON
invoice data. After you’re authorized, post each invoice JSON according to the specific
scenario explained in the Technical Document. Each time you submit an invoice, the
system will give you a unique Invoice Number.
o When a test invoice is successfully submitted, the system will automatically generate
a Production Token.
Document Number:1.0 PRAL © 2025 – All rights reserved Page 9 of 15
Digital Invoicing User Manual
Production Environment:
o Click on Production Environment to view below details:
▪ View Production API Details
▪ View Security Token
o Use the aforementioned information to complete integration on Production and
start transmitting invoices in real time.
Note: Once you’ve successfully submitted all the required test invoices for every relevant sector and
business type, the system will generate the final Production Token for you.
Document Number:1.0 PRAL © 2025 – All rights reserved Page 10 of 15
Digital Invoicing User Manual
IF “Proceed with Other Licensed Integrator”
o Select “Proceed with Other as Licensed Integrator”, choose the desired license
integrator from drop down list and click on “Submit” button.
o Click on Submit button to navigate on “API Integration” Screen.
Technical Details:
o Provide Technical Details.
o After the acceptance of application by the chosen Licensed Integrator, remaining
menu links (under API Integration Tab) will be available.
Note: The rest of the process remains the same as explained in “Proceed with PRAL as Licensed
Integrator”. However, In case of an LI other than PRAL, PRAL does not perform IP whitelisting for
taxpayers.
Document Number:1.0 PRAL © 2025 – All rights reserved Page 11 of 15
Digital Invoicing User Manual
3. Invoice Dashboard
Navigate to the Invoice Dashboard. In the Summary Dashboard, invoices from a selected
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
o In the invoice search, you can find invoices by selecting the time period and invoice
type and export in pdf.
Document Number:1.0 PRAL © 2025 – All rights reserved Page 12 of 15
Digital Invoicing User Manual
DI CRM Manual:
In Order to seek help and support for issues during integration and post integration, the Taxpayer and
License Integrators will use the “Customer Relationship Management” (CRM) for Digital Invoicing.
1. Log In
o Navigate to the ECRM portal.
o Select the relevant radio button.
▪ License Integrators will select IRIS
(Login by Entering registration number and Password)
▪ Taxpayer will select DI-Support
(Login by entering DI registered email ID and Password)
o Log in by entering your credentials and click on “Submit” button.
(Note: After 5 unsuccessful attempts, ID will be Blocked)
Note: A taxpayer can log in using either IRIS or the DI Support option. If he wants to log in himself, he
can use the IRIS option. If he wants to authorize a person (as mentioned in the technical details
screen), the login should be done through the DI Support option.
o Upon successful login, you will be directed to the main dashboard, which displays the Case
List and provides the option to create New Case.
o Cases can be searched by their case number or title.
o To view details of an existing case, simply click the “View” icon next to the case entry.
Document Number:1.0 PRAL © 2025 – All rights reserved Page 13 of 15
Digital Invoicing User Manual
2. New Case
o To enter a new case, click on '+ New Case' on the main dashboard.
FOR LICENSE INTEGRATOR FOR TAXPAYER
The fields marked with * are mandatory
o In case of LI, enter Client Register No. /Name and all the locked details will be auto selected.
o “Case Number” will be assigned by the system.
o Person type “License Integrator” or “Taxpayer” will be auto fetched at the time of login as
per user type selection (IRIS/DI-Support)
o Client Name (In case of LI) auto populated and cannot be changed.
o Select the Priority Type from the drop-down list. (Mandatory)
▪ High
▪ Normal
▪ Low
o Select the Query Type from the drop-down list. (Mandatory)
▪ Integration
▪ Post Integration
Document Number:1.0 PRAL © 2025 – All rights reserved Page 14 of 15
Digital Invoicing User Manual
o Select the Title. (Mandatory)
o Email auto populated and cannot be changed. (Mandatory)
o Describe the issue in Description (Mandatory)
o Click the “Save” button.
3. Attachments
o Once the case is saved, attachments can be added, removed, viewed, and downloaded.
o Attachments should be in PDF format and must not exceed a file size of 5MB
4. Correspondence
o Any additional information or correspondence can be added under the correspondence
section.
Document Number:1.0 PRAL © 2025 – All rights reserved Page 15 of 15
