Conecta tu sistema y factura al SRI
Tu ERP, punto de venta, e-commerce o app envía el JSON; nosotros firmamos con el certificado del emisor, transmitimos al SRI y te devolvemos el RIDE y el XML autorizado.
Ambiente de Pruebas del SRI incluido · Sin tarjeta de crédito
curl -X POST https://contadeo.com/api/comprobantes/factura \
-H "Authorization: Bearer cdo_tu_api_key" \
-H "Idempotency-Key: pedido-8841" \
-H "Content-Type: application/json" \
-d '{ "emisorId": "…", "cliente": { … }, "items": [ … ] }'
# 202 Accepted — nosotros firmamos y transmitimos al SRI
{ "id": "c0ffee…", "estado": "BORRADOR", "claveAcceso": "2308…" }Integra tu sistema en tres pasos
Sin contratos ni llamadas de ventas: la cuenta y la API key se crean solas.
Crea la cuenta y registra el emisor
El RUC se precarga desde el catastro del SRI. Gratis, sin tarjeta.
Sube la firma .p12
Queda cifrada (AES-256-GCM) y solo se usa en el momento de firmar.
Genera tu API key y emite
Desde Configuración → API. Primero en Pruebas; a Producción cuando quieras.
¿Tu plataforma sirve a varias empresas? En autoservicio, cada empresa crea su cuenta y te entrega su API key: tu app las guarda y emite en nombre de cada una, con los datos aislados por cuenta. Si prefieres dar de alta a tus clientes tú mismo, mira la marca blanca.
Hecho para integraciones de verdad
Lo que hay detrás del endpoint: las piezas que evitan los incidentes de fin de mes.
Emisión asíncrona con idempotencia
202 al instante; el estado se consulta o te llega por webhook. Reintenta con la misma Idempotency-Key sin duplicar facturas ni quemar secuenciales.
Lotes de hasta 100
POST /comprobantes/lote emite hasta 100 facturas por request con semántica parcial: las válidas avanzan y las inválidas se reportan una a una. Solo el cupo agotado (402) detiene el resto, y reintentar el mismo lote es seguro por idempotencia.
Webhooks firmados
HMAC-SHA256 en cada entrega, 8 reintentos con backoff y bitácora consultable. Tu servidor se entera al autorizarse, sin polling.
RIDE y XML listos
El PDF y el XML autorizado se descargan por URL prefirmada válida 1 hora, o le llegan al comprador por email automáticamente.
API keys autoservicio
Se crean y revocan al instante desde Configuración → API, con permisos de privilegio mínimo. Hasta 5 activas por cuenta.
Ambiente de Pruebas del SRI
Emite contra el ambiente de certificación sin gastar tu cupo (hasta 500 al mes) y pasa a Producción cuando quieras.
SDK y OpenAPI
SDK TypeScript (contadeo-sdk) con verificación de firmas incluida, spec OpenAPI 3.1 y referencia navegable para generar clientes en tu lenguaje.
Versionado con aviso
Cambios incompatibles con 90 días de aviso vía X-API-Version. Tu integración no se rompe un martes cualquiera.
Validación de RUC
GET /sri/ruc/:ruc consulta el catastro del SRI con caché resiliente: razón social, estado, régimen, obligado a contabilidad y si tu contraparte es agente de retención. Siempre responde 200 con veredicto.
Tu servidor se entera solo
Registra un endpoint y cada comprobante autorizado, rechazado o devuelto llega firmado a tu backend. Verificas la firma con el SDK o con 5 líneas de HMAC.
- Firma HMAC-SHA256 con secreto rotable
- 8 reintentos con backoff si tu servidor no responde
- Bitácora de entregas para diagnosticar sin adivinar
POST https://miapp.com/contadeo/webhook
X-Contadeo-Signature: t=1787000000,v1=6f1a…
x-contadeo-evento: comprobante.autorizado
{
"evento": "comprobante.autorizado",
"claveAcceso": "2308…",
"tipoComprobante": "01",
"estado": "AUTORIZADO",
"numeroAutorizacion": "2308…"
}
Hecho para operar, no solo para el demo
Límites por cuenta, no por IP: 300 req/min, 60 emisiones/min, 10 lotes/min. Tus picos no compiten con el resto del tráfico de tu datacenter.
El SRI se cae; tú no: reintentos automáticos y contingencia integrada. Sigues emitiendo y los comprobantes se autorizan cuando el servicio vuelve.
Datos protegidos: certificados cifrados con AES-256-GCM, aislamiento por cuenta a nivel de base de datos y tratamiento conforme a la LOPDP.
Marca blanca: factura por tus clientes
Si tu software atiende a muchas empresas, el programa OEM te deja darlas de alta y operarlas desde tu propia plataforma, sin que pasen por contadeo.com.
Integra tu sistema
Autoservicio, disponible hoy mismo.
- Cada empresa crea su cuenta y te entrega su API key
- Emites en nombre de cada una con su propia credencial
- Cada cuenta paga su plan (desde $0)
Marca blanca (OEM)
Por solicitud, con aprobación manual.
- Das de alta una cuenta por cliente vía API, desde tu plataforma
- Una sola partner key opera toda tu cartera
- Webhooks a tu backend y facturación mayorista por cortes
- Sin mínimo de comprobantes para empezar
Por la Resolución NAC-DGERCGC26-00000027, cada comprobante declara el RUC del proveedor del software que lo emitió.
¿Cuánto te costaría facturar con nosotros?
Dinos cuántos comprobantes emites al mes y te decimos el plan que te conviene y lo que pagarías al año.
Preguntas frecuentes
¿Puedo dar de alta las cuentas de mis clientes desde mi plataforma?
Sí, con el programa de marca blanca: una partner key aprovisiona una cuenta por cliente y las opera todas. Requiere solicitud y aprobación. En el modo autoservicio, cada empresa crea su propia cuenta y te entrega su API key.
¿Necesito la firma electrónica de cada emisor?
Sí: el SRI exige firmar cada comprobante con el certificado .p12 del emisor. Cada empresa lo sube una vez a su cuenta y queda cifrado (AES-256-GCM); tu sistema nunca lo toca.
¿Cómo pruebo sin emitir documentos reales?
Cada cuenta arranca en el ambiente de Pruebas del SRI: los comprobantes se firman y autorizan de verdad contra el ambiente de certificación, sin validez tributaria y sin gastar el cupo del plan.
¿Qué límites tiene la API?
300 requests/min por cuenta (no por IP), 60 emisiones/min y 10 lotes/min. Si los superas recibes 429 con reintento seguro gracias a la idempotencia.
¿Cuánto cuesta?
La API no cuesta aparte: los comprobantes emitidos consumen el cupo del plan de cada cuenta (desde $0). En marca blanca la tarifa es mayorista por comprobante y se acuerda al aprobar la solicitud. No pedimos mínimos de volumen para entrar al programa.
Tu primera factura por API, hoy
Crea la cuenta, prueba contra el ambiente de certificación del SRI y pasa a Producción cuando tu integración esté lista.
¿Prefieres conversar con tu IA? Conoce el servidor MCP