ब्राजीलीय नोटा फिस्कल इलेक्ट्रॉनिका (NF-e, मोड 55), NFC-e (मोड 65), और CT-e (मोड 57) XML को वर्तमान SEFAZ स्कीमा के खिलाफ मान्य करें — और सटीक तत्व पथ वापस प्राप्त करें जो असफल हुए, कोई रहस्यमय अस्वीकृति कोड नहीं। यह फिस्कल-टेक डेवलपर्स, ERP और ई-कॉमर्स चेकआउट एकीकरणों के लिए बनाया गया है जिन्हें गलत फिस्कल दस्तावेजों को SEFAZ से पहले पकड़ने की जरूरत है।
अधिकतर ब्राजीलीय फिस्कल एपीआई (फोकस 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/12733/ct-e+xml+schema+compliance+api/24633/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 ऑब्जेक्ट के रूप में संरचित किया गया है जिसमें वैधता, त्रुटियाँ, स्कीमा संस्करण, स्कीमा प्रकार और नगरपालिका चेतावनियों के लिए शीर्ष स्तर की कुंजी होती हैं जिससे प्रत्येक घटक तक आसान पहुँच मिलती है
API NF-e NFC-e और CT-e XML दस्तावेजों के लिए वैधता परिणाम प्रदान करता है जिसमें त्रुटि विवरण स्कीमा संस्करण और नगरपालिका विशेष चेतावनियाँ शामिल हैं जो कि व्यापक वैधता फीडबैक सुनिश्चित करती हैं
डेटा सटीकता को SEFAZ स्कीमा अपडेट के दैनिक निगरानी के माध्यम से बनाए रखा जाता है यह सुनिश्चित करते हुए कि API NF-e NFC-e और CT-e दस्तावेजों के लिए सबसे वर्तमान मान्यता नियमों और संरचनाओं का उपयोग करता है
विशिष्ट उपयोग के मामलों मेंERP सिस्टम में लेजर आयात से पहले आपूर्तिकर्ता NF-e को मान्य करना ई-कॉमर्स चेकआउट के दौरान CT-e/NF-e को पूर्व-मान्य करना और दस्तावेज़-प्रवेश पाइपलाइनों में अनुपालन सुनिश्चित करना शामिल है
उपयोगकर्ता लौटाए गए डेटा का उपयोग "वैध" ध्वज की जांच करके करेंगे यह निर्धारित करने के लिए कि XML वैध है "त्रुटियों" सरणी की समीक्षा करके विशिष्ट समस्याओं के लिए और अनुपालन के लिए किसी भी नगरपालिका-विशिष्ट चेतावनियों को संबोधित करेंगे
मानक डेटा पैटर्न में मान्य दस्तावेजों के लिए सत्य का "वैध" ध्वज, एक खाली "त्रुटियाँ"array और अवैध दस्तावेजों के लिए विशिष्ट त्रुटि कोड जैसे की MISSING_REQUIRED या INVALID_FORMAT शामिल हैं जो मुद्दों पर स्पष्ट फीडबैक प्रदान करते हैं
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,048ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,494ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,272ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,386ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
157ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,313ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,138ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
153ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,654ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,644ms