QuickBillCalculate exposure →
Q
QuickBill · NRS System Map
View as— Cash, exposure, EBITDA hit
Built to actually be understood

Nigeria's NRS e-invoicing system — the way a commercial operator needs to see it.

A re-cut of the official architecture, restructured so every flow, stakeholder, integration path and penalty is one click away. Built by someone preparing to sell this category for DigiTax — not by a diagramming tool.

Walk me through an invoice →What's the cost of waiting?
Mandatory fields
55
Day-1 penalty
₦1M
Tier-1 live since
Aug 2025
Markets
KE · NG · ZM
01 · Players

Who is in the room

Click any card to expand. Color-coded by layer.

NRS-accredited service providers
Live snapshot of mbs.gov.ng — the full field DigiTax sells against.
53 shown
02 · The clearance loop

What happens to every invoice

Auto-plays. Click a step to dwell on it. Use ← / → to step.

Live traceStep 1 / 6
Seller system
Generate

UBL/XML invoice built with all 55 mandatory fields inside the seller's ERP, dashboard or POS.

SellerDigiTaxNRS MBSBuyer APP
CFOEvery step that fails is unbilled revenue and denied VAT credit.
03 · Transaction types

Three flavors, three rulebooks

B2B · Pre-clearance

Business → Business

  • IRN issued BEFORE delivery
  • Enables buyer VAT input credit
  • Strictest format requirements
  • Highest DigiTax revenue per client
04 · Payload anatomy

What an invoice actually looks like on the wire

A live JSON sample. Click any field to see its rule and why it matters.

POST /v2/invoicesContent-Type: application/json
{
  "irn": "NG-2026-04A8F2C1",
  "csid": "9b3a…f47e",
  "issueDate": "2026-06-13T09:42:11+01:00",
  "currency": "NGN",
  "seller.tin": "01234567-0001",
  "buyer.tin": "09876543-0001",
  "lines[0].sku": "WIDGET-A1",
  "lines[0].qty": 10,
  "lines[0].unitPrice": 50000,
  "lines[0].vatRate": 0.075,
  "subtotal": 500000,
  "vatTotal": 37500,
  "grandTotal": 537500,
  "qrPayload": "https://verify.nrs.gov.ng/q/NG-2026-04A8F2C1"
}
stamp
irn
= NG-2026-04A8F2C1

Invoice Reference Number. Issued by NRS at clearance. Without this, the invoice is not legal.

Click any field token or JSON key above to inspect. 14 of the 55 mandatory UBL fields shown.
05 · Validation rules

The 12 reasons NRS rejects an invoice

The ones DigiTax's pre-flight catches before NRS ever sees them. Click for remediation.

06 · Invoice simulator

Play a transaction end-to-end

Pick a transaction type, inject a failure, watch how DigiTax handles it.

Transaction
Inject failure
  1. 01
    Seller emits
    Seller ERP / POS
  2. 02
    DigiTax pre-flight
    DigiTax APP
  3. 03
    NRS MBS validates
    NRS MBS
  4. 04
    NRS stamps IRN + CSID
    NRS MBS
  5. 05
    Buyer APP delivery
    Buyer APP
  6. 06
    Archive both sides
    DigiTax + parties
Transaction profile
B2BPre-clearance required. Buyer needs IRN for VAT input credit.
Outcome
Press play to trace this invoice.
07 · How clients connect

Four integration paths into DigiTax

The path you sell determines time-to-live, deal size and stickiness.

01
Dashboard
Web portal

Login, paste or upload CSV, fiscalise. Zero engineering required.

Time-to-liveHours
Best forSME, ops teams
02
REST API
JWT auth

Direct system-to-system. OpenAPI / Swagger. Full automation.

Time-to-live1–2 weeks
Best forFintech, dev teams
03
ERP plugins
SAP · Oracle · Dynamics · Sage · Odoo · QB

Native connectors that intercept invoices at the source of truth.

Time-to-live1–4 weeks
Best forEnterprises
04
POS app
Mobile / tablet

Auto-fiscalise B2C receipts at the counter with QR print.

Time-to-liveSame day
Best forRetail, petrol, F&B
05
Sandbox
Free test env

Full mirror of production for proof-of-concept and integration.

Time-to-liveInstant
Best forPre-sales, devs
08 · Decision tree

Which path should this prospect take?

