Contadito Invoicing API

Emite facturas de venta legalmente válidas en Honduras desde tu propia aplicación: tu punto de venta, tu tienda en línea, tu sistema de reservas o cualquier cosa que ya tengas corriendo.

Tú mandas el cliente y las líneas de la venta; Contadito se encarga del CAI, del correlativo, del ISV, de las exoneraciones y del total en letras.

Qué puedes hacer hoy (v1)

Puedes	Endpoint
Verificar que la API está arriba	GET /v1/health
Registrar un cliente	POST /v1/clients
Listar tus clientes	GET /v1/clients
Emitir una factura de contado	POST /v1/invoices
Probar sin emitir nada	POST /v1/invoices/preview
Consultar una factura emitida	GET /v1/invoices/{id}
Descargar el PDF de una factura	GET /v1/invoices/{id}/pdf

Lo que todavía no entra en v1 (facturas al crédito, anulaciones, catálogo de productos por API, listado de facturas, fechas retroactivas) está listado en Límites de la v1. Léelo antes de diseñar tu integración, no después.

Lo mínimo que tienes que saber

1. Te autenticas con una API key en Authorization: Bearer ctd_sk_…. La key identifica a tu empresa: no hay que enviarla en ningún campo de la solicitud. Ver Autenticación.

2. Antes de facturar, el equipo de Contadito debe habilitarte. Hay que activar la integración de tu empresa y mapear tus ids de producto a los productos de Contadito. Ver Primeros pasos.

3. Crear una factura exige un Idempotency-Key. La numeración de facturas está regulada por el SAR: una factura duplicada no es un problema de datos, es un problema de cumplimiento. Ver Idempotencia y reintentos.

4. Empieza probando. Cada POST /v1/invoices emite una factura legal, así que mientras construyes tu integración usa POST /v1/invoices/preview: mismos cálculos y mismo PDF, sin consumir CAI. Ver Pruebas.

5. Los errores siempre traen code y message separados. Programa contra code; trata message como texto para humanos que puede cambiar de redacción. Ver Errores.

URL base

https://integration.contadito.com

Todas las rutas cuelgan de /v1. Cualquier otra ruta en ese host responde 404.

Empieza por aquí

Si estás armando tu integración, empieza por Pruebas: ahí se prueba todo sin emitir facturas reales.

Si ya quieres el recorrido completo hasta una factura emitida, ve a Tu primera factura.