कीलेस नाइजीरिया एनआरएस (पूर्व-एफआईआरएस) ई-इनवॉइस वैलिडेटर: आधिकारिक यूबीएल 2.1 एक्सएसडी, पेपोल बीआईएस आधार नियम, दोनों पक्षों पर नाइजीरियाई टीआईएन, प्रति-लाइन वैट, आईआरएन/सीएसआईडी/क्यूआर क्लियरेंस ब्लॉक्स। नियम-कोडित जेएसओएन रिपोर्ट
{
"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 एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए नाइजीरिया एनआरएस एफआईआरएस ई-इनवॉयस वेलिडेटर API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)
कीलेस नाइजीरिया एनआरएस (पूर्व-एफआईआरएस) ई-इनवॉइस वेलिडेटर: आधिकारिक यूबीएल 2.1 एक्सएसडी, पेप्पोल बीआईएस आधार नियम, दोनों पक्षों पर नाइजीरियाई टीआईएन, प्रति-लाइन वैट, आईआरएन/सीएसआईडी/क्यूआर क्लियरेंस ब्लॉक्स। नियम-कोडित जैसन रिपोर्ट
GET स्वास्थ्य जांच अंत बिंदु एक सरल JSON ऑब्जेक्ट लौटाता है जो सेवा की स्थिति को इंगित करता है जबकि POST Validate ई-इनवॉइस अंत बिंदु एक विस्तृत JSON मान्यता रिपोर्ट लौटाता है जिसमें वैधता सही स्वरूपता दस्तावेज़ प्रकार और UBL 2.1 और नाइजीरियाई नियमों के अनुपालन से संबंधित निष्कर्ष जैसे फ़ील्ड शामिल होते हैं
मान्यता रिपोर्ट में प्रमुख क्षेत्र "मान्य," "अच्छी संरचना," "दस्तावेज़ प्रकार," "hasIRN," "hasCSID," "hasQR," "त्रुटि गणना," "चेतावनी गणना," और "खोजें" शामिल हैं जो विस्तृत अनुपालन जानकारी और नियमों का उल्लंघन प्रदान करते हैं
वापसी डेटा JSON प्रारूप में है संरचना में मान्यता स्थिति और निष्कर्ष के लिए क्षेत्रों के साथ शीर्ष-स्तरीय वस्तु शामिल है जहाँ "निष्कर्ष" वस्तुओं का एक अनुक्रम है जो विशिष्ट नियम उल्लंघनों उनकी गंभीरता और घटनाओं का विवरण देता है
GET स्वास्थ्य जांच सेवा की स्थिति प्रदान करती है जबकि POST वैधता ई-इनवॉइस व्यापक वैधता विवरण प्रदान करता है जिसमें UBL 2.1, Peppol BIS नियमों और विशिष्ट नाइजीरियाई आवश्यकताओं जैसे TIN और VAT का अनुपालन शामिल है
प्रतिक्रिया डेटा को एक मुख्य वस्तु में व्यवस्थित किया गया है जिसमें सत्यापन परिणाम और निष्कर्षों का एक सरणी होता है प्रत्येक निष्कर्ष में "स्तर" "नियमId" "पाठ" "स्थान" और "घटनाएँ" जैसे क्षेत्र शामिल होते हैं जिससे उपयोगकर्ता आसानी से समस्याओं की पहचान कर सकें
यह डेटा आधिकारिक मानकों के आधार पर है जिसमें OASIS UBL 2.1 XSD और Peppol BIS आधार नियम शामिल हैं जो नाइजीरिया के नियमों के पालन को सुनिश्चित करता हैvalidator इन मानकों के खिलाफ डेटा सटीकता बनाए रखने के लिए जांच करता है
सामान्य उपयोग के मामलों में नाइजीरियाई कर नियमों के अनुपालन के लिए ई-चालानों को मान्य करना इलेक्ट्रॉनिक प्रस्तुतियों के लिए उचित प्रारूप सुनिश्चित करना और कर अधिकारियों को प्रस्तुत करने से पहले त्रुटियों या चेतावनियों की पहचान करना शामिल है
उपयोगकर्ता अनुपालन मुद्दों की पहचान करने के लिए सत्यापन रिपोर्ट का विश्लेषण कर सकते हैं त्रुटि की गिनती को ट्रैक कर सकते हैं और आवश्यक सुधार करने के लिए विशिष्ट निष्कर्षों की समीक्षा कर सकते हैं ताकि यह सुनिश्चित किया जा सके कि वे सबमिशन से पहले नियामक आवश्यकताओं को पूरा करते हैं