{"valid":true,"errors":[],"schema_version":"4.00","schema_kind":"nfe","municipality_specific_warnings":[]}
curl --location --request POST 'https://zylalabs.com/api/12838/secure+nf-e+xml+validatorr+api/25532/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 एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए सुरक्षित एनएफ-ई XML मान्यकर्ता 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 से पहले पकड़ने की आवश्यकता होती है।
ज्यादातर ब्राज़ीलियाई वित्तीय API (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": []
}
एपीआई एक JSON प्रतिक्रिया लौटाता है जिसमें एक वैधता फ़्लैग, प्रति-तत्व त्रुटियों की एक सूची (पथ और त्रुटि कोड के साथ), स्वतः-निर्धारित स्कीमा संस्करण, दस्तावेज़ प्रकार और किसी भी नगरपालिका-विशिष्ट चेतावनियाँ शामिल होती हैं
प्रतिक्रिया में प्रमुख क्षेत्रों में "valid" (बूलियन), "errors" (त्रुटि वस्तुओं का सरणी), "schema_version" (स्ट्रिंग), "schema_kind" (स्ट्रिंग), और "municipality_specific_warnings" (सरणी) शामिल हैं
प्रतिक्रिया को एक JSON ऑब्जेक्ट के रूप में संरचित किया गया है जिसमें वैधता, त्रुटियाँ, स्कीमा संस्करण, स्कीमा प्रकार और नगरपालिका चेतावनियों के लिए शीर्ष-स्तरीय कुंजी हैं जिससे प्रत्येक घटक तक आसान पहुँच प्राप्त होती है
एपीआई NF-e NFC-e और CT-e XML दस्तावेजों के लिए मान्यता परिणाम प्रदान करता है जिसमें त्रुटि विवरण स्कीमा संस्करण और नगरपालिका विशिष्ट चेतावनियाँ शामिल हैं जिससे व्यापक मान्यता प्रतिक्रिया सुनिश्चित होती है
डेटा सटीकता दैनिक एसईएफएज स्कीमा अपडेट की निगरानी के माध्यम से बनाए रखी जाती है यह सुनिश्चित करते हुए कि एपीआई एनएफ-ई एनएफसी-ई और सीटी-ई दस्तावेजों के लिए सबसे वर्तमान मान्यकरण नियमों और संरचनाओं का उपयोग करता है
विशिष्ट उपयोग के मामलों में ERP सिस्टम में लेजर आयात से पहले प्रदाता NF-e का सत्यापन करना ई-कामर्स चेकआउट के दौरान CT-e/NF-e का पूर्व- सत्यापन करना और दस्तावेज़-स्वीकृति पाइपलाइनों में अनुपालन सुनिश्चित करना शामिल है
उपयोगकर्ता वापस किए गए डेटा का उपयोग "वैध" ध्वज की जांच करके यह निर्धारित करने के लिए कर सकते हैं कि XML वैध है "त्रुटियों" सरणी की समीक्षा करके विशिष्ट मुद्दों के लिए और किसी भी नगरपालिका-विशिष्ट चेतावनियों का पालन करने के लिए संबोधित कर सकते हैं
मानक डेटा पैटर्न में मान्य दस्तावेजों के लिए "मान्य" ध्वज का सही होना, एक खाली "त्रुटियाँ" सरणी, और अमान्य दस्तावेजों के लिए विशिष्ट त्रुटि कोड जैसे MISSING_REQUIRED या INVALID_FORMAT शामिल होते हैं ताकि समस्याओं पर स्पष्ट प्रतिक्रिया मिल सके