ब्राज़ील के 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": []
}
{"valid":true,"errors":[],"schema_version":"4.00","schema_kind":"nfe","municipality_specific_warnings":[]}
curl --location --request POST 'https://zylalabs.com/api/12681/nf-e+xml+validator+api/24570/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 प्रतिक्रिया लौटाता है जिसमें एक वैधता ध्वज, प्रति-तत्व त्रुटियों की सूची (पथों और त्रुटि कोड के साथ), स्वचालित रूप से पहचान की गई स्कीमा संस्करण, दस्तावेज़ प्रकार और किसी भी नगरपालिका-विशिष्ट चेतावनियों को शामिल किया जाता है
प्रतिक्रिया में प्रमुख क्षेत्रों में "मान्य" (बूलियन), "त्रुटियाँ" (त्रुटियों के ऑब्जेक्ट्स का एरे), "स्कीमा_संस्करण" (स्ट्रिंग), "स्कीमा_प्रकार" (स्ट्रिंग) और "विशिष्ट_नगरपालिका_चेतावनियाँ" (एरे) शामिल हैं
प्रतिक्रिया को एक 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 मान्य है या नहीं "त्रुटियों" श्रेणी की समीक्षा करके विशिष्ट मुद्दों के लिए और अनुपालन के लिए किसी भी नगरपालिका-विशिष्ट चेतावनियों का समाधान करके
मानक डेटा पैटर्न में मान्य दस्तावेजों के लिए "वैध" सच्चा संकेतक शून्य "त्रुटियों" का एक ऐरे और गैर-वैध दस्तावेजों के लिए विशिष्ट त्रुटि कोड जैसे FALTAN_REQUERIDO या FORMATO_INVALIDO शामिल है जो समस्याओं के बारे में स्पष्ट फीडबैक प्रदान करता है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,777ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
53ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,485ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
255ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
211ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
319ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
10,199ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
868ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
76ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,793ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,521ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
406ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
534ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,236ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
219ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
114ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
11,333ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
13,968ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,415ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,632ms