Welcome to FIRS Nigeria E-Invoicing Enablement Portal!

Step 1: Create a Test Account

It is highly recommended to start with a test account. Please use the Test Server to sign up and log in with your new credentials (Please note TIN used during signup will be your username). This allows you to test the entire process without affecting live data.

Step 2: Get Your Credentials

Once logged into the portal, a popup asking to Select Mode/Model Type will appear. Please select appropriate Mode/Model Types. Then from right top menu (click the TIN number for menu), follow the Update Merchant Address as well as Update FIRS Specific Info links. Provide and save the missing information at these links otherwise e-invoice generation will fail. Then in the same menu open Allowed Modes/Model Types link to get your Client ID and Access Key. These credentials are required to authenticate your API requests. Please note the credentials will only appear after selecting a model type as discussed above.

Step 3: Integrate with Our API

Consult the API documentation to understand how to structure your API calls. You will need to send your invoice data along with the Client ID and Access key to sign your invoices and make them FIRS e-invoices compliant.

Step 4: Handle API Responses

On a successful API call, the response will return an IRN (Invoice Reference Number) and a QR code, which you must print on your invoices. In case of failure, the response will provide an error code and message. Use this information to fix the issue and re-try the signing process.

Step 5: Go Live

Once you have a working process on the test server, you can onboard to the Live Server using the exact same process. All your signed invoices will be available on the SmartTax portal where you created your account.

• BlueBox - A minimally intrusive solution that uses a specialized Windows client. Once configured, it generates e-invoices automatically when an invoice is printed through a custom printer. Ideal for legacy systems that cannot be easily modified to support other integration options.
• BlueInvoice - A web-based Point of Sale (POS) system designed for invoicing.
• SmartAPI - A REST-based API that can be integrated with any system capable of consuming HTTP-based services. Ideal for all ERP systems
• Email Connector - Allows users to send invoices as pre-formatted email attachments and receive the corresponding e-invoices in reply. Best suited for users who generate a small number of invoices.
• FTP Client - Similar to the Email Connector, but uses FTP for uploading one or more invoices and downloading the corresponding e-invoices.
• Batch Processor - Enables bulk processing by allowing users to upload one or more invoices via the SmartTax portal and download the processed e-invoices from the same portal.