Transmit Invoice
base_url: https://firseinvoicedemo.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
- Sample Response
Request Parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
| irn | string | Invoice Reference Number | Yes |
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
- Sample Response
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",
}
'
Sample Success Response
POST {base_url}/api/v1/app/invoice/transmit
{
"status": 200,
"message": "Invoice transmission successful",
"data": {
"message": true
},
"execTime": 1.234568,
"error": ""
}