Ctrl K⌘K
Actualizado: Markdown Abrir en Claude Abrir en ChatGPT
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 secuencial en 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#

No se pudo completar la operación. Recargar ✕

Conexión con el servidor

Restableciendo la conexión…

Intento 1 de 5.

No se pudo conectar. Revisa tu conexión y vuelve a intentarlo.

La sesión ya no está disponible. Recarga la página para continuar.

La sesión está en pausa. Puedes reanudarla para continuar.

No se pudo reanudar la sesión. Vuelve a intentarlo o recarga la página.

Al recargar se perderán los cambios que no hayas guardado.