ब्राज़ीलियन नोटा फिस्कल इलेक्ट्रॉनिका (NF-e, मोड 55), NFC-e (मोड 65), और CT-e (मोड 57) XML को वर्तमान SEFAZ स्कीमा के खिलाफ मान्य करें — और वापस पाएं सही तत्व पथ जो विफल हुए, न कि कोई रहस्यमय अस्वीकृति कोड। यह कर-तकनीक डेवलपर्स, ERP, और ई-कॉमर्स चेकआउट एकीकरणों के लिए बनाया गया है जो विफल कर रहे कर दस्तावेजों को पकड़ने की आवश्यकता है पहले SEFAZ से।
बहुत सी ब्राज़ीलियन वित्तीय एपीआई (फोकस एनएफई, वेबमेनिया, एनएफई.io) पूर्ण उत्पादन स्टैक्स हैं — भारी, जारीकर्ताओं के लिए मूल्य निर्धारण, और यदि आपके पास पहले से XML है और केवल इसे मान्य करने की आवश्यकता है तो यह ओवरकिल है। यह एक शुद्ध-डेटा वेलिडेटर है: POST XML, संरचित पास/फेल के साथ प्रकारीकृत त्रुटियाँ प्राप्त करें। स्कीमा नियम और प्रति-नगर NFS-e की विशेषताएँ सामान्य वैश्विक वेलिडेटरों द्वारा पुनरावृत्त नहीं की जाती हैं।
/NFe/infNFe/ide/nNF प्रकारीकृत कोड (MISSING_REQUIRED, INVALID_FORMAT, CROSS_FIELD, UNSUPPORTED_VERSION, INVALID_ROOT).400 के लिए गलत XML, 422 के लिए स्कीमा-मान्य लेकिन सामग्री-अमान्य, 200 के लिए मान्य।/v1/ एपीआई, और दैनिक 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/12735/e-invoice+error+checking+validation+api/24635/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 रिक्वेस्ट तक शामिल हैं।
एपीआई एक JSON प्रतिक्रिया लौटाता है जिसमें एक वैधता ध्वज, प्रति-तत्व त्रुटियों की एक सूची (पथों और त्रुटि कोड के साथ), स्व-निर्धारित स्कीमा संस्करण, दस्तावेज़ प्रकार और किसी भी नगरपालिका-विशिष्ट चेतावनियाँ शामिल हैं
प्रतिक्रिया में मुख्य क्षेत्र शामिल हैं "valid" (बूलियन), "errors" (त्रुटि ऑब्जेक्ट का ऐरे), "schema_version" (स्ट्रिंग), "schema_kind" (स्ट्रिंग), और "municipality_specific_warnings" (ऐरे)
प्रतिक्रिया एक JSON ऑब्जेक्ट के रूप में संरचित है जिसमें वैधता, त्रुटियाँ, स्कीमा संस्करण, स्कीमा प्रकार और नगरपालिका चेतावनियों के लिए शीर्ष-स्तरीय कुंजी हैं जिससे प्रत्येक घटक तक आसानी से पहुंचा जा सके
API NF-e NFC-e और CT-e XML दस्तावेजों के लिए मान्यता परिणाम प्रदान करता है जिसमें त्रुटि विवरण, स्कीमा संस्करण और नगरपालिका-विशिष्ट चेतावनियां शामिल हैं जो समग्र मान्यता प्रतिक्रिया सुनिश्चित करते हैं
डेटा की सटीकता को SEFAZ स्कीमा अपडेट की दैनिक निगरानी के माध्यम से बनाए रखा जाता है यह सुनिश्चित करते हुए कि एपीआई NF-e NFC-e और CT-e दस्तावेजों के लिए सबसे वर्तमान मान्यता नियमों और संरचनाओं का उपयोग करता है
सामान्य उपयोग के मामले में ERP सिस्टम में लेजर आयात से पहले सप्लायर NF-e का सत्यापन करना ई-कॉमर्स चेकआउट के दौरान CT-e/NF-e का पूर्व-सत्यापन करना और दस्तावेज़-इनटेक पाइपलाइनों में अनुपालन सुनिश्चित करना शामिल है
उपयोगकर्ताओं को "valid" ध्वज की जाँच करके यह निर्धारित करने के लिए लौटाए गए डेटा का उपयोग कर सकते हैं कि XML मान्य है "errors" सूची की समीक्षा करके विशिष्ट मुद्दों के लिए और अनुपालन के लिए किसी भी नगरपालिका-विशिष्ट चेतावनियों का समाधान करके
मानक डेटा पैटर्न में मान्य दस्तावेज़ों के लिए सही "valid" फ़्लैग, एक खाली "errors" एरे, और अमान्य दस्तावेज़ों के लिए MISSING_REQUIRED या INVALID_FORMAT जैसे विशिष्ट त्रुटि कोड शामिल हैं जो मुद्दों पर स्पष्ट फीडबैक प्रदान करते हैं
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
904ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,461ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
573ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
22ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,881ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
15ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
482ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,160ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
596ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
23ms