ब्राज़ीलियन नोटा फिस्कल इलेक्ट्रॉनिका (एनएफ-ई, मोड 55), NFC-e (मोड 65), और CT-e (मोड 57) XML को वर्तमान SEFAZ स्कीमा के खिलाफ मान्य करें — और सटीक तत्व पथ प्राप्त करें जो विफल हुए, कोई रहस्यमय अस्वीकृति कोड नहीं। इसको वित्तीय-तकनीकी डेवलपर्स, ईआरपी, और ई-कॉमर्स चेकआउट इंटीग्रेशनों के लिए बनाया गया है जो गलत तरीके से बनाए गए वित्तीय दस्तावेजों को SEFAZ से पहले पकड़ने की आवश्यकता है।
अधिकांश ब्राज़ीलियाई वित्तीय एपीआई (फोकस एनएफई, वेबमैनिया, एनएफई.io) पूर्ण निष्कासन स्टैक हैं — भारी, जारी करने वालों के लिए मूल्य निर्धारण किया गया है, और यदि आपके पास पहले से XML है और केवल इसे मान्य करने की आवश्यकता है तो यह कठिनाई है। यह एक शुद्ध-डेटा वेलिडेटर है: XML को POST करें, और टाइप की गई त्रुटियों के साथ एक संरचित पास/फेल प्राप्त करें। स्कीमा नियम और प्रति-मुन्सिपियो एनएफएस-ई के विशेषताएँ सामान्य वैश्विक वेलिडेटर्स द्वारा दोहराई नहीं जाती हैं।
/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/12738/erp+fiscal+integration+validator+api/24637/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 प्रतिक्रिया लौटाता है जिसमें एक वैधता फ्लैग, तत्व-विशिष्ट त्रुटियों की सूची (पथों और त्रुटि कोड के साथ), स्वचालित रूप से पहचान वाला स्कीमा संस्करण, दस्तावेज़ का प्रकार और किसी भी नगरपालिका-विशिष्ट चेतावनियाँ शामिल हैं
प्रतिक्रिया में प्रमुख क्षेत्रों में "मान्य" (बूलियन), "त्रुटियाँ" (त्रुटि ऑब्जेक्ट्स का एरे), "स्कीमा_संस्करण" (स्ट्रिंग), "स्कीमा_प्रकार" (स्ट्रिंग), और "महानगर_विशिष्ट_चेतावनियाँ" (एरे) शामिल हैं
यह प्रतिक्रिया एक JSON ऑब्जेक्ट के रूप में संरचित है जिसमें वैधता, त्रुटियाँ, स्कीमा संस्करण, स्कीमा प्रकार और नगरपालिका चेतावनियों के लिए उच्चतम स्तर की कुंजी हैं जिससे प्रत्येक घटक तक आसानी से पहुँच संभव है
एपीआई NF-e NFC-e और CT-e XML दस्तावेजों के लिए मान्यता परिणाम प्रदान करता है जिसमें त्रुटि विवरण स्किमा संस्करण और नगरपालिका विशेष चेतावनियाँ शामिल हैं यह व्यापक मान्यता प्रतिक्रिया सुनिश्चित करता है
डेटा सटीकता को SEFAZ स्कीमा अपडेट्स की दैनिक निगरानी के माध्यम से बनाए रखा जाता है यह सुनिश्चित करते हुए कि API NF-e NFC-e और CT-e दस्तावेजों के लिए सबसे वर्तमान मान्यता नियमों और संरचनाओं का उपयोग कर रहा है
सामान्य उपयोग के मामलों में ERP सिस्टम में लेजर आयात से पहले सप्लायर NF-e का मान्यकरण करना ई-कॉमर्स चेकआउट के दौरान CT-e/NF-e का पूर्व-मान्यकरण करना और दस्तावेज़-इन्टेक पाइपलाइनों में अनुपालन सुनिश्चित करना शामिल है
उपयोगकर्ता "valid" ध्वज की जांच करके यह निर्धारित करने के लिए returned डेटा का उपयोग कर सकते हैं कि XML मान्य है "errors" सरणी की समीक्षा करके विशेष समस्याओं के लिए और अनुपालन के लिए किसी भी नगरपालिका-विशिष्ट चेतावनियों को संबोधित कर सकते हैं
मानक डेटा पैटर्न में मान्य दस्तावेजों के लिए सत्य के "मान्य" ध्वज, एक खाली "त्रुटियाँ" ऐरे और अवैध दस्तावेजों के लिए विशिष्ट त्रुटि कोड जैसे MISSING_REQUIRED या INVALID_FORMAT शामिल हैं जो मुद्दों पर स्पष्ट प्रतिक्रिया प्रदान करते हैं
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
0ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
778ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
711ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,371ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,116ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
876ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
6,721ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
108ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
22ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
11,333ms