PRAL FBR Extension
Table of Contents
Overview
This guide will walk you through integrating the PRAL FBR Extension with your Manager.io application. The extension enables seamless submission of invoices to Pakistan's Federal Board of Revenue (FBR) system directly from Manager.io.
Key Features
- Direct invoice submission to FBR from Manager.io
- Support for both Sandbox and Production environments
- Automatic custom field generation
- QR code generation for compliance
- Real-time validation and error handling
Before requesting your security token, you'll need the FBR Extension IP address for whitelist registration.
The IP address below must be registered in the IP Whitelist when requesting your Security Token from PRAL.
Steps to get your token:
- Visit the PRAL FBR Portal and register your business
- During token request, provide the IP address shown above for whitelist registration
-
Choose your desired environment:
- Sandbox - For testing and development
- Production - For live server operations
- Save the security token provided by PRAL securely
Configure the extension in your Manager application following these steps:
- Open your Manager Business Data
- Navigate to Settings → Extensions
- Click Create New Extension
- Configure the extension settings as shown below:
Sources: Url
Endpoint: Loading...
Placement: sales-invoice-view
Leave Inactive unchecked
Ensure the extension server is running on the specified endpoint before adding it to Manager.
Complete the integration setup within Manager.io through the following substeps:
- In Manager, open the Sales tab
- Create a new Invoice and save it
- Display the Invoice View
- Open the FBR - Extension tab below the Invoice View
- You will see the setup page as shown below:
Click the [Generate Custom Fields] button:
- This button creates all required Custom Fields for the integration
- Custom fields will be automatically added to your Manager database
- Wait for the success confirmation message
Complete the "Business Setup Configuration" form with your information:
- Business Name - Your registered business name
- NTN/CNIC - Your tax identification number
- Province - Select your business province
- Address - Complete business address
- Environment - Choose Sandbox or Production (must match your token)
- Bearer Token - Enter the security token from PRAL
Click [Validate Token & Update Business Details] button:
- This tests your token against the FBR server
- Ensure the Environment selection matches your token type
- If validation succeeds, data will be saved to Business Details
- The extension is now ready to submit invoices to FBR
Once setup is complete, you can submit invoices to FBR directly from Manager using this extension.
Support & Resources
Troubleshooting
If you encounter issues during integration, check the following:
- ......
- ......