Generate QR code (optional)
base_url: https://firseinvoicedemo.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.
To get your certificate:
Login to the NRS portal. On your dashboard, navigate to the "My Account" Tab. Click on "Manage Cryptographic Keys", then download a file named crypto_keys.txt. The crypto_keys.txt file you downloaded contains the public key and Certificate.
You are only required to include this certificate value in the payload together with other parameters: invoice number, service Id, issuance date and business_id.
NB: If certificate is not included, the Seller/Supplier field will display/print "Test Business" by default.
- 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 | NRS issued/assigned credential | Yes |
| issuance_date | date | Date invoice was issued | Yes |
| certificate | string | Certificate to be provided by clients from their NRS profile/account | 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/generate-qr-code
curl -X POST `{base_url}/api/v1/si/generate-qr-code`
-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",
"certificate": "VmxRamMwR2E5NGRvQW9QQVdGYUdzMzJucVh4azhVYmhabnRhY0k9QmxBcWE="
}
'
Sample Success Response
POST {base_url}/api/v1/si/generate-qr-code
{
"status": 200,
"message": "IRN generated successfully.",
"data": {
"qr_code_base64": "iVBORw0KGgoAAAANSUhEUgAA...",
"qr_code_file_bytes": "255044462D312E350A25..."
},
"execTime": 1.388868,
"error": ""
}