Frequently Asked Questions
Qorpy e-Invoicing Knowledge Base
Table of Contents
1. General Overview
The scheme automates the exchange of invoice data between corporate taxpayers and NRS. It ensures accurate VAT reporting, transparency, and reduces tax evasion through electronic validation of invoices.
All VAT-registered corporate entities, especially those engaged in cross-border trade or high-value domestic transactions (₦25M and above), must transmit invoices electronically to NRS.
Qucoon acts as an Access Point Provider (APP) and System Integrator (SI), enabling taxpayers to securely connect their ERP systems to NRS for real-time invoice submission and VAT automation.
2. Registration & Onboarding
Organizations can onboard via:
1.
2.
Completing the business enablement form typically completes within 2 minutes.
3. Invoice Lifecycle & Compliance
Non-electronic invoices are non-compliant and may attract penalties, including denial of VAT input claims or fines.
4. Operational Questions
Yes — SAP, Oracle JD Edwards, Microsoft Dynamics, Tally Prime Gold and other systems can integrate seamlessly through Qucoon’s APP/SI layer.
Through credit or debit notes, each referencing the original invoice’s IRN.
NRS automatically converts foreign currency values to NGN using the CBN exchange rate of the invoice date.
5. Policy & Legal Framework
The Finance Act (as amended) and VAT (Modification) Order 2021 empower NRS to enforce electronic reporting of taxable transactions.
Yes. Non-resident suppliers with Nigerian transactions must also report via APPs or authorized local representatives.
NRS requires APPs to use end-to-end encryption (TLS 1.2+), access control, and ISO-certified data centers.
6. Timing & Reporting
Ideally in real time, but within 24 hours of issuance is acceptable.
NRS returns an Acknowledgment Code (IRN), which serves as proof of submission and must be retained for audits.
7. Industry & Cross-Border Considerations
Yes. Export-related invoices must also be reported for transparency and FX monitoring.
NRS’s scheme focuses on VAT/tax reporting, while CBN’s targets FX and trade monitoring. Qucoon’s integration can bridge both where applicable.
8. Support & Transition
Yes, Qucoon provides regular workshops, webinars, and documentation for finance and IT teams.
9. Authentication & Authorization
Each API request must include a Business Key obtained from the Request-Business-Key endpoint using valid Business credentials.
Business keys do not expire — they remain valid indefinitely unless explicitly revoked or regenerated by the Business (taxpayer).
You’ll receive a
401 Unauthorized response — reauthenticate or check for invalid Business Key.10. API: Invoice Creation & Submission
POST /api/v1/invoices/create — sends invoice data to NRS through Qucoon’s gateway.JSON formatted per NRS e-Invoicing schema, including mandatory fields:
invoiceNumber, invoiceIssueDate, invoiceTotalAmount, etc.Qucoon validates invoice structure, VAT amounts, and mandatory fields before forwarding to NRS.
11. API: Fetching & Status Updates
GET /invoices/status/{invoiceId} — returns status and acknowledgment details.200 – Successfully transmitted202 – Pending validation400 – Validation error409 – Duplicate invoice500 – System errorGET /invoices/fetch?fromDate&toDate&status — supports filters for date range or status.12. Integration & Setup
Supports webhooks and message queues for event tracking (success/failure).
A sandbox is available to simulate NRS production before go-live.
13. Error Handling & Troubleshooting
| Error Code | Meaning | Resolution |
|---|---|---|
| 400 | Invalid or missing fields | Verify mandatory fields (TINs, totals, dates) |
| 401 | Unauthorized | Refresh or reissue token |
| 409 | Duplicate invoice | Use unique invoiceNumber |
| 500 | Internal error | Retry or contact support |
Qucoon automatically retries queued transactions during NRS downtime and logs results in the dashboard.
14. Reporting & Compliance (Technical)
Data can be exported as CSV or PDF via the Compliance Portal.
Automatically at line or total level, following NRS VAT rules embedded in the schema.
15. Support & Maintenance
Email: support@qucoon.com
or reach your Technical Account Manager (TAM) directly.
Qucoon (as SI) provides optional custom connector development and field mapping support.
All APIs are version-controlled and updated quarterly or when NRS releases new specs.
16. Version Info
Last Updated: November 2025
Maintained By: Qucoon Compliance & Integration Team
Applies To: APP & SI Implementations
Environments: Sandbox / Production
Modified at 2026-08-21 08:32:03