Documentación de la API de HDC Billing CR

Qué recibe al solicitarla

• La referencia completa de los recursos, con sus parámetros y sus códigos de respuesta.
• La estructura del comprobante electrónico según la versión 4.4 del esquema de Hacienda.
• Ejemplos de llamada listos para adaptar al lenguaje de su sistema.
• Las credenciales del ambiente de pruebas, con su propio certificado y sus propios consecutivos.
• Un contacto técnico durante la integración.

Se entrega de forma privada y no se publica en el sitio. Es una decisión deliberada: la API mueve documentos tributarios a nombre de nuestros clientes, y preferimos saber quién se está integrando.

Cómo pedirla

Escríbanos a [email protected] o por WhatsApp al 6242-4229 contándonos qué sistema quiere integrar y con qué volumen de documentos trabaja. Le respondemos con la documentación y las credenciales de pruebas.

Antes de escribir, conviene saber

Es una API REST sobre HTTPS con autenticación OAuth 2.0. Se integra en el lenguaje que use su sistema —.NET, PHP, Node, Python o Java—, porque es HTTP con JSON y no hay que instalar ninguna librería nuestra.

La API emite comprobantes: no es un ERP por HTTP. Su inventario, sus precios, sus clientes y su lógica de negocio siguen en su sistema, y lo que viaja es el documento ya armado con sus líneas, sus impuestos y su receptor. Cuando Hacienda cambia el esquema, lo actualizamos nosotros.

Qué hace falta de su lado

• El certificado de firma digital del contribuyente con su PIN, que es lo que Hacienda exige para firmar a su nombre. Ver el PIN de la llave criptográfica.
• Códigos CABYS correctos en sus productos, porque de ahí sale la tarifa de IVA de cada línea. Para eso está el buscador de códigos CABYS, gratuito y sin registro.

Ambiente de pruebas

Se integra primero contra el ambiente de pruebas de Hacienda, con su propio certificado y sus propios consecutivos, y se pasa a producción cuando los documentos salen aceptados. Nadie estrena una integración facturando de verdad.