Timeout o conexión interrumpida
Conserva la misma identidad y consulta el documento existente. No generes otra clave para reenviar a ciegas la misma venta.
GUÍAS RUXI · ECUADOR
Integrar la API de facturación SRI: guía inicial
Integra Ruxi con idempotencia, estados asíncronos y descarga de XML y RIDE. Prepara tu integración en pruebas antes de emitir en producción.
Por Ruxi · Actualizado el
Integra el proceso completo,
no solo el envío.
Ruxi API recibe comprobantes, sigue la autorización del SRI y permite recuperar XML y RIDE. Configura tu empresa y una clave para el ambiente que elijas: pruebas o producción. Necesitas certificado vigente y capacidad disponible; no necesitas aprobación de Ruxi.
La clave identifica empresa, ambiente y permisos. Guárdala en tu servidor: no debe aparecer en JavaScript público, aplicaciones distribuidas ni repositorios. Consulta el contrato y sus ejemplos desde la documentación API de tu cuenta.
Una solicitud aceptada
todavía no es una factura autorizada.
Identifica la operación
Usa una Idempotency-Key estable para cada venta y conserva el contenido enviado.
Conserva la referencia
Una respuesta 202 devuelve el identificador del documento. Guárdalo aunque aún no haya clave de acceso.
Consulta el estado
Consulta por referencia o recibe los webhooks configurados para esa empresa y ambiente.
Entrega el resultado
Descarga XML y RIDE cuando el estado sea AUTORIZADO.
HTTP · Seguimiento ilustrativo, sin credenciales reales
GET /v1/comprobantes/REFERENCIA_DEL_DOCUMENTO
Authorization: Bearer TU_CLAVE_API
# Solo después de AUTORIZADO:
GET /v1/comprobantes/REFERENCIA_DEL_DOCUMENTO/xml
GET /v1/comprobantes/REFERENCIA_DEL_DOCUMENTO/rideEjecuta estas consultas desde tu servidor con una referencia propia. Las credenciales de pruebas no habilitan producción.
Resuelve la incertidumbre
sin duplicar la operación.
Conflicto 409
Comprueba que no estés reutilizando una clave con otro contenido. Usa el código del error para distinguir conflicto de idempotencia de otros conflictos operativos.
Rechazo o corrección
Lee los mensajes y el contrato del endpoint de corrección. Una corrección conserva el expediente fiscal y tiene su propia identidad; no equivale a crear otra factura.
Límites técnicos
que puedes planificar.
Emisión, consulta y descarga tienen límites por minuto independientes por clave y por cuenta. El tope por clave contiene una credencial concreta; el de cuenta suma todas las claves y empresas. Tu plan puede ampliar el tope de cuenta.
- Emisión, corrección y reenvío: 60 por minuto por clave · 300 por cuenta
- Consulta de comprobantes: 120 por minuto por clave · 600 por cuenta
- Descarga de XML/RIDE: 30 por minuto por clave · 120 por cuenta
Son valores de referencia configurables. Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset y X-RateLimit-Scope; ante un pico recibes 429 rate_limited con Retry-After. Consulta tus límites vigentes y los de tu plan en Suscripción y pagos, y el detalle en la documentación API de tu cuenta.
Separa las claves,
conserva las evidencias.
Limita permisos por integración y ambiente. Verifica las notificaciones según el contrato de webhooks y procesa las entregas repetidas de forma idempotente. No registres claves, certificados ni documentos fiscales completos en logs.
Para soporte, utiliza la referencia de la operación o X-Request-ID. Prueba los escenarios de conexión interrumpida, rechazo y notificación repetida antes de pasar a producción.
Cómo se comparten los planes y el saldo con Ruxi Web ↗Continúa con API de facturación.
Consulta disponibilidad, requisitos y precios vigentes antes de elegir.
Ver API de facturación ↗