The challenge
VAT that reports itself, bill by bill.
Collecting VAT from thousands of merchants by hand means late returns, estimates and missed revenue. The goal of F.I.R.S. VAT Automation was simple to state: every bill a merchant issues is reported the moment it is printed, and the VAT is collected automatically at the end of the month.
We built the platform in Nigeria’s tax context and have kept developing it since 2016, from the first bill API to the integrations with the national tax systems.
3
portals: merchants, tax officers, API
2016
in development since
48 h
deadline for a bill to be reported
What we built
Three portals on one platform.
Merchant portal
Sign-up with a live TIN check, company and business-place management, direct-debit mandates and a dashboard of reported bills.
Tax officer portal
Bills, companies, business places, mandates and collections in one back office, with roles for officers and tax professionals.
Bill reporting API
POS systems report every bill with its VAT lines over a REST API secured with OAuth2 and rate limiting.
Verifiable receipts
Each bill carries a security code, so anyone can check a receipt on the public portal.
Monthly collection
On the 5th of each month the platform totals each merchant’s VAT and collects it by direct debit or through Remita.
Full audit trail
Every request to and response from a payment provider is stored, alongside a separate audit log of mandates.
Integration
Connected to the national tax systems.
- Bills forwarded to TaxPro Max, the national tax administration system (since 2023)
- Invoices signed and validated through the national e-invoicing platform (2025)
- Queue workers with locking, so nothing is sent twice
- Logging per integration, for support and audits
More about the rules behind it in our article E-invoicing in Nigeria.
Bills reported
184,302
VAT due
₦41.8m
Collected
96%
| Lekki Foods Ltd | ₦2.41m | Closed |
| Ikeja Retail Co | ₦1.18m | Paying |
| Abuja Grill | ₦0.37m | Pending |
Stack
Technologyunder the hood.
- PHP
- Yii2
- MySQL
- OAuth2
- REST API
- Swagger
- Remita
- Cron workers
- Deployer