FIRS E-Invoicing Nigeria: BIS Billing 3.0 Compliance for SMEs

FIRS e-invoicing rollout: from voluntary to mandatory (2024-2026)

The Federal Inland Revenue Service (FIRS) launched its national e-invoicing programme in 2024, modelled on the international BIS Billing 3.0 standard coupled with UBL 2.1 syntax. The pilot opened on a voluntary basis to large taxpayers (turnover above NGN 25 billion), ahead of a phased rollout through 2025-2026 to medium-sized businesses (above NGN 5 billion), then SMEs, and ultimately the entire formal economy.

FIRS has chosen a clearance (pre-validation) model operated through a central platform known as the Merchant Buyer Solution (MBS). Every B2B invoice must be submitted to MBS before it is delivered to the buyer: the system verifies data integrity, validates both supplier and customer TIN, runs VAT and Withholding Tax checks, and returns an Invoice Reference Number (IRN) together with a signed QR seal. Without an IRN, the invoice carries no fiscal weight.

The choice of BIS Billing 3.0 and UBL 2.1 is no accident. This is precisely the technical foundation of PEPPOL, the European cross-border invoicing network. In practical terms, a FIRS-compliant Nigerian SME is technically ready to issue invoices to European counterparts and to any PEPPOL-aligned jurisdiction without major rework. For Nigerian exporters, this is a direct competitive edge.

The rollout calendar continues to evolve — FIRS publishes new milestones regularly through its official circulars and the TaxPro Max portal. Our pragmatic recommendation: do not wait for the cut-off date to start. Real-world onboarding (active TIN, API certificates, sandbox testing, team training) takes on average four to six weeks for a well-organised SME, and the queue at the MBS support desk grows fast as deadlines approach.

The Invoice Reference Number (IRN) and how it works

The IRN is the cornerstone of the FIRS system. It is a unique identifier assigned by the MBS server to every validated invoice. Here is the technical flow of a compliant Nigerian B2B issuance:

1. Invoice creation in the management software (CassKai, for example): customer, line items, currency (NGN or foreign currency + CBN rate), 7.5% VAT, applicable WHT, Stamp Duty where relevant.
2. Submission to MBS through the FIRS API in UBL 2.1 (XML) format. API credentials are issued by FIRS after TIN registration and signature of the usage agreement.
3. MBS-side validation: TIN checks (both parties must be registered), consistency controls (totals, rates), VAT and WHT rule validation.
4. IRN and QR return: MBS returns the unique invoice identifier, a cryptographically signed QR seal and a timestamp. These elements must appear on the final invoice sent to the buyer.
5. Distribution to the buyer: the invoice (PDF, XML, or both) is transmitted to the customer. The buyer can verify authenticity by scanning the QR (FIRS verification URL).
6. Cancellation window: the invoice can be cancelled via the API within 72 hours of issuance. Beyond this window, a credit note must be issued and follows the same MBS cycle.

On the UBL 2.1 side, here are the minimum structural fields required by FIRS on every B2B invoice:

Any inconsistency (unknown TIN, wrong total, unsupported VAT rate) returns an error code. An SME equipped with a certified software never sees these errors in production: controls are run upstream, on the software side, before the MBS submission even takes place.

VAT 7.5% Nigeria + Withholding Tax + Stamp Duty stacking

A major Nigerian specificity: on the same B2B invoice, several tax layers stack on top of each other. An SME that handles them manually risks errors, FIRS reassessments, and most importantly a blurred cash position. Here are the three layers to master.

1. Value Added Tax (VAT) 7.5%

• Single rate of 7.5% on the vast majority of standard goods and services (raised from 5% to 7.5% in 2020).
• No cascade effect: input VAT is recoverable for registered persons (input VAT credit).
• Exemptions: basic food, education, healthcare and medical, exports, financial services, books and newspapers.
• Mandatory TIN validation on both sides in B2B: an unregistered buyer blocks the transaction.

2. Withholding Tax (WHT)

Deducted at source by the buyer mostly on service invoices. The payer withholds the WHT and remits it directly to FIRS; the supplier receives the net amount, with a tax credit certificate to offset against future tax liabilities.

• 5%: standard B2B services (construction, transport, rental, routine technical services).
• 10%: professional services (consulting, audit, legal, medical, specialised engineering).
• 2.5%: building construction (specific reduced rate).
• No WHT on goods sales between VAT-registered traders — only on services.

3. Stamp Duty

