{
"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
'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Validador de E-Factura NRS FIRS de Nigeria API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
(Ahorra 2 meses pagando anualmente 🎉)
Validador de e-facturas Keyless Nigeria NRS (ex-FIRS): XSD oficial UBL 2.1, reglas base Peppol BIS, TIN nigeriano en ambas partes, IVA por línea, bloques de autorización IRN/CSID/Código QR. Informe en JSON codificado por reglas
El punto final de verificación de salud GET devuelve un objeto JSON simple que indica el estado del servicio mientras que el punto final POST Validar factura electrónica devuelve un informe de validación JSON detallado que incluye campos como validez conformidad tipo de documento y hallazgos relacionados con el cumplimiento de UBL 2.1 y las regulaciones nigerianas
Los campos clave en el informe de validación incluyen "válido" "bienFormado" "tipoDeDocumento" "tieneIRN" "tieneCSID" "tieneQR" "contadorDeErrores" "contadorDeAdvertencias" y "hallazgos" que proporcionan información de cumplimiento detallada y violaciones de reglas
Los datos devueltos están en formato JSON La estructura incluye un objeto de nivel superior con campos para el estado de validación y hallazgos donde "hallazgos" es un arreglo de objetos que detallan violaciones específicas de reglas su gravedad y ocurrencias
La verificación de salud GET proporciona el estado del servicio mientras que el POST Validar e-factura ofrece detalles de validación integral incluyendo el cumplimiento con UBL 2.1 las reglas de Peppol BIS y requisitos específicos nigerianos como TIN y VAT
Los datos de respuesta están organizados en un objeto principal que contiene los resultados de la validación y un arreglo de hallazgos. Cada hallazgo incluye campos como "nivel," "ruleId," "texto," "ubicación," y "ocurrencias," permitiendo a los usuarios identificar fácilmente los problemas
Los datos se basan en normas oficiales, incluyendo el OASIS UBL 2.1 XSD y las reglas base de Peppol BIS, asegurando el cumplimiento de las regulaciones nigerianas El validador verifica conforme a estas normas para mantener la precisión de los datos
Los casos de uso típicos incluyen la validación de facturas electrónicas para cumplir con las regulaciones fiscales nigerianas asegurando el formato adecuado para las presentaciones electrónicas e identificando errores o advertencias antes de la presentación a las autoridades fiscales
Los usuarios pueden analizar el informe de validación para identificar problemas de cumplimiento rastrear el conteo de errores y revisar hallazgos específicos para hacer las correcciones necesarias a las facturas asegurándose de que cumplan con los requisitos regulatorios antes de la presentación