Transaction Status

DigiTax Queueing system

DigiTax provides the following:

Asynchronous functionality that automatically retries FIRS
Get notifications on transaction statuses via Callback URLs
Throttling traffic between the businesses throughput and the tax authority's system

These functionalities are possible due to the DigiTax Queueing system.

📘
You don't run the risk of double-entry
Every transaction that interacts with FIRS E-Invoicing System is first off entered into the DigiTax Queueing system to mitigate against possible FIRS:

intermittency and downtime OR

slow response rate

The different transaction statuses and what they mean

Since transactions are first off entered into the DigiTax Queueing system, we give you the following statuses. This is what they mean.

Transaction statuses

These are the possible options for the status property of a response from the invoices endpoints.

Status	Meaning	Action
pending	DigiTax Queueing system is queued after attempting to reach FIRS E-Invoicing System	Check in later. If you set up Callback URLs, DigiTax will post to your system when the FIRS E-Invoicing System sync is done.
completed	The completed invoice is signed	Check in later. If you set up Callback URLs, DigiTax will post to your system when it is done.
failed	FIRS E-Invoicing System rejected the transaction	Please initiate another transaction.

Invoice Status Details

These are depicted by timestamps both on the DigiTax Nigeria API and Dashboard.

On the API, these are:

created_at property
validated_at property
signed_at property
transmitted_at property

of a response from the invoices endpoints.

The timestamps above correspond to what you'd see on the Dashboard, under "Invoices" tab, when you click on the arrow icon next to the block under "Invoice Status". These are:

Created
Validated
Signed
Transmitted

Successful transmission requirements

For an invoice to be marked as transmitted:

A party needs to be added
The party needs to be onboarded on FIRS.

Party details for transmission

For testing purposes, please use the following properties:

Name: Namiri Technology Nigeria Limited
TIN: 08289985-9145
Email: [email protected]
Phone: +2347724935855
Street address: Broad Street
City: Benin City
Postal code: 111111