Generate QR code (optional)
base_url: https://firseinvoice.etranzactng.com/
Description This endpoint generates a QR code which can be scanned and printed on your invoice. This is an optional step similar to generating an IRN.
- Sample Request
- Sample Response
Request Parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
| invoice_number | string | Taxpayer’s Invoice/transaction reference value (transaction id) | Yes |
| service_id | string | FIRS issued/assigned credential | Yes |
| issuance_date | date | Date invoice was issued | Yes |
| business_id | string | Unique alphanumeric ID generated when the business is registered on the e-invoicing platform. It allows the system recognize all invoices generated by the company | 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 Yes details of the response | Yes |
| qr_code_base64 | string | QR code value encoded in Base64 (string for embedding) | Yes |
| qr_code_file_bytes | string | QR code raw byte value (for file download/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/si/invoice/generate-irn
curl -X POST `{base_url}/api/v1/si/invoice/generate-irn`
-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 '{
"invoice_number": "INV285",
"service_id": "94ND90NR",
"issuance_date": "20250412",
"business_id": "6f19a0f0-c8f3-4d2b-8a8b-1b2c45e89d0f"
}
'
Sample Success Response
POST {base_url}/api/v1/si/invoice/generate-irn
{
"status": 200,
"message": "IRN generated successfully.",
"data": {
"qr_code_base64": "iVBORw0KGgoAAAANSUhEUgAA...",
"qr_code_file_bytes": "255044462D312E350A25..."
},
"execTime": 1.388868,
"error": ""
}