नाइजीरिया एनआरएस एफआईआरएस ई-इनवॉयस वेलिडेटर API

API ID 13425

कीलेस नाइजीरिया एनआरएस (पूर्व-एफआईआरएस) ई-इनवॉइस वैलिडेटर: आधिकारिक यूबीएल 2.1 एक्सएसडी, पेपोल बीआईएस आधार नियम, दोनों पक्षों पर नाइजीरियाई टीआईएन, प्रति-लाइन वैट, आईआरएन/सीएसआईडी/क्यूआर क्लियरेंस ब्लॉक्स। नियम-कोडित जेएसओएन रिपोर्ट

297 ms औसत रिस्पॉन्स

API डॉक्यूमेंटेशन

एंडपॉइंट्स

अनुरोध
सरल लाइवनेस जांच मॉनिटरिंग और अपटाइम चेक के लिए HTTP 200 के साथ {"status":"ok"} लौटाता है जब वैलिडेशन सेवा चालू होती है और दस्तावेज़ स्वीकार करने के लिए तैयार होती है कोई पैरामीटर नहीं कोई बॉडी आवश्यक नहीं
Endpoint ID: 29082
GET https://zylalabs.com/api/13425/nigeria+nrs+firs+e-invoice+validator+api/29082/health+check
इनपुट पैरामीटर्स

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.

इस एंडपॉइंट के लिए किसी इनपुट पैरामीटर की आवश्यकता नहीं है।