Answer four questions — get a recommendation and a sales motion.

Monthly invoice volume?
Recommended path
Answer the questions to get a recommendation.
09 · The rollout wave

Compliance tiers & enforcement timeline

Where each cohort sits today.

!

Large taxpayers

Turnover > ₦5bn
LIVE — penalty clock running
Go-live
Aug 2025
Enforce
Apr 2026
→

Medium taxpayers

Turnover ₦1–5bn
Imminent
Go-live
Jul 2026
Enforce
Jan 2027
·

Emerging taxpayers

Turnover < ₦1bn
Pipeline
Go-live
Jul 2027
Enforce
Jan 2028
10 · The stick

What non-compliance actually costs

Move the slider — or load a scenario — and feel the deal urgency.

Load a scenario

Penalties stack: day-1 fine + daily fine + per-invoice fine + 100% VAT input denial. Source: NRS enforcement framework summarised in the architecture brief.

Exposure
₦221.3m
Cumulative cost of waiting.
Day-1 fine₦1.0m
Daily fine × 29 days₦290k
Per-invoice × 500₦100.0m
VAT input credit denied₦120.0m
Commercial framing: A ₦1bn DigiTax subscription is rounding error against this number. That's the pitch.
CFOThis is a P&L line item. Subscription cost ÷ this number = your pitch.
11 · The role

What I'd own at DigiTax — and what I'd ask

Mapping this architecture to the role I'm interviewing for.

What I'd own at DigiTax

Mapping the architecture's arrows to role accountabilities.

Seller → DigiTax
Onboarding, sandbox-to-prod conversion, ERP plugin selection.
DigiTax → NRS MBS
Throughput SLA, validation pre-flight, downtime comms.
NRS → DigiTax (IRN + CSID)
Reject-rate dashboards, root-cause loops with tax team.
DigiTax → Buyer APP
Interop with the other 52 APPs, dispute escalation.
Both sides → Archive
7-year retention, audit-pull SLA, evidence packaging.

Open questions & risks I'd raise in week one

Not gotchas — material commercial and operational unknowns.

▸Multi-APP interop — how do invoices flow when seller is on DigiTax and buyer is on a competitor APP?
PEPPOL 4-corner spec covers it, but reality is messy. Who eats the dispute?
▸Offline POS reconciliation — petrol, FMCG, rural retail can't assume connectivity. Where does liability sit when sync window is missed?
DigiTax's POS spec implies provisional QR — needs clear contractual SLA.
▸B2C threshold — is there a value floor below which B2C reporting is waived? Different from how Kenya runs it.
Open question. Check NRS circulars 2025–26.
▸Rejection loops — what's the SLA for fixing a TIN_NOT_FOUND when buyer is unreachable?
Affects DSO. Selling point: DigiTax pre-flight catches 80%+ before NRS sees them.
▸Fines on the APP vs the taxpayer — when DigiTax submits a malformed payload, who pays?
Contractual. APP indemnity is the moat — and the risk.

Questions I'd ask the interview panel

  1. Q01What's DigiTax's first-pass reject rate vs the NRS-wide baseline today?
  2. Q02Top 3 reasons large taxpayers churned from a competitor APP to DigiTax in the last 12 months?
  3. Q03What does the customer success motion look like for enterprise (named CSM? pooled?) and what's the renewal trigger event?
  4. Q04Pricing model — per-invoice, flat MRR, hybrid? Where's the margin actually made?
  5. Q05When MBS goes down, what's the playbook — own status page, queue depth, customer comms?
  6. Q06Internal view on Interswitch / Remita as APP competition — do they win on distribution or lose on enterprise depth?
  7. Q07How is the SI side of the business resourced — pre-sales solution architects vs delivery PMs?
  8. Q08What does 'good' look like for this role at 90 days, 6 months, 12 months?

How this atlas maps to the JD

Domain depth
This atlas. The diagram, the simulator, the validation rules — all internalised before day one.
Commercial framing
Penalty calc + tier urgency overlay. Sells the why-now, not the what.
Cross-functional fluency
Persona switcher — same architecture seen through CFO, IT, Tax and Auditor lenses.
Field readiness
Integration decision tree — turns a discovery call into a recommendation in 60 seconds.
Source diagram: NRS e-invoicing full system architecture — DigiTax perspective. Re-cut for interactive use.
digitax.tech · interactive build