Invoice Validation Errors in Nigeria: Causes & Fixes
The most common reasons NRS rejects e-invoices — invalid TINs, missing fields, tax mismatches, and malformed UBL structure — and exactly how to fix each one.
A rejected e-invoice isn’t just an inconvenience — it means no IRN, no valid VAT input claim for your buyer, and a delay while you diagnose and fix the problem. Most rejections come down to a small set of recurring causes. Here’s what they are and how to resolve each one.
Why Validation Exists
Before NRS issues an IRN, your invoice is checked against a set of schema and business rules — mandatory fields, tax math, identifier quality, and structural conformance to the Peppol BIS Billing 3.0 format. This validation step is what makes e-invoicing trustworthy: it catches errors before they become compliance problems, rather than after a dispute or audit.
The Four Most Common Causes of Rejection
1. Invalid or Unverified TIN
The problem: The supplier’s or buyer’s Tax Identification Number is mistyped, belongs to an inactive registration, or was never verified.
The fix: Verify every new customer or supplier’s TIN before your first transaction with them, using the NRS TIN verification portal, the *7182# USSD code, or automated verification built into your invoicing software. See our TIN verification guide for the full walkthrough.
2. Missing Mandatory Fields
The problem: A required element — IRN, QR code, digital signature, buyer TIN on a B2B invoice, or a UBL field like tax category — is absent from the payload.
The fix: Use software that enforces mandatory fields at the point of invoice creation rather than after submission, so a missing field blocks you from generating the invoice at all instead of surfacing as a rejection later.
3. Tax Computation Mismatches
The problem: VAT calculated at the wrong rate, or line-item VAT that doesn’t sum to the invoice total.
The fix: Apply Nigeria’s standard 7.5% VAT rate consistently (except for exempt or zero-rated goods, which should be clearly marked as such rather than omitted), and let your software calculate totals automatically rather than entering them manually.
4. Malformed UBL/XML Structure
The problem: The invoice payload doesn’t conform to the Peppol BIS Billing 3.0 schema — often from a hand-built integration or a legacy system adapted for e-invoicing without full schema support.
The fix: Use a platform that generates UBL natively rather than one retrofitted to produce it. See our UBL/XML invoice format guide for what the schema actually requires.
Reading a Validation Error Message
When an invoice is rejected, you should receive a specific error indicating what failed — not just a generic “rejected” status. A well-built platform surfaces the exact field and rule that failed (for example: “buyer TIN not found” or “VAT total mismatch on line 3”) so you can correct and resubmit without guessing.
Fixing and Resubmitting
A rejected invoice never received an IRN, so it isn’t yet a compliance record — you can correct the underlying issue and resubmit under the same invoice number. This is different from correcting an invoice that already has a valid IRN: once an IRN is issued, you can’t edit that record directly. Corrections at that point go through a credit note or debit note instead. See our guide to credit notes and debit notes in e-invoicing for how that process works.
Preventing Validation Errors Before They Happen
- Verify TINs proactively — don’t wait for a rejection to discover a TIN is invalid
- Use real-time validation — software that checks your invoice before submission catches errors in seconds instead of after a rejection
- Keep classification codes current — UNSPSC/HS codes and tax categories should be reviewed periodically, not set once and forgotten
- Test before scaling — send test invoices when onboarding a new product line, customer segment, or ERP integration, rather than discovering schema issues at volume
Validate Before You Submit
ZUTAX validates every invoice in real time — TIN checks, tax math, and UBL schema conformance — before it’s ever submitted, so rejections get caught in seconds instead of after the fact. Start your free trial and stop guessing why invoices bounce.
Ready to simplify your e-invoicing?
Join hundreds of Nigerian businesses using ZUTAX for compliant invoicing.