Envía el comprobante.
Usa tu clave API y una clave de idempotencia para identificar la operación.
RUXI API · PARA DESARROLLADORES
Integra la
facturación electrónica
en tu software.
Integra la facturación electrónica de Ecuador en tu aplicación con Ruxi API. Envía comprobantes al SRI desde tu servidor. Consulta su estado, recibe webhooks y descarga el XML autorizado y el RIDE en PDF.
Crear mi cuenta
Crea tu acceso. Luego elige pago por uso o un plan.
API REST · Seis tipos de comprobantes · Webhooks
Requisitos para integrar la API SRI ↗TIPOS DE COMPROBANTESFacturasNotas de crédito y débitoRetencionesGuías y liquidaciones
01 / ENVÍO Y AUTORIZACIÓN
Envía el comprobante.
Consulta la autorización.
De tu venta a tu facturaEXPLORA RUXI
01 — UNA SOLICITUD DESDE TU SOFTWAREEnvía una solicitud.
Consulta el resultado.
Consulta el resultado.
HTTP · Ejemplo ilustrativoAPI REST
POST /v1/comprobantes/factura
Authorization: Bearer TU_CLAVE_API
Idempotency-Key: venta-demo-001
// Respuesta asíncrona
202 Accepted
// Consulta el estado y descarga
// XML + RIDE después de autorizar.El cuerpo de la solicitud se describe en la documentación API.
- 01 Emisión
- 02 Autorización SRI
- 03 XML + RIDE
La recepción es asíncrona. La autorización depende del SRI.
Sigue su estado.
La emisión es asíncrona. Consulta el resultado o recibe notificaciones con webhooks.
Entrega los documentos.
Descarga XML y RIDE cuando el comprobante esté autorizado por el SRI.
02 / ADMINISTRA LA INTEGRACIÓN
Empresas, claves
y consumo.
Un portal para tus empresas.
Administra datos fiscales, certificados, claves API y consumo desde tu cuenta.
Pruebas y producción separadas.
Configura pruebas o producción y empieza cuando decidas, sin aprobación de Ruxi.
Revisa el consumo de tus empresas.
Compara empresas y cupos de documentos. Solo los autorizados en producción consumen cupo.
SALDO PREPAGO · PAGO POR USO
Empieza con saldo.
Sin suscripción obligatoria.
Emite por API con saldo prepago. Paga por cada documento autorizado. Tu saldo se conserva para próximas emisiones.
Total a pagar $11.50 USD
$10.00 de saldo · 250 documentos estimados.
Incluye $1.50 de IVA. Tarifa estándar: $0.04 por documento antes de IVA. El saldo no vence.
Cambiar importe de recarga
ASÍ RINDE TU SALDOEJEMPLO
250documentos estimados
Saldo del ejemplo$10.00
Solo los autorizados en producción descuentan saldo. Los documentos en proceso reservan su importe.
Tu saldo no vence. El saldo disponible se conserva para futuras emisiones.
Una empresa / RUC en la tarifa estándar. Web y API comparten el mismo saldo.
Tú decides cuándo recargar. Sin cobros automáticos. El uso de saldo al agotar un plan requiere tu autorización.
Aporta tu firma electrónica, verifica tu correo y, si quieres, activa la verificación en dos pasos. Después de tu recarga confirmada podrás registrar tu empresa en pruebas o producción, sin aprobación de Ruxi. Transferencia y DeUna requieren revisión manual.
03 / PLANES DE SUSCRIPCIÓN
Planes para la API.
Compara cupos y empresas.
La firma electrónica la aporta tu empresa. Web y API comparten una suscripción, cupo y empresas. El plugin WooCommerce conserva su licencia independiente.
RUXI API
Inicio
$29.99+ IVA / año
Total a pagar: $34.49 USD
- 500 documentos por mes
- Hasta 1 empresa / RUC
- Los seis tipos de comprobantes por API
- XML, RIDE y tus empresas en una cuenta
- Límites de cuenta ampliados: 60 emisión/min · 120 consulta/min · 30 descarga/min
RECOMENDADO
Negocio
$99.00+ IVA / año
Total a pagar: $113.85 USD
- 2.500 documentos por mes
- Hasta 5 empresas / RUC
- Los seis tipos de comprobantes por API
- XML, RIDE y tus empresas en una cuenta
- Límites de cuenta ampliados: 150 emisión/min · 360 consulta/min · 90 descarga/min
RUXI API
Escala
$249.00+ IVA / año
Total a pagar: $286.35 USD
- 7.500 documentos por mes
- Hasta 10 empresas / RUC
- Los seis tipos de comprobantes por API
- XML, RIDE y tus empresas en una cuenta
- Límites de cuenta ampliados: 300 emisión/min · 600 consulta/min · 120 descarga/min
Sin cobros automáticos a tu tarjeta. El período comienza al confirmarse el pago. Las transferencias y DeUna requieren revisión. Tú decides cuándo configurar producción, sin aprobación de Ruxi.
PREGUNTAS DE INTEGRACIÓN
Antes de integrar
la API.
¿Cómo empiezo?
Elige tu modalidad de pago, crea tu cuenta, verifica tu correo y decide si quieres activar la verificación en dos pasos. Después del pago podrás registrar la empresa y preparar tu integración en pruebas.
¿Qué necesito para registrar mi empresa?
Los datos del RUC, establecimiento y punto de emisión, además de una firma electrónica vigente correspondiente al emisor. El sistema valida el certificado antes de asignar acceso.
¿Qué límites técnicos tiene la API?
Emisión, consulta y descarga tienen límites por minuto independientes por clave y por cuenta. Cada respuesta incluye las cabeceras X-RateLimit-* con el tope y el consumo vigentes, y ante un pico devuelve 429 rate_limited con Retry-After. Tu plan puede ampliar el tope de la cuenta; revisa los límites vigentes en Suscripción y pagos y los valores de referencia en la documentación API de tu cuenta.
¿Puedo emitir en producción inmediatamente?
Sí, puedes elegir producción desde el alta y configurar tu firma, serie y siguientes números con capacidad disponible. Hacer pruebas es recomendable, pero no requiere aprobación de Ruxi.
¿Qué pasa si mi RUC ya existe?
Contacta a soporte para revisar la asignación. Una cuenta nueva no recibe acceso a empresas o documentos existentes solo por conocer un RUC.
¿Los cupos anuales se acumulan?
Cuando el plan tiene cupo mensual, el pago anual incluye 12 cupos independientes. Consulta en cada plan la periodicidad y capacidad; los documentos no utilizados no se acumulan.
¿Esta compra incluye el plugin?
No. La API y el plugin WooCommerce son soluciones independientes, con contratación y capacidades diferentes.
¿Puedo usar Ruxi sin suscripción?
Sí. Recarga saldo y usa pago por uso. Tu primera recarga confirmada habilita el prepago y permite registrar tu empresa según la capacidad disponible. Necesitas verificar tu correo y aportar tu firma. La verificación en dos pasos es opcional. Puedes configurar producción cuando decidas, sin aprobación de Ruxi.
¿El saldo tiene vencimiento?
El saldo no vence. Compras un importe de saldo, no un paquete de documentos; la calculadora estima cuántos documentos permite la tarifa estándar actual. El IVA se paga aparte y no se acredita al monedero.
¿Cuándo se descuenta saldo?
Solo al autorizarse un documento en producción. Mientras se procesa se reserva su importe. Los errores definitivos liberan la reserva; una respuesta incierta conserva la reserva hasta confirmar el resultado.
¿Puedo combinar saldo con un plan?
Sí. Puedes autorizar el uso de saldo cuando agotes el cupo de tu plan. Esta opción no se activa automáticamente. La tarifa estándar sin suscripción admite una empresa; revisa las condiciones particulares en tu monedero.
Prepara tu integración paso a paso.
Configura tu empresa, prepara un certificado vigente y crea una clave API para el ambiente de pruebas. La guía explica cómo seguir la autorización, recuperar XML y RIDE y reintentar sin duplicar una venta. El contrato de endpoints y sus ejemplos están en la documentación API de tu cuenta.
Leer la guía de integración API ↗RUXI MCP / ASISTENTES DE IA
Tu asistente también puede consultar tus comprobantes.
Conecta Codex, Claude Code, Cursor o VS Code a tu empresa Ruxi. Explora ejemplos y encuentra las instrucciones para empezar.
TU CUENTA RUXI