How does retail software integrate a tax API?
Each checkout builds an invoice with per-item HS codes and tax and POSTs it to the tax API. Retail goods route to FBR; any service lines route to the relevant province. The gateway returns a fiscal number and QR for the receipt, and plans scale to high monthly volume.
Checkout-to-receipt flow
Cashier scans items
↓
Build invoice with HS codes
↓
POST to TaxBridge
↓
Route to FBR / province
↓
Fiscal number + QR
↓
Receipt prints
Implementation steps
Attach HS codes
Ensure each item carries its HS/PCT code and correct tax.
Route goods to FBR
Set the authority to FBR for goods; services route to the province.
Scale the plan
Pick a plan sized for your monthly invoice volume and request rate.
Keep retries safe
Idempotency keys keep high-volume retries from double-filing.
Chains and supermarkets
Multi-branch retail runs under one account with isolated per-branch quota. See the retail POS integration page and pricing.
Frequently asked questions
Do retail goods go to FBR?
Yes — sales tax on goods is federal (FBR); service lines go to the province.
Can it handle supermarket volume?
Yes — plans reach up to 10,000 invoices per month on the Custom plan at 120 requests per minute.
Where do HS codes come from?
From your item catalogue; each line carries its HS/PCT code so the correct tax applies.