ब्राज़ीलियाई नोटा फिस्कल इलेक्ट्रॉनिका (NF-e, मोड 55), NFC-e (मोड 65), और CT-e (मोड 57) XML को वर्तमान SEFAZ स्कीमा के खिलाफ जांचें — और उन्हीं तत्वों के पथ वापस प्राप्त करें जो विफल हुए, न कि कोई अस्पष्ट अस्वीकृति कोड। वित्तीय-तकनीकी डेवलपर्स, ERP और ई-कॉमर्स चेकआउट इंटीग्रेशन के लिए बनाया गया है जिन्हें विकृत वित्तीय दस्तावेजों को SEFAZ से पहले पकड़ने की आवश्यकता है।
ज्यादातर ब्राज़ीलियाई वित्तीय APIs (फोकस NFe, वेबमानिया, 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": []
}
{"valid":true,"errors":[],"schema_version":"4.00","schema_kind":"nfe","municipality_specific_warnings":[]}
curl --location --request POST 'https://zylalabs.com/api/12734/fiscal+document+xml+validator+api/24632/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
'
| हेडर | विवरण |
|---|---|
Authorization
|
[आवश्यक] होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें। |
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
API एक JSON प्रतिक्रिया लौटाता है जिसमें एक वैधता फ्लैग, प्रति-तत्व त्रुटियों की एक सूची (पथों और त्रुटि कोड के साथ), स्वचालित रूप से पहचाना गया स्कीमा संस्करण, दस्तावेज़ प्रकार और किसी भी नगरपालिका-विशिष्ट चेतावनियाँ शामिल हैं
प्रतिक्रिया में कुंजी क्षेत्रों में "valid" (बूलियन), "errors" (त्रुटि वस्तुओं का एरे), "schema_version" (स्ट्रिंग), "schema_kind" (स्ट्रिंग) और "municipality_specific_warnings" (एरे) शामिल हैं
प्रतिक्रिया को एक JSON ऑब्जेक्ट के रूप में संरचित किया गया है जिसमें वैधता, त्रुटियाँ, स्कीमा संस्करण, स्कीमा प्रकार, और नगरपालिका चेतावनियों के लिए उच्चतम स्तर के कुंजी हैं जिससे प्रत्येक घटक तक आसान पहुँच हो सके
एपीआई NF-e NFC-e और CT-e XML दस्तावेजों के लिए मान्यता परिणाम प्रदान करता है जिसमें त्रुटि विवरण, स्कीमा संस्करण और नगरपालिका-विशिष्ट चेतावनियाँ शामिल हैं जो व्यापक मान्यता फीडबैक सुनिश्चित करती हैं
डेटा सटीकता को SEFAZ स्कीमा अपडेट के दैनिक निगरानी के माध्यम से बनाए रखा जाता है यह सुनिश्चित करते हुए कि API NF-e NFC-e और CT-e दस्तावेजों के लिए सबसे वर्तमान मान्यता नियमों और संरचनाओं का उपयोग करता है
विशिष्ट उपयोग के मामलों में ERP सिस्टम में लेजर आयात से पहले प्रदाता NF-e को मान्य करना ई-कॉमर्स चेकआउट के दौरान CT-e/NF-e को पूर्व मान्य करना और दस्तावेज़-इनटेक पाइपलाइन्स में अनुपालन सुनिश्चित करना शामिल है
उपयोगकर्ता लौटाए गए डेटा का उपयोग "मान्य" ध्वज को जांचकर यह निर्धारित करने के लिए कर सकते हैं कि XML मान्य है विशेष मुद्दों के लिए "त्रुटियाँ" सरणी की समीक्षा कर सकते हैं और अनुपालन के लिए किसी भी नगरपालिका-विशिष्ट चेतावनियों का समाधान कर सकते हैं
मानक डेटा पैटर्न में मान्य दस्तावेजों के लिए सही का "वैध" ध्वज, एक खाली "त्रुटियाँ" एरे और अमान्य दस्तावेजों के लिए विशिष्ट त्रुटि कोड जैसे आवश्यक सामग्री की कमी या अमान्य प्रारूप शामिल हैं जो समस्याओं पर स्पष्ट फीडबैक प्रदान करते हैं
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
10,154ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,877ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
983ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,629ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
10,037ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
878ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,626ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,134ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,381ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
827ms