• Rate: 0.375% on B2B invoices above NGN 10,000 (a low threshold that catches almost every professional invoice).
• Collected by the Federal Inland Revenue Service Stamp Duty Office.
• For electronic banking transactions above NGN 10,000, stamp duty is also applied on the bank side (NGN 50 flat) — distinct from invoice stamp duty.

Worked example: a consulting invoice of NGN 1,000,000 net issued to a Nigerian B2B buyer:

• VAT 7.5% = NGN 75,000
• Gross total = NGN 1,075,000
• WHT 10% (professional service) = NGN 100,000 withheld at source by the buyer
• Stamp Duty 0.375% = NGN 3,750
• The supplier receives: NGN 975,000 net in cash, plus a WHT certificate of NGN 100,000 to offset against the next annual Corporate Income Tax (CIT) liability.

Cash impact: DSO does not capture WHT — the supplier receives less cash than expected on day one, recovering later in the form of a tax credit. This is a classic trap for SMEs that do not master the mechanism. CassKai automatically models this stacking and feeds the treasury forecast with expected net flows rather than nominal invoice amounts.

CassKai FIRS integration via UBL 2.1

CassKai delivers a native FIRS integration for Nigerian SMEs, with an IFRS foundation tailored to the Nigerian chart of accounts and multi-city coverage across Lagos, Abuja and Port Harcourt. Here is what sets our approach apart.

IFRS-native architecture

• Nigerian chart of accounts aligned with Financial Reporting Council of Nigeria (FRC) standards, based on full IFRS for non-SME companies and IFRS for SMEs for eligible smaller entities.
• Statement of Financial Position, Statement of Comprehensive Income and Statement of Cash Flows directly exportable for FRC and CAMA filings.
• Native multi-companies: a group with several entities (Lagos HQ + Abuja subsidiary + Port Harcourt branch) consolidates into one view, without any Excel acrobatics.

Optimised MBS submission

• Bulk submission of up to 1,000 invoices per hour via the FIRS API without throttling. For wholesalers, distributors and e-commerce, this is the difference between fluid compliance and a serious bottleneck.
• Automatic MBS retry on network timeout, with a persistent queue and resume-from-checkpoint logic.
• Real-time reconciliation between IRN and internal invoice, end-to-end traceability for audits.
• Upstream buyer TIN validation: if the client is not FIRS-registered, CassKai blocks the issuance and alerts the salesperson, avoiding an MBS rejection downstream.

Standardised Nigeria onboarding

Our onboarding takes on average 14 business days for a single-site SME, 21 days for a multi-site group:

1. TIN verification (FIRS portal cross-check)
2. FIRS API credentials request via TaxPro Max
3. Lagos LIRS PAYE codes setup in parallel (or other state IRS depending on location)
4. PenCom registration verified (an active PIN is required for payroll)
5. NSITF code assigned
6. CassKai NG company setup (chart of accounts, NGN base currency, account mapping)
7. MBS sandbox: testing 50 invoices across different scenarios (B2B, B2C, exports, credit notes)
8. Progressive go-live (10% then 50% then 100% of the flow as validation completes)

Multi-currency and CBN rates

• Natively supported currencies: NGN (base), USD, EUR, GBP, ZAR.
• Central Bank of Nigeria (CBN) exchange rates fetched daily, no manual entry ever.
• For exporters invoicing in USD: automatic CBN conversion on the FIRS invoice, foreign exchange differences booked to gain/loss on FX as soon as the payment lands.
• For importers: CassKai cross-references the NEM (Form M / Form NXP) with the supplier invoice to verify customs/tax consistency.

PAYE annualised + PenCom + NSITF: the Nigerian payroll trifecta

Nigerian payroll stands out for three mechanisms that, when mishandled, generate massive variances and costly tax reassessments. Here is what you need to understand.

1. Annualised PAYE (Pay As You Earn)

Governed by the Personal Income Tax Act (PITA) as amended by the Finance Act 2023, Nigerian PAYE applies a progressive annual bracket from 7% to 24%. Major difference with most African countries: the tax is calculated on the projected annual income, then divided by 12 for the monthly withholding. There is no month-by-month calculation.

The PITA bracket:

Before the bracket applies, you deduct the Consolidated Relief Allowance (CRA):

CRA = MAX(NGN 200,000, 1% of annual gross) + 20% of annual gross

Then mandatory social contributions (employee PenCom, NHIS where applicable) are deducted. The result is the chargeable income on which the bracket is applied.

2. PenCom (Pension Reform Act 2014)

