{
"status": "ok"
}
curl --location --request GET 'https://zylalabs.com/api/13427/costa+rica+e-invoice+validator+api+-+hacienda/29087/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
{
"valid": true,
"wellFormed": true,
"inputFormat": "xml",
"documentType": "FacturaElectronica",
"version": "4.4",
"signatureValid": true,
"errorCount": 0,
"warningCount": 0,
"findings": [
{
"level": "info",
"ruleId": "CR-STRUCT-VERSION",
"text": "Namespace declares Hacienda comprobante schema v4.4 (https://cdn.comprobanteselectronicos.go.cr/xml-schemas/v4.4/facturaElectronica).",
"location": null,
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-STRUCT-XSD",
"text": "Document is valid against the Hacienda v4.4 FacturaElectronica structural XSD.",
"location": null,
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-SYSID-OK",
"text": "System Identification node <ProveedorSistemas> present (v4.4 requirement).",
"location": "ProveedorSistemas",
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-CLAVE-CONSECUTIVO",
"text": "Clave consecutivo segment matches <NumeroConsecutivo>.",
"location": "Clave",
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-CLAVE-TIPO",
"text": "Tipo de comprobante '01' matches the root <FacturaElectronica>.",
"location": "NumeroConsecutivo",
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-MATH-COMPROBANTE",
"text": "ResumenFactura totals reconcile to TotalComprobante.",
"location": "ResumenFactura/TotalComprobante",
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-SIG-CERT",
"text": "Embedded signing certificate: subject 'C=CR,O=Persona Juridica,CN=EMPRESA EJEMPLO SA', issuer 'C=CR,O=Persona Juridica,CN=EMPRESA EJEMPLO SA'.",
"location": "ds:X509Certificate",
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-SIG-CERTDIGEST",
"text": "XAdES SigningCertificate/CertDigest matches SHA-256 of the embedded certificate.",
"location": "xades:SigningCertificate",
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-SIG-EPES-POLICY",
"text": "XAdES-EPES SignaturePolicyIdentifier present (explicit signature policy referenced).",
"location": "xades:SignaturePolicyIdentifier",
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-SIG-DOC-DIGEST",
"text": "Document digest VERIFIES: recomputed SHA-256 over the enveloped document (ds:Signature removed, inclusive Canonical XML) matches the signed DigestValue.",
"location": "ds:Reference[@URI='']",
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-SIG-PROPS-DIGEST",
"text": "SignedProperties digest VERIFIES: recomputed SHA-256 over the canonicalized xades:SignedProperties matches the signed DigestValue.",
"location": "ds:Reference[@URI='#signed-props']",
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-SIG-VALUE",
"text": "SignatureValue VERIFIES: RSA-SHA256 over the canonicalized SignedInfo checks out against the embedded certificate's public key.",
"location": "ds:SignatureValue",
"occurrences": 1
},
{
"level": "info",
"ruleId": "CR-SIG-TRUST",
"text": "Trust chain to a Costa-Rica CA (the 'Sistema Nacional de Certificacion Digital' / MICITT root and its policy CAs) is NOT verified here; that requires the SINPE/MICITT CA list and, for full assurance, an online Hacienda check. Structure and the embedded-certificate crypto are checked offline.",
"location": null,
"occurrences": 1
}
]
}
curl --location --request POST 'https://zylalabs.com/api/13427/costa+rica+e-invoice+validator+api+-+hacienda/29088/validate+e-invoice' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '
50615092500310112345600100001010000000001112345678
3101123456
620100
00100001010000000001
2025-09-15T10:00:00-06:00
Empresa Ejemplo Sociedad Anonima
02
3101123456
1
01
01
Direccion de ejemplo, edificio central
[email protected]
Cliente Ejemplo
01
0102030405
01
1
8511000000000
1.000
Unid
Servicio de ejemplo para prueba
10000.00000
10000.00000
10000.00000
10000.00000
01
08
13.00
1300.00000
0.00000
1300.00000
11300.00000
CRC
1.00000
10000.00000
10000.00000
10000.00000
0.00000
10000.00000
1300.00000
11300.00000
bAhSYwtm5VWtis0RL+Nc7RZ/ZgDpx2VBSPKtVGeGRnQ= 34a+NpJTPGRMmCV+ln29wdgoinHY08vm6/tCeTrZ4H8= rGxnpJEbB6M7EP9AJRZDj2IJVIA6cG6kWszdeLVBqpoztFWi/qWdgBEybntcKoxaJ3ayyIG9jx7niHTjOXnp/ndPvbbInXVycNQM2r3i/TIb5QpLvHBgqtY3OKI3HuTknBKQNJJgwczExMGYFG/wUCzn2bvPULkUwsURHC5/ovNIVjc91HZq3Vg64HGHnjcbo2zaIbozOweYn7hQ8NrssPGgCytJ3dZfCCLDMMK/cUqzHkv9NBrBd0O13C8NPGEVhaS2kavbsb2YFS4na2Hp9+rrqib/GtyMWMf96FkPiY47vBInqTmCnMMEdeHqxgbKBhoa+rZ3ms7bdSVBiFSgyw== MIIDHDCCAgSgAwIBAgIGAZ+oZv99MA0GCSqGSIb3DQEBCwUAMEUxGzAZBgNVBAMMEkVNUFJFU0EgRUpFTVBMTyBTQTEZMBcGA1UECgwQUGVyc29uYSBKdXJpZGljYTELMAkGA1UEBhMCQ1IwHhcNMjYwNzI4MTAwNTUwWhcNMjcwNzI4MTEwNTUwWjBFMRswGQYDVQQDDBJFTVBSRVNBIEVKRU1QTE8gU0ExGTAXBgNVBAoMEFBlcnNvbmEgSnVyaWRpY2ExCzAJBgNVBAYTAkNSMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4k7ACXaxt1+Sf6Q+JDI8bs9uxPY6m0JKuDdLbrkeDSUP8QVfBIq/dVOTJ8soq55A0Stz0feS86lS0HvP3MQESbYomwbHIaeD00p9m4KoPX5f4otzaI5nuCE90kj0SkNCiKJUmbiUlPdAUawhD/PfmffpcFh7GT9KNXlCXmwSCzg7GlCRCrPF/ysE9n7bpQvCzDeNY96GCvsEvMj3huopln+qlXILo+mA/WplGocVWUANfot9K7DWFeN+cRujfIW71HjL5eByvI0zySd1cF3DVtcxb3VHvLLqNZuaOEkPUsoL3umoTqad6AkXCjDiCzrO04QRX+MPQfho6Rce0etHjwIDAQABoxIwEDAOBgNVHQ8BAf8EBAMCBsAwDQYJKoZIhvcNAQELBQADggEBALLN1ekF/A6vVYktftYGbTCB3+GE/7ES0939UqBp+ZxRIn3kvi1diPzn0+MFNwjsexTj7xOg7M6TzJnK8ew91rSDGD6evfllcn8oAo8kxcEisAK/Zx/pAB5Ni9kcnnSVVWOnEGUMtrmv5eVvUFFGS7tDDpCcIEiQLRoQEIIeFw35d1R5pLC+zT872NnoO3jPk7DDGP8vYII5BZCW6JUkJymvrRLM/jLc/1owHXICSAVY7UUX/5ptKYf1A2R4yq79x/M5Yq9LETwy3mWAZ4hrMx2/2R0V3dU4vo3CAG/VWIxORJlFgv7jaVULtkb/CRZigBkUurgy75iUN+bmDZUNSi0= 2025-09-15T10:00:05-06:00 /qdHl5jxomu5xM4OC2BQt69+SgFUXVv4Ib8uEr8Qvo4= C=CR,O=Persona Juridica,CN=EMPRESA EJEMPLO SA 1785236750205 https://tribunet.hacienda.go.cr/docs/esquemas/2016/v4.4/Resolucion_General_MH-DGT-RES-0027-2024.pdf KN6/2eZEAduZ3t0sn4aWMv8nmpGdaIcSso99Bp9QT04= '
साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए कोस्टा रिका ई-इनवॉइस वेलिडेटर एपीआई - हैसिंडा API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)
कीलेस कोस्टा रिका हेरिटेज v4.4 comprobante validator: 8 दस्तावेज़ प्रकारों के लिए आधिकारिक XSD, 50-अंकीय क्लावे न्यूमेरिका, CABYS कोड सूचियों, टोटल/IVA गणित, XAdES-EPES हस्ताक्षर जांच. नियम-कोडित JSON r
GET स्वास्थ्य जांच अंत बिंदु एक सरल JSON ऑब्जेक्ट लौटाता है जो सेवा की स्थिति को इंगित करता है जबकि POST वैलिडेट ई-इनवॉइस अंत बिंदु एक विस्तृत JSON वैलिडेशन रिपोर्ट लौटाता है जिसमें वैधता दस्तावेज़ प्रकार संस्करण हस्ताक्षर की वैधता त्रुटि संख्या और Hacienda v4.4 मानकों के अनुपालन से संबंधित निष्कर्ष शामिल हैं
POST Validate ई-इनवॉइस प्रतिक्रिया में प्रमुख फ़ील्ड्स में "valid" "wellFormed" "documentType" "version" "signatureValid" "errorCount" "warningCount" और "findings" शामिल हैं जो मान्यता स्थिति और विशिष्ट अनुपालन मुद्दों पर अंतर्दृष्टि प्रदान करते हैं
प्रतिक्रिया डेटा JSON प्रारूप में संरचित है मुख्य सत्यापन स्थिति शीर्ष स्तर पर प्रस्तुत की गई है इसके बाद स्तर (सूचना चेतावनी त्रुटि) द्वारा वर्गीकृत विस्तृत निष्कर्ष दिए गए हैं जो विशिष्ट अनुपालन जांच और उनके परिणामों का वर्णन करते हैं
GET स्वास्थ्य जांच सेवा स्थिति प्रदान करती है जबकि POST ई-चालान को मान्य करने के लिए दस्तावेज़ प्रकार संस्करण हस्ताक्षर जांच और आधिकारिक XSD के आधार पर अनुपालन निष्कर्षों सहित व्यापक सत्यापन विवरण प्रदान करती है
POST Validate e-invoice एंडपॉइंट Comprobante Electronico का कच्चा XML अनुरोध शरीर के रूप में स्वीकार करता है कोई अतिरिक्त मापदंडों की आवश्यकता नहीं है क्योंकि दस्तावेज़ प्रकार XML सामग्री से स्वचालित रूप से पता लगाया जाता है
डेटा की सटीकता को कोस्टा रिका की हसीएंडा द्वारा स्थापित आधिकारिक XSD स्कीमाओं और मान्यता नियमों के पालन के माध्यम से बनाए रखा जाता है एपीआई इन मानकों के अनुपालन की जांच करता है यह सुनिश्चित करते हुए कि मान्यता परिणाम वर्तमान नियामक आवश्यकताओं को दर्शाते हैं
सामान्य उपयोग के मामलों में कोस्टा रिका के कर नियमों के अनुरूप इलेक्ट्रॉनिक चालानों को मान्य करना उचित दस्तावेज़ प्रारूप सुनिश्चित करना और एचेसिंडा को सबमिट करने से पहले ई-चालानों में डिजिटल सिग्नेचर की अखंडता को सत्यापित करना शामिल है
उपयोगकर्ता वापस किए गए डेटा का उपयोग करके सत्यापन रिपोर्ट की व्याख्या कर सकते हैं ताकि अनुपालन मुद्दों की पहचान की जा सके किसी भी त्रुटियों या चेतावनियों को संबोधित किया जा सके और यह सुनिश्चित किया जा सके कि उनके इलेक्ट्रॉनिक चालान कोस्टा रिका के हेसिंडा द्वारा स्वीकार करने के लिए आवश्यक मानकों को पूरा करते हैं