{"valid":true,"errors":[],"schema_version":"4.00","schema_kind":"nfe","municipality_specific_warnings":[]}
curl --location --request POST 'https://zylalabs.com/api/12839/efficient+nf-e+xml+validatorr+api/25533/validate+nf-e+xml' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '
35
00000001
VENDA
55
1
1
2026-05-19T10:00:00-03:00
1
1
3550308
1
1
0
2
1
0
1
0
1.0
11222333000181
EMPRESA TESTE LTDA
RUA TESTE
100
CENTRO
3550308
SAO PAULO
SP
01000000
123456789012
3
22333444000172
CLIENTE TESTE LTDA
'
साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए कुशल एनएफ-ई एक्सएमएल मान्यकर्ता API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)
ब्राज़ीलियन Nota Fiscal Eletrônica (NF-e, mod 55), NFC-e (mod 65), और CT-e (mod 57) XML को वर्तमान SEFAZ स्कीमा के खिलाफ सत्यापित करें — और सटीक तत्व पथ प्राप्त करें जो विफल हुए, ना कि कोई अस्पष्ट अस्वीकृति कोड। यह कर-तकनीकी डेवलपर्स, ERP, और ई-कॉमर्स चेकआउट इंटीग्रेशन के लिए बनाया गया है जिन्हें दोषपूर्ण कर दस्तावेज़ों को SEFAZ से पहले पकड़ना है।
अधिकतर ब्राज़ीलियन फिस्कल APIs (Focus NFe, Webmania, NFe.io) पूर्ण उत्पादन स्टैक हैं — भारी, जारीकर्ताओं के लिए मूल्यवान, और यदि आपके पास XML पहले से है और केवल इसे सत्यापित करने की आवश्यकता है तो यह ओवरकिल है। यह एक शुद्ध-डेटा वेलीडेटर है: XML को POST करें, संगठित पास/फेल के साथ टाइप किए गए त्रुटियों के साथ प्राप्त करें। स्कीमा नियम और प्रति-मुनीसिपियो NFS-e के ऐसे आम वैश्विक वेलीडेटर्स द्वारा नहीं दोहराए जाते हैं।
/NFe/infNFe/ide/nNF के साथ टाइप किए गए कोड (MISSING_REQUIRED, INVALID_FORMAT, CROSS_FIELD, UNSUPPORTED_VERSION, INVALID_ROOT).400 के लिए दोषपूर्ण XML, 422 के लिए स्कीमा-मान्य लेकिन सामग्री-अमान्य, 200 के लिए मान्य।/v1/ API, और दैनिक SEFAZ स्कीमा-ड्रिफ्ट निगरानी।{
"valid": true,
"errors": [],
"schema_version": "4.00",
"schema_kind": "nfe",
"municipality_specific_warnings": []
}
API एक JSON प्रतिक्रिया लौटाता है जिसमें एक वैधता ध्वज, प्रति-तत्व त्रुटियों की सूची (पथ और त्रुटि कोड के साथ), स्व-संशोधित स्कीमा संस्करण, दस्तावेज़ प्रकार और पिछले किसी नगर निगम-विशिष्ट चेतावनियाँ शामिल हैं
प्रतिक्रिया में प्रमुख क्षेत्र शामिल हैं "valid" (बूलियन) "errors" (त्रुटियों के ऑब्जेक्ट्स का ऐरे) "schema_version" (स्ट्रिंग) "schema_kind" (स्ट्रिंग) और "municipality_specific_warnings" (ऐरे)
प्रतिक्रिया को JSON ऑब्जेक्ट के रूप में संरचित किया गया है जिसमें वैधता, त्रुटियाँ, स्कीमा संस्करण, स्कीमा प्रकार और नगरपालिका चेतावनियों के लिए शीर्ष स्तर के कुंजी हैं जिससे प्रत्येक घटक तक आसानी से पहुँच बनाई जा सके
एपीआई एनएफ-ई एनएफसी-ई और सीटी-ई एक्सएमएल दस्तावेजों के लिए सत्यापन परिणाम प्रदान करता है जिसमें त्रुटि विवरण स्कीमा संस्करण और नगरपालिका विशिष्ट चेतावनियाँ शामिल हैं जिससे व्यापक सत्यापन प्रतिक्रिया सुनिश्चित होती है
डेटा सटीकता को SEFAZ स्कीमा अपडेट की दैनिक निगरानी द्वारा बनाए रखा जाता है यह सुनिश्चित करते हुए कि API NF-e NFC-e और CT-e दस्तावेजों के लिए सबसे वर्तमान मान्यता नियम और संरचनाएं का उपयोग करता है
विशिष्ट उपयोग के मामले में ERP सिस्टम में खाता आयात से पहले सप्लायर NF-e का सत्यापन करना ई-कॉमर्स चेकआउट के दौरान CT-e/NF-e का पूर्व-सत्यापन करना और दस्तावेज़-इनटेक पाइपलाइनों में अनुपालन सुनिश्चित करना शामिल है
उपयोगकर्ता "valid" फ्लैग को चेक करके यह निर्धारित कर सकते हैं कि XML मान्य है या नहीं "errors" एरे की समीक्षा करके विशिष्ट समस्याओं को देख सकते हैं और अनुपालन के लिए किसी भी नगरपालिका-विशिष्ट चेतावनियों को संबोधित कर सकते हैं
मानक डाटा पैटर्न में वैध दस्तावेजों के लिए सत्य का "वैध" ध्वज, एक खाली "त्रुटियों" का ऐरे और अमान्य दस्तावेजों के लिए विशिष्ट त्रुटि कोड जैसे MISSING_REQUIRED या INVALID_FORMAT शामिल हैं जो समस्याओं पर स्पष्ट फीडबैक प्रदान करते हैं