Validador de comprovante Keyless Costa Rica Hacienda v4.4: XSD oficial para 8 tipos de documentos, a chave numérica de 50 dígitos, listas de códigos CABYS, totalizações/matemática de IVA, verificação de assinatura XAdES-EPES. JSON codificado em regras r
{
"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= '
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a API Validador de e-Invoice da Costa Rica - Hacienda API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
Validador de comprovantes Keyless Costa Rica Hacienda v4.4: XSD oficial para 8 tipos de documentos, a clave numérica de 50 dígitos, listas de códigos CABYS, totais/matemática do IVA, verificação de assinatura XAdES-EPES. JSON codificado por regras r
O endpoint de verificação de saúde GET retorna um simples objeto JSON indicando o status do serviço enquanto o endpoint POST Validar e-fatura retorna um relatório de validação JSON detalhado que inclui campos como validade tipo de documento versão validade da assinatura contagem de erros e constatações relacionadas à conformidade com os padrões da Hacienda v4.4
Os campos-chave na resposta de validação do e-invoice POST incluem "válido" "bemFormado" "tipoDeDocumento" "versão" "assinaturaVálida" "contagemDeErros" "contagemDeAvisos" e "constatações" que fornecem insights sobre o status da validação e problemas específicos de conformidade
Os dados de resposta estão estruturados em um formato JSON O status de validação principal é apresentado no nível superior seguido por conclusões detalhadas categorizadas por nível (info aviso erro) que descrevem verificações de conformidade específicas e seus resultados
A verificação de saúde GET fornece o status do serviço enquanto a validação de e-invoice POST oferece detalhes abrangentes de validação para faturas eletrônicas incluindo tipo de documento versão verificações de assinatura e constatações de conformidade com base nos XSDs oficiais
O endpoint POST Validate e-invoice aceita o XML bruto do Comprobante Eletrônico como o corpo da solicitação Nenhum parâmetro adicional é necessário pois o tipo de documento é detectado automaticamente a partir do conteúdo XML
A precisão dos dados é mantida por meio da adesão a esquemas XSD oficiais e regras de validação estabelecidas pela Hacienda da Costa Rica A API verifica a conformidade com esses padrões garantindo que os resultados da validação reflitam os requisitos regulatórios atuais
Casos de uso típicos incluem validar faturas eletrônicas para conformidade com as regulamentações fiscais da Costa Rica garantir o formato adequado dos documentos e verificar a integridade das assinaturas digitais em e-faturas antes da submissão à Hacienda
Os usuários podem utilizar os dados retornados interpretando o relatório de validação para identificar problemas de conformidade abordando quaisquer erros ou avisos e garantindo que suas faturas eletrônicas atendam aos padrões necessários para aceitação pela Hacienda da Costa Rica