Configure and Test FBR POS Integration
How to Configure and Test FBR POS Integration in Muhasib ERP
Overview
This guide will help you configure FBR POS identifiers and successfully validate a representative sandbox sale.
Muhasib stores the local sale and FBR response according to the connector path; acceptance must be verified from the response.
Who can do this
You need access to FBR/tax settings, terminal/location, item/customer tax, and POS sale permissions.
Before you start
Complete tax-integration preparation and get approved sandbox endpoint, token/credentials, POS/branch IDs, scenarios, and test data.
Where to find it
Back Office → tax/global/terminal settings, then POS Sale.
Configure and Test FBR POS Integration
Step 1: Record current non-secret settings
Step 2: Enter approved sandbox endpoint and protected credentials
Step 3: Map company, branch, terminal/POS, invoice, tax, item, unit, and customer
Map company, branch, terminal/POS, invoice, tax, item, unit, and customer identifiers.
Step 4: Create a controlled sale representing an approved scenario
Step 5: Submit once
Step 6: Capture FBR request/reference, response code/message, assigned number/QR where returned, and
Capture FBR request/reference, response code/message, assigned number/QR where returned, and local status.
Step 7: Reconcile tax and totals
Check your work
One local test invoice maps to one accepted FBR reference and all quantities, taxable values, rates, taxes, and totals agree.
If something goes wrong
- Do not retry a timeout before checking FBR status by reference.
- Resolve invalid registration, item, unit, tax, or scenario mappings at source.
Related guides
- Prepare Muhasib for Tax Integration
- Submit and Verify a Tax-Integrated Sale
- Recover from Tax Submission Failure