API de Facturación SRI para tu Software
Integra facturación electrónica SRI en tu ERP, eCommerce o sistema propio con una API REST simple. Envías JSON, nosotros generamos el XML, firmamos digitalmente y tramitamos la autorización ante el SRI.
¿Qué es una API de facturación SRI?
Una API de facturación SRI es una interfaz de programación que permite a tu software emitir documentos electrónicos autorizados por el Servicio de Rentas Internas de Ecuador sin implementar la lógica compleja de generación de XML, firma digital, envío y recepción con los web services del SRI.
En lugar de construir y mantener un módulo de facturación electrónica interno, tu sistema envía datos en formato JSON a nuestra API y nosotros nos encargamos de todo el proceso: generamos el XML con la estructura oficial del SRI, lo firmamos con el certificado digital, lo enviamos al ambiente correspondiente (pruebas o producción) y devolvemos el resultado con el número de autorización y el RIDE PDF.
Ejemplo de integración
Así de simple es emitir una factura electrónica desde tu sistema.
curl -X POST https://api.factuseasy.com/api/document \ -H "Authorization: Bearer tu-api-key" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: uuid-unico" \ -d '{ "type": "01", "company_id": "1", "customer": { "identification": "0999999999999", "name": "Cliente Final" }, "items": [ { "description": "Servicio de consultoría", "quantity": 1, "unit_price": 100.00 } ], "payments": [ { "code": "01", "total": 100.00 } ] }'
Características de la API
Todo lo que necesitas para integrar facturación electrónica SRI en tu software.
Firma digital automática
Sube tu certificado digital una vez. Los XML se firman automáticamente antes de enviarse al SRI.
Webhooks en tiempo real
Recibe notificaciones HTTP cuando un documento es autorizado o rechazado. No necesitas consultar manualmente.
RIDE PDF automático
Cada documento autorizado genera su representación gráfica (RIDE) en PDF automáticamente.
Reintento automático
Los documentos rechazados por errores temporales del SRI se reintentan automáticamente sin intervención.
Multi-ambiente
Trabaja en sandbox sin costo. Cambia a producción con un clic manteniendo el mismo código de integración.
Idempotency-Key
Evita duplicados aunque haya fallos de red. Cada petición incluye un identificador único para garantizar una sola ejecución.
Pasos para integrar la API
En menos de 1 día tu sistema puede estar emitiendo documentos electrónicos.
Crea tu cuenta
Regístrate gratis y obtén tus credenciales de API para el ambiente sandbox.
Configura tu empresa
Registra tu empresa con RUC, dirección y datos fiscales. Sube tu certificado digital.
Prueba en sandbox
Emite documentos de prueba sin costo. Valida tu integración con la documentación y ejemplos.
Pasa a producción
Activa producción y empieza a emitir documentos reales. Sin cambios en tu integración.
Documentación y recursos
Todo lo que necesitas para integrar está documentado y listo para usar.
Preguntas frecuentes sobre la API
Respuestas sobre integración y uso de la API de facturación SRI.
¿Qué lenguajes de programación soportan?
Nuestra API es REST, así que funciona con cualquier lenguaje que pueda hacer peticiones HTTP: PHP, JavaScript, Python, Java, C#, Ruby, Go, etc. Incluimos ejemplos en curl y una colección de Postman para empezar rápido.
¿Cómo obtengo mi API Key?
Al crear tu cuenta gratis, el sistema genera automáticamente tus credenciales de API. Las encuentras en tu dashboard en la sección de configuración.
¿Qué es Idempotency-Key y por qué es obligatorio?
Es un identificador único que envías en cada petición para garantizar que el documento se procese una sola vez, incluso si hay fallos de red y tienes que reintentar. Sin él, una misma petición repetida podría crear documentos duplicados.
¿Cómo funcionan los webhooks?
Configuras una URL en tu dashboard donde recibirás notificaciones POST cuando un documento cambie de estado. Así sabes en tiempo real si fue autorizado o rechazado sin tener que consultar la API periódicamente.
¿Hay límite de peticiones en el plan gratis?
En sandbox no hay límite. En producción, cada plan tiene un cupo mensual de documentos autorizados. El plan gratis incluye 50 documentos/mes para producción.
Integra la API de facturación SRI hoy
Obtén tu API Key gratis y empieza a emitir documentos electrónicos en menos de 1 día.
Obtener API Key gratis