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 } ] }'
Arquitectura de la API y endpoints
La API de Factus Easy está diseñada bajo principios REST con endpoints claros para cada recurso.
Endpoints principales
/api/auth/login
Autenticación y obtención de token de acceso
/api/register
Registro de nuevas empresas emisoras
/api/document
Emisión de documentos electrónicos (factura, nota de crédito, retención)
/api/document/status
Consulta del estado de un documento por clave de acceso
Todos los endpoints aceptan y devuelven JSON. Las respuestas siguen una estructura uniforme con
los campos success, data y message.
La documentación completa incluye ejemplos de request y response para cada tipo de documento.
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.
Autenticación y seguridad
La API utiliza múltiples capas de seguridad para proteger tus datos y garantizar la integridad de los documentos.
API Key y tokens JWT
La autenticación se realiza mediante API Key en el header Authorization: Bearer tu-api-key.
Cada petición debe incluir este header. Las claves se generan automáticamente al crear tu cuenta
y pueden rotarse desde el dashboard en cualquier momento.
Idempotency-Key
Cada petición de emisión de documentos debe incluir un header Idempotency-Key
con un UUID único. Esto garantiza que aunque la petición se repita por un error de red, el documento
solo se procese una vez, evitando duplicados en tu contabilidad.
Cifrado en tránsito y reposo
Todas las comunicaciones con la API usan TLS 1.3. Los certificados digitales y datos sensibles se almacenan cifrados en reposo. No almacenamos ni tenemos acceso a las claves privadas de tus certificados digitales.
Rate limiting
La API implementa rate limiting para proteger la estabilidad del servicio. Cada API Key tiene un límite de peticiones por minuto. Si excedes el límite, recibirás un código HTTP 429 (Too Many Requests) con instrucciones sobre cuándo reintentar.
Manejo de errores
La API devuelve códigos HTTP estándar y mensajes descriptivos para facilitar la depuración.
| Código | Significado | Acción recomendada |
|---|---|---|
| 200 | Documento procesado exitosamente | El documento fue autorizado o está en proceso |
| 400 | Error de validación | Revisa el campo errors en la respuesta para corregir los datos |
| 401 | No autorizado | Verifica que tu API Key sea correcta y esté activa |
| 409 | Idempotency-Key duplicada | Ya se procesó una petición con esa misma clave de idempotencia |
| 429 | Demasiadas peticiones | Espera al tiempo indicado en el header Retry-After y reintenta |
| 500 | Error interno del servidor | Reintenta automáticamente. Si persiste, contacta a soporte |
Todos los errores devuelven una estructura JSON consistente: {"success": false, "message": "...", "errors": {...}}.
El campo errors contiene detalles específicos sobre qué campos fallaron y por qué.
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.
¿Puedo integrar la API desde un entorno que no sea web?
Sí. Al ser una API REST, puedes consumirla desde aplicaciones de escritorio, apps móviles, scripts de consola o cualquier sistema que soporte peticiones HTTP. Solo necesitas conexión a internet.
¿Qué pasa si mi API Key se ve comprometida?
Puedes rotar (regenerar) tu API Key desde el dashboard en cualquier momento. La clave anterior se desactiva inmediatamente. Te recomendamos rotar las claves periódicamente.
¿Ofrecen SDKs o librerías para lenguajes específicos?
Actualmente ofrecemos documentación REST, ejemplos en curl y una colección de Postman. Al ser una API REST estándar, puedes generar tu propio cliente HTTP en cualquier lenguaje con la documentación disponible.
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