API उदाहरण प्रतिक्रिया
JSON
{
    "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' 


    
अनुरोध
कच्ची चालान को अनुरोध(body) के रूप में भेजें (UBL 2.1 XML जिसमें Content-Type: application/xml या JSON) यह एक JSON मान्यता रिपोर्ट लौटाता है: मान्य, अच्छी तरह से निर्मित, दस्तावेज़ प्रकार, hasIRN, hasCSID, hasQR, errorCount, warningCount और विस्तृत नियम-कोडित निष्कर्ष (NG-STRUCT-*, NG-BIS-*, NG-RULE-*, NG-IRN-*, NG-CSID-*, NG-QR-*) जो आधिकारिक OASIS UBL 2.1 XSD, EN 16931 / Peppol BIS 3.0 बेस फ़ील्ड्स, नाइजीरिया NRS स्तर (दोनों पक्षों पर TIN, प्रति-लाइन VAT, NGN) और IRN/CSID/QR क्लीयरेंस ब्लॉक्स की संरचनात्मक उपस्थिति को कवर करते हैं एक असंगत चालान अभी भी HTTP 200 है - निर्णय "मान्य": JSON के अंदर false है
Endpoint ID: 29084
POST https://zylalabs.com/api/13425/nigeria+nrs+firs+e-invoice+validator+api/29084/validate+e-invoice
इनपुट पैरामीटर्स

ई-इनवॉइस मान्य करें — एंडपॉइंट फीचर्स

ऑब्जेक्ट विवरण
रिक्वेस्ट बॉडी आवश्यक Json

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.


इनपुट पैरामीटर्स

API उदाहरण प्रतिक्रिया
JSON
{
    "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 एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए नाइजीरिया एनआरएस एफआईआरएस ई-इनवॉयस वेलिडेटर API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।

हेडर्स
हेडर विवरण
Authorization आवश्यक होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।

कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।

(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)

🚀 एंटरप्राइज़ प्लान

शुरू होता है
$ 10,000/वर्ष


  • कस्टम वॉल्यूम
  • कस्टम रेट लिमिट
  • विशेष ग्राहक सहायता
  • रीयल-टाइम API मॉनिटरिंग

अवलोकन

कीलेस नाइजीरिया एनआरएस (पूर्व-एफआईआरएस) ई-इनवॉइस वेलिडेटर: आधिकारिक यूबीएल 2.1 एक्सएसडी, पेप्पोल बीआईएस आधार नियम, दोनों पक्षों पर नाइजीरियाई टीआईएन, प्रति-लाइन वैट, आईआरएन/सीएसआईडी/क्यूआर क्लियरेंस ब्लॉक्स। नियम-कोडित जैसन रिपोर्ट

नाइजीरिया एनआरएस एफआईआरएस ई-इनवॉयस वेलिडेटर API FAQs

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 इन मानकों के खिलाफ डेटा सटीकता बनाए रखने के लिए जांच करता है

सामान्य उपयोग के मामलों में नाइजीरियाई कर नियमों के अनुपालन के लिए ई-चालानों को मान्य करना इलेक्ट्रॉनिक प्रस्तुतियों के लिए उचित प्रारूप सुनिश्चित करना और कर अधिकारियों को प्रस्तुत करने से पहले त्रुटियों या चेतावनियों की पहचान करना शामिल है

उपयोगकर्ता अनुपालन मुद्दों की पहचान करने के लिए सत्यापन रिपोर्ट का विश्लेषण कर सकते हैं त्रुटि की गिनती को ट्रैक कर सकते हैं और आवश्यक सुधार करने के लिए विशिष्ट निष्कर्षों की समीक्षा कर सकते हैं ताकि यह सुनिश्चित किया जा सके कि वे सबमिशन से पहले नियामक आवश्यकताओं को पूरा करते हैं

सामान्य FAQs

Zyla API Hub APIs के लिए एक बड़ा स्टोर जैसा है, जहाँ आप हजारों APIs एक ही जगह पर पा सकते हैं। हम सभी APIs की समर्पित सपोर्ट और रीयल-टाइम मॉनिटरिंग भी प्रदान करते हैं। एक बार साइन अप करने के बाद, आप चुन सकते हैं कि कौन सी APIs उपयोग करनी हैं। बस याद रखें, प्रत्येक API को अपनी स्वयं की सब्सक्रिप्शन की आवश्यकता होती है। लेकिन यदि आप कई APIs पर सब्सक्राइब करते हैं, तो आप सभी के लिए एक ही की का उपयोग करेंगे, जिससे आपके लिए चीज़ें आसान हो जाती हैं।
कीमतें USD (अमेरिकी डॉलर), EUR (यूरो), CAD (कनाडाई डॉलर), AUD (ऑस्ट्रेलियाई डॉलर), और GBP (ब्रिटिश पाउंड) में सूचीबद्ध हैं। हम सभी प्रमुख डेबिट और क्रेडिट कार्ड स्वीकार करते हैं। हमारा पेमेंट सिस्टम नवीनतम सुरक्षा तकनीक का उपयोग करता है और Stripe द्वारा संचालित है, जो दुनिया की सबसे विश्वसनीय पेमेंट कंपनियों में से एक है। यदि आपको कार्ड से पेमेंट करने में कोई समस्या हो, तो बस हमसे संपर्क करें [email protected]

इसके अलावा, यदि आपके पास पहले से ही इनमें से किसी भी करेंसी (USD, EUR, CAD, AUD, GBP) में एक सक्रिय सब्सक्रिप्शन है, तो बाद की सब्सक्रिप्शंस के लिए वही करेंसी बनी रहेगी। जब तक आपके पास कोई सक्रिय सब्सक्रिप्शन नहीं है, आप किसी भी समय करेंसी बदल सकते हैं।
प्राइसिंग पेज पर दिखाई देने वाली स्थानीय करेंसी आपके IP पते के देश पर आधारित है और केवल संदर्भ के लिए प्रदान की गई है। वास्तविक कीमतें USD (अमेरिकी डॉलर) में हैं। जब आप भुगतान करते हैं, तो आपके कार्ड स्टेटमेंट पर चार्ज USD में दिखाई देगा, भले ही हमारी वेबसाइट पर आपको आपकी स्थानीय करेंसी में समतुल्य राशि दिखाई दे। इसका अर्थ है कि आप सीधे अपनी स्थानीय करेंसी से भुगतान नहीं कर सकते।
कभी-कभी, बैंक फ्रॉड प्रोटेक्शन सेटिंग्स के कारण चार्ज को डिक्लाइन कर सकता है। हम सुझाव देते हैं कि आप पहले अपने बैंक से संपर्क करें कि क्या वे हमारे चार्ज को ब्लॉक कर रहे हैं। साथ ही, आप बिलिंग पोर्टल तक पहुंच सकते हैं और भुगतान करने के लिए जुड़े कार्ड को बदल सकते हैं। यदि यह काम नहीं करता और आपको अतिरिक्त सहायता की आवश्यकता है, तो कृपया हमारी टीम से संपर्क करें [email protected]
कीमतें पुनरावर्ती मासिक या वार्षिक सब्सक्रिप्शन के आधार पर निर्धारित की जाती हैं, जो चुने गए प्लान पर निर्भर करती हैं।
API कॉल्स आपके प्लान से सफल रिक्वेस्ट के आधार पर घटाई जाती हैं। प्रत्येक प्लान में प्रति माह आप जितनी कॉल कर सकते हैं उसकी एक विशेष संख्या होती है। केवल सफल कॉल्स, जो स्टेटस 200 रिस्पॉन्स से इंगित होती हैं, आपकी कुल संख्या से घटाई जाएँगी। इससे सुनिश्चित होता है कि असफल या अधूरी रिक्वेस्ट आपके मासिक कोटा को प्रभावित नहीं करतीं।
Zyla API Hub एक पुनरावर्ती मासिक सब्सक्रिप्शन सिस्टम पर काम करता है। आपका बिलिंग साइकल उस दिन से शुरू होगा जिस दिन आप किसी पेड प्लान को खरीदते हैं, और अगले महीने के उसी दिन नवीनीकृत होगा। इसलिए यदि आप भविष्य के चार्ज से बचना चाहते हैं, तो समय पर अपनी सब्सक्रिप्शन कैंसल करना सुनिश्चित करें।
अपनी मौजूदा सब्सक्रिप्शन प्लान को अपग्रेड करने के लिए, बस API के प्राइसिंग पेज पर जाएँ और वह प्लान चुनें जिस पर आप अपग्रेड करना चाहते हैं। अपग्रेड तुरंत प्रभावी होगा, जिससे आपको नए प्लान की सुविधाओं का तुरंत आनंद मिलेगा। कृपया ध्यान दें कि आपके पिछले प्लान से बची हुई कॉल्स नए प्लान में नहीं जोड़ी जाएँगी, इसलिए अपग्रेड करने से पहले इसे ध्यान में रखें। आपको नए प्लान की पूरी राशि चार्ज की जाएगी।
यह देखने के लिए कि आपके पास वर्तमान महीने के लिए कितनी API कॉल्स बची हैं, रिस्पॉन्स हेडर में "X-Zyla-API-Calls-Monthly-Remaining" फ़ील्ड देखें। उदाहरण के लिए, यदि आपके प्लान में प्रति माह 1,000 रिक्वेस्ट की अनुमति है और आपने 100 का उपयोग किया है, तो रिस्पॉन्स हेडर में यह फ़ील्ड 900 बची हुई कॉल्स दिखाएगा।
आपके प्लान में अनुमत API रिक्वेस्ट्स की अधिकतम संख्या देखने के लिए, "X-Zyla-RateLimit-Limit" रिस्पॉन्स हेडर देखें। उदाहरण के लिए, यदि आपके प्लान में प्रति माह 1,000 रिक्वेस्ट्स शामिल हैं, तो यह हेडर 1,000 दिखाएगा।
"X-Zyla-RateLimit-Reset" हेडर यह दिखाता है कि आपकी रेट लिमिट रीसेट होने में कितने सेकंड बचे हैं। यह आपको बताता है कि आपकी रिक्वेस्ट गिनती कब से फिर से शुरू होगी। उदाहरण के लिए, यदि यह 3,600 दिखाता है, तो इसका मतलब है कि लिमिट रीसेट होने में 3,600 सेकंड बचे हैं।
हाँ, आप कभी भी अपने अकाउंट में जाकर और बिलिंग पेज पर कैंसिलेशन विकल्प चुनकर अपना प्लान कैंसल कर सकते हैं। कृपया ध्यान दें कि अपग्रेड, डाउनग्रेड और कैंसिलेशन तुरंत प्रभावी होते हैं। साथ ही, कैंसल करने पर आपको सेवा तक पहुंच नहीं होगी, भले ही आपके कोटा में कॉल्स बची हों।
आपको बिना किसी प्रतिबद्धता के हमारी APIs का अनुभव करने का मौका देने के लिए, हम 7-दिवसीय फ्री ट्रायल प्रदान करते हैं, जो आपको 50 API कॉल्स तक मुफ्त में करने की अनुमति देता है। यह ट्रायल केवल एक बार उपयोग किया जा सकता है, इसलिए हम सलाह देते हैं कि आप इसे उस API पर लागू करें जिसमें आपको सबसे अधिक रुचि है। जबकि अधिकांश APIs फ्री ट्रायल प्रदान करते हैं, कुछ शायद न करें। ट्रायल 7 दिनों के बाद या 50 रिक्वेस्ट होने पर, जो भी पहले हो, समाप्त हो जाता है। यदि आप ट्रायल के दौरान 50 रिक्वेस्ट लिमिट तक पहुँच जाते हैं, तो रिक्वेस्ट जारी रखने के लिए आपको "Start Your Paid Plan" करना होगा। आप अपने प्रोफाइल में Subscription -> जिस API पर आप सब्सक्राइब हैं उसे चुनें -> Pricing टैब में "Start Your Paid Plan" बटन पा सकते हैं। यदि आप 7वें दिन से पहले अपनी सब्सक्रिप्शन कैंसल नहीं करते हैं, तो आपका फ्री ट्रायल समाप्त हो जाएगा और आपका प्लान अपने आप चार्ज हो जाएगा, जिससे आपको अपने प्लान में निर्दिष्ट सभी API कॉल्स तक पहुंच मिल जाएगी। अवांछित चार्ज से बचने के लिए कृपया इसे ध्यान में रखें।
7 दिनों के बाद, आपको उस प्लान की पूरी राशि चार्ज की जाएगी, जिस पर आप ट्रायल के दौरान सब्सक्राइब थे। इसलिए, ट्रायल अवधि समाप्त होने से पहले कैंसल करना महत्वपूर्ण है। समय पर कैंसल करना भूलने के लिए रिफंड अनुरोध स्वीकार नहीं किए जाते।
जब आप किसी API के फ्री ट्रायल पर सब्सक्राइब करते हैं, तो आप 50 API कॉल्स तक कर सकते हैं। यदि आप इस लिमिट से आगे अतिरिक्त API कॉल्स करना चाहते हैं, तो API आपको "Start Your Paid Plan" करने का संकेत देगा। आप अपने प्रोफाइल में Subscription -> जिस API पर आप सब्सक्राइब हैं उसे चुनें -> Pricing टैब में "Start Your Paid Plan" बटन पा सकते हैं।
पAYOUT ऑर्डर्स महीने की 20 तारीख से 30 तारीख के बीच प्रोसेस किए जाते हैं। यदि आप अपना अनुरोध 20 तारीख से पहले सबमिट करते हैं, तो आपका पेमेंट इस समयावधि के भीतर प्रोसेस किया जाएगा।
आप तुरंत सहायता प्राप्त करने के लिए हमारे चैट चैनल के माध्यम से हमसे संपर्क कर सकते हैं। हम हमेशा सुबह 8 बजे से शाम 5 बजे (EST) तक ऑनलाइन रहते हैं। यदि आप हमें उस समय के बाद संपर्क करते हैं, तो हम यथाशीघ्र आपसे संपर्क करेंगे। इसके अलावा, आप हमें ईमेल के माध्यम से भी संपर्क कर सकते हैं [email protected]

संबंधित APIs