Nigeria Invoices (FIRS / NRS MBS e-invoicing IRN)

Sign and submit a Nigeria e-invoice to FIRS / NRS MBS — POST /invoice/sign. FIRS signs it server-side and returns the official IRN (Invoice Reference Number), CSID (Cryptographic Stamp Identifier) and QR code to print on the invoice. Bring your own credentials via headers x-firs-api-key AND x-firs-api-secret. The IRN format is InvoiceNumber-ServiceID-YYYYMMDD (e.g. ITW20853450-6997D6BB-20240703): pass irn directly if you already have it, otherwise this server builds it from invoice_number + serv…

Look up a signed Nigeria e-invoice by its IRN at FIRS / NRS MBS — GET /invoice/confirm/{irn}. Returns the transmission / delivery status and the IRN/CSID. Safe to call anytime.

Pre-validate a Nigeria e-invoice against FIRS / NRS MBS (Merchant Buyer Solution) BEFORE signing — POST /invoice/validate. Returns pass, or the FIRS error list if the payload is rejected (so you fix it before spending a real submission). Bring your own credentials via headers x-firs-api-key AND x-firs-api-secret (generate them in your NRSMBS Dashboard -> API Integration; your business must be enabled for e-invoicing first). If your Dashboard issued a sandbox base URL, also send header x-firs-bas…