The FIRS Settings DocType is used to configure Nigeria Compliance via DigiTax before transactions can be submitted to FIRS platform. This setup connects ERPNext to DigiTax services allowing sales tracking.
Before starting the configuration, ensure that your organization has completed onboarding with DigiTax and that you have received a valid API Key for the target environment.
Accessing FIRS Settings
To configure the integration, navigate to:
Nigeria Compliance → FIRS Settings
Create a new settings record or open an existing configuration. This page acts as the central setup point for communication between ERPNext, DigiTax, and FIRS.
Environment Configuration
If the API Key created on DigiTax is for testing purpose, label the document as 'Sandbox' otherwise use 'Production'.
Once configured, enable Allow FIRS to track sales to allow the integration to process compliance operations.
The Server URL is pre-configured by default and normally does not require modification unless instructed during onboarding or support.
Company Setup
Select the ERPNext Company that will be used for compliance processing. Enter the Tax Identification Number (TIN). Make sure the TIN matches the FIRS registered TIN associated with your DigiTax account.
Accurate company information is important to ensure successful validation and submission of transactions to FIRS.
API Configuration
Communication with DigiTax services requires a valid API Key obtained from the DigiTax Portal during on-boarding. This key is used to authenticate all requests between ERPNext and DigiTax services and should be kept secure.