• 8% employee contribution, withheld on gross monthly pay.
• 10% employer contribution, for a combined contribution of 18% of gross.
• Mandatory remittance to a Pension Fund Administrator (PFA) accredited by PenCom, chosen by the employee.
• Contributions are tax-deductible from the PAYE base — hence the importance of integrating PenCom BEFORE the PAYE calculation.

3. NSITF (Nigeria Social Insurance Trust Fund)

• 1% of gross, employer-only.
• Covers workplace accidents and occupational diseases.
• Mandatory for any employer with five or more employees.
• Monthly remittance directly to NSITF.

Critical specificity: PAYE collected by state IRS, not FIRS

Unlike VAT and CIT (centralised at FIRS), PAYE is administered by each state IRS. Lagos = LIRS (Lagos State Internal Revenue Service), Akwa Ibom = LIRS-AK, Rivers = RIRS, FCT Abuja = FCT-IRS, and so on. 36 states plus the FCT = 37 portals and 37 potentially different calendars.

For a group with multi-state presence, this is an administrative headache and a major compliance risk. CassKai pre-maps the main state IRS portals (Lagos, FCT, Rivers, Kano, Oyo, Delta, Edo, Cross River, Akwa Ibom), with automatic generation of monthly declaration files in the format expected by each state.

Compliance roadmap Nigeria — 45 days

Here is the pragmatic roadmap to bring a Nigerian SME into full FIRS e-invoicing and payroll compliance in 45 days. Realistic if you start with a available finance team and a management sponsor.

Weeks 1-2 — Administrative prerequisites

• Active TIN verification on TaxPro Max (FIRS portal). If the TIN is dormant or unconfirmed, trigger the regularisation with the local Tax Office — this is blocker number one.
• Enrolment in the FIRS e-invoicing programme through TaxPro Max or the MBS portal depending on your category (large / medium / small).
• In parallel: LIRS (or local state IRS) registration to retrieve the employer PAYE codes. For Lagos: LIRS PAYE Code + Employer ID Card.
• PenCom: confirmation of an active company PIN. If you have not yet chosen a PFA for employees, this is the moment to centralise.
• NSITF: confirmation of the ECS (Employer Code System) registration and obtaining the compliance certificate.

Week 3 — CassKai NG setup

• Creation of the CassKai entity for Nigeria with IFRS chart of accounts (or IFRS for SMEs if eligible).
• NGN base currency parameterisation + activation of USD/EUR/GBP for export/import flows.
• Masterdata import: customers (with TIN), suppliers (with TIN), items, 7.5% VAT rates, WHT codes, Stamp Duty codes.
• Payroll configuration: PITA 2023 bracket, CRA, PenCom 8%/10%, NSITF 1%, LIRS codes.
• Mapping of accounts to FRC statements (Statement of Financial Position, Comprehensive Income, Cash Flows).

Weeks 4-5 — MBS sandbox and testing

• CassKai connection to the FIRS MBS sandbox with test credentials.
• Issuance of 50 test invoices covering all scenarios: B2B local NGN, B2B local USD, B2C, exports, credit notes, debit notes, invoices above NGN 10,000 (Stamp Duty), invoices with WHT.
• Manual validation of returned IRNs, QR code controls, generated PDF verification.
• Degraded mode testing: voluntary disconnection from the sandbox, verification that CassKai properly queues and retransmits upon reconnection.
• Team training: sales (invoice entry + TIN), accounting (IRN reconciliation), CFO/controller (compliance dashboard + cash dashboards).

Week 6 — Production go-live

• Switch from sandbox to production credentials on MBS.
• Progressive go-live: start with 10% of the flow (a subset of customers) on day D, scale up to 50% by D+3, 100% by D+7.
• Banking integration: connection to the main Nigerian banks (Zenith, GTBank, UBA, Access, First Bank) to automate payments and cash reconciliation.
• Activation of CassKai dashboards: Nigeria-specific DSO (with WHT impact), customer aging, 13-week treasury forecast, real-time MBS compliance.
• First full monthly close with FIRS filings (VAT, WHT), LIRS (PAYE), PenCom and NSITF directly from CassKai.

Beyond Day 45

Once compliance is secured, the focus shifts to cash steering. The priority indicators on Nigeria:

• Net DSO (post-WHT) per customer segment
• Exposed FX position (USD invoiced / NGN received)
• Available cash per bank (multiple banks are common to limit CBN concentration risk)
• Stock of WHT credits to offset against annual CIT — often neglected, can represent several months of locked cash