Transmit Invoice

base_url: https://firseinvoice.etranzactng.com/

Description: This allows taxpayers/users to transmit an e-invoice from their domain/ERP as a seller to the buyer’s ERP/accounting system. It initiates the electronic invoice exchange process in compliance with FIRS specifications by routing between both seller and buyer’s APP (Access Point Provider). It sends a webhook notification to all involved parties about the invoice transmission. A webhook is required to receive notifications which contains the IRN and validation details.

Sample Request

Request Parameters

Parameter	Type	Description	Required?
irn	string	Invoice Reference Number	Yes
tin	string	Tax Identification Number (TIN) is a unique number issued by FIRS (or JTB/SBIR) for filing tax returns and other tax-related transactions.	Yes

Sample Response

Response Parameters

Parameter	Type	Description	Required?
status	integer	HTTP status code	Yes
message	string	Description of http status code	Yes
data	object	A nested data object containing the primary details of the response.	Yes
irn	string	IRN assigned to the invoice	Yes
transactionId	string	Unique transaction identifier	Yes
timestamp	string	Record of the transaction processing	Yes
execTime	integer	Time taken to process request (for metrics and performance tracking)	Yes
error	integer	Specific errors when request does not return a HTTP status of 200	No

Sample Request

Request Parameters

POST {base_url}/api/v1/app/invoice/transmit/

curl `{base_url}/api/v1/app/invoice/transmit/`
  -H "X-API-Key: {{CLIENT_API_KEY}}"
  -H "X-API-Signature: {{HMAC_SHA256_SIGNATURE}}"
  -H "X-API-Timestamp: {{ISO_20022_TIMESTAMP}}"
  -H "Content-Type: application/json"
  -d '{
    "irn": "INV285-47AT78FN-20250417",
    "tin": "12345678-0001"
   }
'

Sample Response

Sample Success Response

POST {base_url}/api/v1/app/invoice/transmit/

{
  "status": 200,
  "message": "Invoice transmission successful",
  "data": {
    "message": true
  },
  "execTime": 1.234568,
  "error": ""
}