En esta página
Continuidad y salida
Qué disponibilidad esperar, cómo se comparte tu cupo, cuánto tiempo conservamos tus documentos y cómo recuperarlos si dejas de usar el servicio.
Antes de integrar un servicio de facturación en tu sistema es razonable preguntar qué pasa si el servicio falla, cuánto cuesta quedarte sin cupo y cómo te llevas tus documentos si algún día decides irte. Esta página responde esas preguntas con lo que puedes comprobar como integrador, para que las incluyas en tu evaluación y en el diseño de tu sistema.
Al terminar sabrás qué objetivo de disponibilidad tenemos, cómo protegerte de un cupo agotado, cuánto tiempo conservamos tus documentos y qué pedir a soporte para recuperarlos.
Disponibilidad#
Nuestro objetivo de disponibilidad de la API en producción es de 99,9 % mensual. Se mide sobre la recepción y el procesamiento de tus comprobantes. La autorización del SRI es una dependencia externa y no forma parte de este objetivo. Es un objetivo de servicio y no una garantía contractual; si tu organización necesita una cláusula formal, pídela a soporte antes de contratar.
Puedes revisar el estado del servicio en cualquier momento en la página de estado, que muestra la disponibilidad de los últimos 90 días y los incidentes. Los mismos datos están en GET /estado, sin API Key, para que los consultes desde tus propias alertas; la guía Estado del servicio explica el formato y el límite de consultas. Si tu sistema recibe un 503 con el codEstado 5002 (servicio_no_disponible), espera los segundos que indica Retry-After y reenvía el mismo comprobante con la misma Idempotency-Key: así no se duplica aunque la primera petición haya llegado. El detalle de qué errores se reintentan está en Buenas prácticas y en Errores.
| Compromiso | Valor |
|---|---|
| Objetivo de disponibilidad de la API en producción | 99,9 % mensual |
| Autorización del SRI | Dependencia externa; se informa por separado |
| Atención de soporte | Lunes a viernes, de 09:00 a 18:00 (GMT-5) |
| Primera respuesta | 1 día hábil |
| Primera respuesta si producción está caída | 4 horas |
| Canales | Ticket, centro de ayuda, WhatsApp y contacto |
Seguridad de tus llaves#
Cada API Key tiene dos límites que defines tú al crearla: los servicios que puede usar y los RUC sobre los que puede actuar. Una llave limitada a un RUC no puede emitir ni consultar a otro contribuyente, y una llave comprometida solo da acceso a lo que le asignaste. Además, en producción la API solo acepta peticiones desde las IP que registraste.
Si sospechas que una llave se filtró, crea otra, cámbiala en tu sistema y revoca la anterior; la revocación se aplica en un máximo de 30 segundos. Los pasos están en Autenticación, y cómo limitar una llave, en Scopes y RUC de una API Key.
Cupo#
Tu cupo se comparte entre todos los RUC de tu integración. No existe un reparto por RUC: si emites para varios contribuyentes, todos descuentan del mismo saldo, y uno que emite mucho puede agotar el de los demás.
Consumen cupo los comprobantes que terminan autorizados o rechazados por el SRI; un comprobante cancelado no consume cupo. El detalle por estado está en Consumo y cuotas.
Atención
Si tu cupo se agota, la emisión de todos tus RUC se detiene hasta que renueves o compres un paquete. Controla tu saldo desde tu propio sistema.
| Situación | Respuesta de la emisión | Qué hacer |
|---|---|---|
| Te quedan documentos | 202 Accepted | Sigue emitiendo. |
| No te quedan documentos | 429 con el codEstado 4004 (cupo_agotado) |
Compra un paquete; no reintentes. |
Consulta tu saldo con GET /v1/consumo antes de enviar un lote grande y configura una alerta en tu sistema para avisar a tu equipo cuando queden pocos documentos.
Conservación de tus documentos#
Conservamos tus comprobantes durante siete años, el plazo que exige la normativa tributaria del SRI. En ese tiempo puedes descargar el XML y el RIDE de cualquier comprobante con su clave de acceso y consultar el historial de operaciones.
| Qué necesitas | Cómo lo obtienes |
|---|---|
| Un comprobante | Descarga el XML o el RIDE con su clave de acceso. |
| Los comprobantes de un período | Usa el listado de operaciones o el comando ecuafact operaciones listar. |
| Todos tus documentos | Solicita una exportación masiva a soporte. |
Exportación masiva#
Si necesitas llevarte todos tus documentos, por ejemplo para un respaldo, una auditoría o un cambio de proveedor, abre un ticket en soporte.ecuafact.com. Escribe desde el correo registrado del titular de la cuenta o del contribuyente, e indica el RUC, el rango de fechas y los tipos de comprobante que necesitas.
Te entregamos la exportación en un plazo de 5 días hábiles desde que verificamos tu solicitud. Si el volumen es grande, acordamos contigo otro plazo al recibirla. La primera exportación no tiene costo.
La exportación llega como un archivo comprimido con esta estructura:
| Contenido | Descripción |
|---|---|
| Una carpeta por RUC | Dentro de cada una, el XML y el RIDE de cada comprobante, nombrados con su clave de acceso. |
| Un archivo CSV de índice | Una fila por comprobante, con la clave de acceso, el tipo, el número, la fecha, el estado y el total. |
| Un archivo de sumas de verificación | El SHA-256 de cada archivo, para que compruebes que no se alteró. |
Te enviamos un enlace de descarga privado que vence a los pocos días; nunca enviamos los documentos como adjuntos de correo.
Si terminas tu contrato#
No eliminamos tus documentos cuando termina tu contrato: te los entregamos. Solicítalos a soporte y recibirás tu archivo completo de comprobantes.
Para que tu salida sea sencilla, ten presente lo siguiente:
- Tu certificado de firma electrónica pertenece al contribuyente.
- Si envías tu propio
secuencialen cada comprobante, tu numeración es tuya. Si lo omites y lo asignamos nosotros, consulta el último número de cada serie en el listado de operaciones o pídelo a soporte para continuarlo en tu nuevo sistema. - Guarda en tu sistema el XML autorizado y la clave de acceso de cada comprobante, como recomienda Descargar XML.
Siguientes pasos#
- Límite de request: conoce cuántas solicitudes por minuto puedes hacer.
- Consumo y cuotas: consulta cuántos documentos te quedan.
- Autenticación: limita tus llaves por servicio y RUC.
- Estado del servicio: consulta la disponibilidad actual y los incidentes.