Skip to content

GovTech · Fiscalisation

F.I.R.S.: automated VAT reporting and collection in Nigeria

A platform where POS systems report every bill in real time and VAT is collected automatically each month: a merchant portal, a tax officer portal and a secure bill API, integrated with the national tax systems.

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.

vat.portal / October

Bills reported

184,302

VAT due

₦41.8m

Collected

96%

Lekki Foods Ltd₦2.41mClosed
Ikeja Retail Co₦1.18mPaying
Abuja Grill₦0.37mPending

Stack

Technologyunder the hood.

  • PHP
  • Yii2
  • MySQL
  • OAuth2
  • REST API
  • Swagger
  • Remita
  • Cron workers
  • Deployer

Have something to build? Let's talk.

Tell us what you're working on. You'll hear back within one business day.