Everything You Need to Know About the FBR Digital Invoicing Platform
This visual guide walks through every single screen, button, fiscal calculation, and API workflow. Use the interactive mockups below with numbered pins ① to understand how each feature functions in practice.
Hierarchical Multi-Tenancy & Company Workspace Switching
The platform supports a 4-tier hierarchical enterprise structure designed for conglomerates, accounting firms, and multi-branch retailers.
Returns the operator instantly to their home organisation level without logging out.
Select any client company, subsidiary, or physical POS outlet. All invoices, buyers, items, and quotas instantly scope to this entity.
Role-Based Access Control: Company Admin vs. Client / Branch
The platform enforces granular role segregation across multi-entity hierarchies, distinguishing between master corporate governance and localized point-of-sale execution.
Company Admin (Master Company)
Corporate Governance & Multi-Entity MasterAssigned to headquarters management and parent holding entities. Company Admins possess overarching authority across the parent company and all affiliated child branches.
- ✓ Sub-Client & Branch Creation: Spawn child branches, POS stations, and subsidiaries up to the allotted subclient limit.
- ✓ Quota Management: Administer shared enterprise invoice pools or allocate dedicated quotas per branch.
- ✓ Master Company Conversion: Convert standalone company profiles into Master Companies directly.
- ✓ Cross-Entity Operations: Seamlessly switch context between outlets to view unified sales, buyers, items, and audit trails.
Client / Branch User
Point-of-Sale Cashier & Local OperatorAssigned to physical branch operators, cashiers, or single-store merchants. Scoped strictly to their designated store or POS station.
- ✓ Sales Invoicing: Create, validate, and certify digital sales tax invoices with live FBR QR codes.
- ✓ Local Directory: Search registered buyers, ATL status verification, and product catalog lookups.
- ✕ Restricted Hierarchy: Cannot create unauthorized sub-clients or reassign corporate parent relationships.
- ✕ Isolated Data Scope: Prevented from accessing peer branch financial transactions or unassigned company workspaces.
Company Registration & Sub-Entities / Branching Controls
When registering a client company (/clients/create), administrators configure the organizational architecture, sub-entity authorization, and quota limits.
Controls whether this business entity can create child branches, physical store outlets, POS terminals, and sub-clients.
Enables the company admin and organization staff to manage sub-clients under this account.
Hard cap enforcing maximum child entities to prevent plan quota abuse.
Child branches automatically share the master quota or can be restricted to individual monthly caps.
Structure & Hierarchy Management Actions
From the Company Profile screen (/clients/{client}), administrators can restructure company hierarchies, convert accounts, add branches, and reassign parent entities with automated onward commission routing.
Upgrades standalone clients to Master Companies with branch creation capabilities and customizable subclient limits.
POST /clients/{id}/convert-masterCreates branch outlets, POS stations, or subsidiaries under the master company with inherited FBR tokens and shared quotas.
POST /clients/{id}/subclientsReassigns branch entities across parent companies, detaches sub-clients to standalone, and manages referral partner commissions.
/clients/{id}/move-hierarchyWhen transferring companies across hierarchy structures, administrators select how partner commissions route:
Invoice Creator & FBR Certification Gateway
The Invoice Creator (/invoices/create) allows operators to prepare digital sales tax invoices compliant with SRO 350(I)/2024 and PRAL digital invoicing standards.
Automatically suggested by your Numbering Engine with zero-collision row locks.
Switches between Sale Invoices, Credit Notes, Debit Notes, and Advance Invoices.
Queries PRAL Iris by NTN/CNIC to fill business name, STRN, ATL status, and province automatically.
Line Items Engine, PCT Code Search & Advance Taxes
The platform computes sales tax (18%), extra tax, further tax (for non-ATL buyers), FED, and withholding advance income taxes (Sections 236CB and 236H) automatically.
| # | Product Description (Auto-Suggest) | HS / PCT Code | Qty | Price (PKR) | Tax | Line Total |
|---|---|---|---|---|---|---|
| 1 | Pure Copper Electrical Cable (10mm) | 7408.1100 | 10 Meter | 1,450.00 | 18% ST | 17,110.00 |
Invoice Template Studio & Dynamic Numbering Engine
The Template Customizer (/invoices/template) lets you personalize PDF layouts, thermal POS receipts (80mm/58mm), custom typography, bank settlement cards, and tokenized invoice numbering.
Developer API, Swagger Sandbox & Webhooks
Integrate your ERP, SAP, Oracle, or POS systems directly via our authenticated REST API with OpenAPI 3.1 documentation and automated webhooks.
Enterprise Health & Liveness Probes
HTTP 200 HealthyAutomated monitoring probes designed for Kubernetes, AWS ALB, and uptime bots:
Liveness probe checking Database connection, Redis cache, and disk storage.
Readiness probe checking live PRAL FBR Gateway DNS and latency reachability.
Operator Productivity & Keyboard Shortcuts
Instant search across invoices, drafts, buyers, items, and clients from any screen.
Auto-fills legal name, STRN, ATL status, and province in ~80ms with zero typos.
Validate and certify hundreds of queued invoices with FBR in 1 click.