{
"status": "ok"
}
curl --location --request GET 'https://zylalabs.com/api/13425/nigeria+nrs+firs+e-invoice+validator+api/29082/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
{
"valid": true,
"wellFormed": true,
"inputFormat": "xml",
"documentType": "380",
"hasIRN": true,
"hasCSID": true,
"hasQR": true,
"errorCount": 0,
"warningCount": 0,
"findings": [
{
"level": "info",
"ruleId": "NG-STRUCT-XSD",
"text": "Document is valid against the official OASIS UBL 2.1 Invoice XSD.",
"location": null,
"occurrences": 1
},
{
"level": "info",
"ruleId": "NG-IRN-PRESENT",
"text": "IRN present (structure only; NRS-issued authenticity not cryptographically verified): IRN-4c2f9d3e8a1b47f0b6c5d2e1f0a9b8c7",
"location": "IRN",
"occurrences": 1
},
{
"level": "info",
"ruleId": "NG-CSID-PRESENT",
"text": "CSID / cryptographic stamp block present. STRUCTURE ONLY: this validator does not hold the NRS signing certificate and cannot verify the stamp's cryptographic authenticity.",
"location": "ext:UBLExtensions",
"occurrences": 1
},
{
"level": "info",
"ruleId": "NG-QR-PRESENT",
"text": "QR present and base64-decodable (36 bytes). STRUCTURE ONLY: QR contents are not cross-checked against an NRS-issued signature.",
"location": "cac:AdditionalDocumentReference[ID='QR']",
"occurrences": 1
}
]
}
curl --location --request POST 'https://zylalabs.com/api/13425/nigeria+nrs+firs+e-invoice+validator+api/29084/validate+e-invoice' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '
2.1
urn:cen.eu:en16931:2017#compliant#urn:fdc:nrs.gov.ng:ng-einvoice:1.0
urn:fdc:peppol.eu:2017:poacc:billing:01:1.0
NG-INV-2025-000123
IRN-4c2f9d3e8a1b47f0b6c5d2e1f0a9b8c7
2025-11-03
10:15:00
380
NGN
NGN
CSID
NRS Cryptographic Stamp Identifier
Q1NJRC1QTEFDRUhPTERFUi1zdHJ1Y3R1cmUtb25seS1ub3QtdmVyaWZpZWQ=
QR
QR
UVItUExBQ0VIT0xERVItYmFzZTY0LXN0cnVjdHVyZS1vbmx5
Lagos Trading Company Limited
12 Marina Road
Lagos
Lagos
NGA
12345678-0001
VAT
Lagos Trading Company Limited
RC-1234567
Abuja Retail Ventures Limited
5 Ademola Adetokunbo Crescent
Abuja
FCT
NGA
87654321-0001
VAT
Abuja Retail Ventures Limited
RC-7654321
2250.00
30000.00
2250.00
S
7.5
VAT
30000.00
30000.00
32250.00
32250.00
1
2
10000.00
Office chairs, ergonomic
Ergonomic office chair
S
7.5
VAT
5000.00
2
1
20000.00
Executive desk, mahogany
Executive desk
S
7.5
VAT
20000.00
'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 尼日利亚 NRS FIRS 电子发票验证器 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
GET健康检查端点返回一个简单的JSON对象,指示服务状态,而POST验证电子发票端点返回一个详细的JSON验证报告,包含有效性、格式良好性、文档类型以及与UBL 2.1和尼日利亚法规合规性相关的发现等字段
验证报告中的关键字段包括"有效""格式正确""文档类型""有IRN""有CSID""有二维码""错误计数""警告计数"和"发现"这些字段提供了详细的合规信息和规则违规情况
返回的数据是JSON格式 结构包括一个顶级对象 其中包含验证状态和发现的字段 "发现" 是一个对象数组 详细说明了具体的规则违规情况 其严重程度和发生次数
GET健康检查提供服务状态,而POST验证电子发票则提供全面的验证细节,包括与UBL 2.1、Peppol BIS规则以及特定的尼日利亚要求(如TIN和VAT)的合规性
响应数据被组织成一个包含验证结果的主要对象和一个发现数组。每个发现包括字段,如“级别”、“规则ID”、“文本”、“位置”和“发生次数”,使用户能够轻松识别问题
数据基于官方标准,包括OASIS UBL 2.1 XSD和Peppol BIS基本规则,确保符合尼日利亚法规。验证器根据这些标准进行检查,以维护数据的准确性
典型的用例包括验证电子发票是否符合尼日利亚税收法规 确保电子提交的格式正确以及在提交给税务机关之前识别错误或警告
用户可以分析验证报告以识别合规问题,跟踪错误计数,并审查特定发现以对发票进行必要的更正,确保它们在提交之前符合监管要求