Configure Nigeria Compliance Settings

This is where you tell Zinye how to talk to NRS. You only do it once. Everything lives on one screen: Nigeria Compliance Settings.

Open the settings

In the search bar at the top, type Nigeria Compliance Settings and open it. You’ll need System Manager or Accounts Manager permission.

Fill in the e-Invoice (NRS MBS) tab

Open the e-Invoice (NRS MBS) tab and enter the values from your NRS portal (see Enable & get your keys). Leave the big Enable toggle for last.

Field	What to enter
Environment	Sandbox while testing, Production when you go live.
NRS Business ID	Your Business ID from the portal.
NRS Service ID	The 8-character code from your IRN template (e.g. B0B17AB7).
Integrator Service ID	Leave as 00000 — this is correct for most businesses.
API Key (x-api-key)	Your API Key.
API Secret (x-api-secret)	Your Client Secret from the portal. (The portal calls it “Client Secret”; Zinye’s field is “API Secret”.)
Sandbox Base URL	Pre-filled with the standard sandbox host (https://eivc-k6z6d.ondigitalocean.app). Leave it unless NRS gives you a different one.
Production Base URL	Pre-filled with https://api.einvoice.firs.gov.ng. Used when Environment is Production.
Public Key (base64)	The public_key value from crypto_keys.txt.
Certificate (base64)	The certificate value from crypto_keys.txt.

Choose how it behaves

The defaults are recommended for most businesses:

Setting	Recommended	What it means
B2B Only (skip invoices without buyer TIN)	✅ On	Only invoices to registered businesses (customers with a TIN) are sent to NRS. Walk-in / individual sales are marked Not Required and skipped.
Auto-Submit on Invoice Submission	✅ On	Invoices go to NRS automatically the moment you submit them — no extra clicks.
Default VAT Rate (%)	7.5	Nigeria’s standard VAT rate.

Turn it on and save

1. Tick Enable NRS MBS e-Invoicing at the top of the tab.
2. Make sure Company and TIN are set on the General tab (the TIN must match the one registered with NRS for your Business ID).
3. Click Save.

Tip

Zinye checks your settings when you save. If you tick Enable but leave out the Service ID, API Key, or Public Key, it tells you straight away — so you can’t half-configure it by accident. Saving also sets the Nigeria Sales Invoice print format (the one with the QR code) as your default invoice printout.

Test the connection

Before sending any invoice, confirm Zinye can actually reach NRS:

1. Still on Nigeria Compliance Settings, open the menu (the ... / Actions button, top right).
2. Click Test NRS MBS Connection.
3. You should see a success message. If you get an error instead, it’s almost always a mistyped API Key, API Secret, or Base URL — re-copy them from the portal and watch for trailing spaces. See Troubleshooting.

Download the official code lists

NRS requires every product or service on an invoice to carry an official classification code. Zinye can download the entire official list so you can simply pick from it later.

1. On Nigeria Compliance Settings, find the NRS Reference Data actions.
2. Click Sync HS Codes — downloads the official codes for goods (physical products). This can take a minute.
3. Click Sync Service Codes — downloads the official codes for services.

You only need to do this once. Zinye also refreshes these lists automatically every week.

A quick sanity check

If your Public Key was pasted correctly, Zinye can build the QR code. If invoices later submit but print without a QR, the Public Key is almost always the culprit — re-download crypto_keys.txt and paste the public_key again, carefully.

Next

• Prepare your data (required fields) — do this before you send your first invoice.