API de facturación electrónica del SRI · EcuadorFactura al SRI desde tu sistema, sin construir la parte difícil
Tu sistema envía la venta. Nosotros la firmamos, la llevamos al SRI y te avisamos cuando está autorizada. Emite los seis comprobantes electrónicos por API, con SDK en cinco lenguajes o desde la terminal.
- 3.000 documentos de prueba, sin vencimiento
- Sin tarjeta ni contrato
- Integra el tiempo que necesites
// NuGet: Ecuafact.Sdk using Ecuafact.Sdk; using var client = EcuafactClient.Create( new EcuafactClientOptions { BaseAddress = new Uri( "https://api-sandbox.mynexusapi.com/"), ApiKey = Environment.GetEnvironmentVariable( "ECUAFACT_API_KEY")! }); // "FACTURA-2026-0001" identifica la venta: // si reintentas, no se duplica la factura. var r = await client.EmitirAsync( "0123456789001", factura, "FACTURA-2026-0001"); Console.WriteLine(r.Admission.IdOperacion);
// npm: @ecuafact/sdk import { EcuafactClient } from "@ecuafact/sdk"; const client = new EcuafactClient({ baseAddress: "https://api-sandbox.mynexusapi.com/", apiKey: process.env.ECUAFACT_API_KEY }); // "FACTURA-2026-0001" identifica la venta: // si reintentas, no se duplica la factura. const r = await client.emitirFacturaEn( "0123456789001", factura, "FACTURA-2026-0001"); console.log(r.admission.idOperacion);
# PyPI: ecuafact import os from ecuafact import EcuafactClient, EcuafactClientOptions with EcuafactClient(EcuafactClientOptions( base_address="https://api-sandbox.mynexusapi.com/", api_key=os.environ["ECUAFACT_API_KEY"], )) as client: # "FACTURA-2026-0001" identifica la venta: # si reintentas, no se duplica la factura. r = client.emitir_en( "0123456789001", factura, "FACTURA-2026-0001") print(r.admission.id_operacion)
curl -s -X POST \ "https://api-sandbox.mynexusapi.com/v1/contribuyentes/0123456789001/facturas" \ -H "X-Api-Key: $ECUAFACT_API_KEY" \ -H "Idempotency-Key: FACTURA-2026-0001" \ -H "Content-Type: application/json" \ -d @comprobante.json
# npm: @ecuafact/cli
ecuafact config poner entorno sandbox
ecuafact login
ecuafact nuevo factura --archivo factura.json
ecuafact emitir factura.json --esperar --descargar ride
{ "estado": "recibido", "idOperacion": "3f1c8c1e-…",
"codEstado": 1001,
"urlEstado": "https://api-sandbox.mynexusapi.com/v1/operaciones/3f1c8c1e-…" }
document.authorized o document.rejected- 6comprobantes electrónicos del SRI
- 5 SDKoficiales, más CLI y servidor MCP
- 3.000documentos de prueba gratis
- 99,9 %objetivo de disponibilidad mensual
Cómo funciona
Cinco pasos. Tú solo participas en el primero y el último
Envías la venta
Tu sistema manda los datos del comprobante, en JSON o en el XML del SRI.
Revisamos
Validamos datos y cálculos antes de ir al SRI.
Firmamos y enviamos
Con el certificado del emisor, directo al SRI.
Seguimos al SRI
Esperamos la autorización y generamos el RIDE.
Recibes el resultado
Por webhook firmado, o lo consultas cuando quieras.
Tu caja no espera al SRI
Tu sistema envía el comprobante y recibe al instante un número de operación. Puede continuar la venta y saber después si el SRI lo autorizó o lo rechazó, con el motivo y un código numérico estable para tu código.
Pruebas y producción, mismas reglas
El sandbox está conectado al ambiente de pruebas del SRI y se comporta igual que el real, sin validez fiscal. Para pasar a producción cambias la URL y la API Key. Un solo portal para los dos ambientes.
Por qué MyNexusAPI
Concéntrate en tu producto. Del SRI nos encargamos nosotros
Integrarte directo con el SRI es posible, pero es un proyecto en sí mismo y hay que mantenerlo. Esto es lo que te ahorras.
Integra como prefieras
API, SDK o terminal. Tú eliges
API REST con OpenAPI 3.1
REST y JSON con especificación pública. Úsala desde cualquier lenguaje, también los que no tienen SDK, como Go, Ruby o Delphi.
- Sin duplicados: cada envío lleva una llave de la venta (
Idempotency-Key); si la repites, recibes la misma operación. - Una API Key para todos tus RUC, limitada por servicios y por RUC.
- Errores en español con un código estable de cuatro dígitos (
codEstado). - Validación previa sin emitir y sin gastar comprobantes.
# Validar sin emitir (no gasta comprobantes) curl -X POST \ "https://api-sandbox.mynexusapi.com/v1/contribuyentes/0123456789001/facturas/validar" \ -H "X-Api-Key: $ECUAFACT_API_KEY" \ -H "Content-Type: application/json" \ -d @factura.json # Emitir en el sandbox curl -X POST \ "https://api-sandbox.mynexusapi.com/v1/contribuyentes/0123456789001/facturas" \ -H "X-Api-Key: $ECUAFACT_API_KEY" \ -H "Idempotency-Key: pedido-4521" \ -H "Content-Type: application/json" \ -d @factura.json
SDK oficiales en cinco lenguajes
Bibliotecas que resuelven la parte donde más se falla: autenticación, reintentos sin duplicar y verificación de los avisos firmados.
npm install @ecuafact/sdk import { EcuafactClient } from "@ecuafact/sdk"; const client = new EcuafactClient({ baseAddress: "https://api-sandbox.mynexusapi.com/", apiKey: process.env.ECUAFACT_API_KEY }); const r = await client.emitirFacturaEn( ruc, factura, "pedido-4521");
CLI ecuafact: factura sin programar
Herramienta de terminal en español para Windows, macOS y Linux (npm, Scoop y Homebrew). Es la forma de integrar un ERP antiguo sin tocar su código.
- Emite desde JSON, XML, Excel o CSV.
- Vigila la carpeta donde tu ERP deja los comprobantes y los emite.
- Descarga el RIDE y el XML autorizado desde la misma terminal.
npm install -g @ecuafact/cli ecuafact config poner entorno sandbox ecuafact login ecuafact nuevo factura --archivo factura.json ecuafact emitir factura.json --esperar --descargar ride
Prueba sin escribir código
Colección pública de Postman con las peticiones listas, y un repositorio con ejemplos ejecutables en los cinco lenguajes.
- Workspace público «Ecuafact API» en Postman.
- Un script por tarea: validar, emitir, seguir, descargar y verificar webhooks.
- Especificación OpenAPI 3.1 para generar tu propio cliente.
git clone https://github.com/Ecuanexus/ecuafact-api-ejemplos
cd ecuafact-api-ejemplos
# Cinco lenguajes, con SDK y con HTTP directo.
# Incluye una mini aplicación web que emite
# una factura de prueba y recibe webhooks.
Facturación con IA
Tu asistente de IA ya sabe facturar con el SRI
La IA te ayuda a construir la integración y, después, a operarla con los permisos que tú decides. Compatible con Claude, ChatGPT, Claude Code, Cursor y VS Code.
Agent Skill y MCP de documentación
Tu agente de programación conoce el contrato real de la API: campos, rutas, códigos de error y webhooks. Escribe la integración contigo sin inventar nada. El MCP de documentación es público y no pide cuenta.
npx skills add Ecuanexus/ecuafact-skill
# Luego pídele a tu agente:
# "Integra la API en este proyecto
# y emite una factura de prueba"
MCP de tu cuenta
Tu asistente consulta, descarga y, si lo permites, emite con los datos reales de tu cuenta.
- Sin compartir tu API Key: se conecta con tu autorización (OAuth 2.1).
- Permisos por acción y por RUC.
- Confirmación humana, si la activas: cada emisión espera la aprobación de una persona en el portal.
Comprobantes y funciones
Los seis comprobantes electrónicos del SRI
01FacturaVenta de bienes o servicios.03Liquidación de compraCompras a quien no puede emitir factura.04Nota de créditoAnula o reduce una factura emitida.05Nota de débitoAumenta el valor de una factura emitida.06Guía de remisiónAcompaña el traslado de mercadería.07RetenciónRetención de impuestos al pagar a un proveedor.Además de emitir
Validar sin emitir
Mismas reglas, sin ir al SRI y sin gastar comprobantes.
Webhooks firmados
Autorizado, rechazado o con error, con firma verificable y hasta 8 intentos de entrega.
Numeración automática
Siguiente número de la serie o continuación de tu sistema anterior.
PDF y XML
Descarga el RIDE y el XML autorizado de cada comprobante.
Logo del emisor
Personaliza los datos y el logo del PDF de cada RUC.
Catálogos del SRI
Tarifas de IVA, formas de pago y tipos de identificación, por API.
Consultas al SRI
Contribuyente por RUC o cédula, búsqueda por nombre y establecimientos, desde la misma API. Se compran en un Paquete de consultas.
Consumo al día
Consulta por API cuántos comprobantes te quedan.
Para quién es
Un caso para cada sistema
Factura al confirmar el pago
Cada pedido pagado genera su factura y el cliente la recibe por correo. Tu tienda no espera al SRI: el resultado llega por webhook.
Se integra con: API REST o SDK, más webhooks
Factura por cientos de negocios
Una sola API Key para todos los RUC de tus clientes, cada uno con su firma y su logo. El paquete de comprobantes se comparte entre todos.
Se integra con: SDK, varios RUC y webhooks · Ver planes para integradores
Factura en caja sin detener la fila
La venta se registra de inmediato y el resultado de la autorización llega después.
Se integra con: API REST o SDK
Factura desde una carpeta, sin tocar el ERP
Tu ERP deja los archivos en una carpeta y el CLI los emite.
Se integra con: CLI ecuafact
Facturación masiva desde Excel
Un lote de ventas en una hoja de cálculo, emitido desde la terminal.
Se integra con: CLI ecuafact con Excel o CSV
«¿Cuánto facturé este mes?»
Tu asistente responde con los datos reales de tu cuenta y, si lo permites, emite con tu confirmación.
Se integra con: servidor MCP con permisos por acción y por RUC
Seguridad y confiabilidad
Seguridad incluida en todos los planes
No es un extra de los planes altos: todo esto viene desde el plan Inicio.
Tu código nunca toca el certificado
Guardamos la firma del emisor y firmamos por ti.
API Keys acotadas y lista de IP
Limitas cada API Key por servicios y por RUC. En producción puedes activar una lista de IP permitidas. Revocar una llave tarda como máximo 30 segundos.
Disponibilidad a la vista
Objetivo de 99,9 % mensual y una página de estado pública con los últimos 90 días y sus incidentes.
Tus documentos son tuyos
Descargas el XML y el RIDE por API. Cada año de plan incluye una exportación masiva sin costo, y puedes continuar tu numeración en otro sistema.
Respaldo de Ecuafact
Operado por Ecuanexus, la empresa de Ecuafact, registrada como proveedor ante el SRI.
Soporte en Ecuador, con tiempos claros
Lunes a viernes de 09:00 a 18:00. Primera respuesta en un día hábil, o en cuatro horas si producción está caída.
Precios
Un plan al año, con su paquete de comprobantes
Pagas una vez al año y usas el paquete cuando lo necesites durante esos 12 meses. Integrar y probar es gratis; el plan se compra al pasar a producción.
Inicio
Para emitir desde un sistema con un RUC.
$120 −20 %
$96
$120
+IVA/año
Equivale a $8,00 al mes +IVA
Equivale a $10,00 al mes +IVA
Por comprobante
$0,0250$0,0200
Precio congelado por 24 meses
Todo lo de Gratis, más:
- 4.800 comprobantes en el año
- Webhooks firmados en producción
- Resguardo de XML y RIDE por 90 días
- 1 exportación masiva por año
Crecimiento
Para operar varios RUC sin fricción.
$290 −20 %
$232
$290
+IVA/año
Equivale a $19,33 al mes +IVA
Equivale a $24,17 al mes +IVA
Por comprobante
$0,0161$0,0129
Precio congelado por 24 meses
Todo lo de Inicio, más:
- 18.000 comprobantes en el año
- 5 RUC
- Resguardo por 1 año
- Exportaciones adicionales a pedido
Empresarial
Para escalar con control.
$590 −20 %
$472
$590
+IVA/año
Equivale a $39,33 al mes +IVA
Equivale a $49,17 al mes +IVA
Por comprobante
$0,0098$0,0079
Precio congelado por 24 meses
Todo lo de Crecimiento, más:
- 60.000 comprobantes en el año
- 15 RUC
- Resguardo mientras el plan esté vigente, hasta 7 años
- Canal directo de soporte
Integrador
Para casas de software con muchos RUC.
desde $990 −20 %
desde $792
desde $990
+IVA/año
Cotización según RUC y volumen
Todo lo de Empresarial, más:
- Desde 50 RUC
- Un paquete común para todos tus clientes
- Una sola factura a tu empresa
- Carga inicial de RUC por nuestro equipo
Oferta Fundadores, hasta el 31 de diciembre de 2026. En tu primer plan: 20 % de descuento, ese precio congelado por 24 meses, consultas al SRI sin costo con un límite mensual y soporte prioritario de integración. Ver condiciones
Precios en dólares de los Estados Unidos; se suma el IVA. ¿No sabes cuál te conviene? Usa la calculadora.
Preguntas frecuentes
Respuestas antes de empezar
¿Qué necesito para empezar?
Un correo. Con eso creas tu cuenta gratis y recibes tu API Key de pruebas, sin tarjeta ni contrato. Para emitir agregas en el portal el RUC con el que vas a probar y su firma electrónica.
¿Cuánto cuesta?
Probar es gratis: 3.000 documentos de prueba, sin vencimiento. Para emitir con validez fiscal compras un plan anual que trae su paquete de comprobantes: Inicio $120, Crecimiento $290 o Empresarial $590 al año, más IVA. No hay mensualidades. Ver precios.
¿Qué necesito para pasar a producción?
Verificar tu correo, cargar una firma electrónica vigente y completar cinco comprobantes de prueba aceptados. Lo haces tú mismo desde el portal. Al activar producción recibes 20 comprobantes reales, una sola vez por cuenta; para seguir emitiendo compras un plan.
¿Necesito una firma electrónica?
Sí, la del RUC que emite: es obligatoria para facturar en Ecuador. La cargas una vez en el portal y nosotros firmamos cada comprobante; tu sistema nunca la maneja. Si aún no tienes una, puedes obtenerla con Ecuafact.
¿Los comprobantes de prueba tienen validez fiscal?
No. Las pruebas usan el ambiente de pruebas del SRI. En pruebas, los correos llegan solo al titular de la cuenta, nunca a tus clientes.
¿Qué pasa si el SRI está caído o tarda?
Tu comprobante se recibe igual y te devolvemos un número de operación. El resultado te llega por webhook o lo consultas cuando quieras. La autorización depende del SRI; por eso la integración está pensada para que tu sistema no se quede esperando.
¿Puedo facturar dos veces la misma venta por error?
No, si reintentas como recomendamos. Cada envío lleva una llave que identifica la venta: si la repites, recibes la misma operación y no se crea otro comprobante. Cada comprobante nuevo lleva su propia llave.
¿Qué pasa si se me acaban los comprobantes?
Te avisamos cuando tu paquete llega al 80, 90 y 100 %. Si se agota, la emisión se detiene hasta que recargues: compras una Recarga desde el portal, de 1.000, 5.000, 20.000 o 50.000 comprobantes. Si recargas seguido, te conviene subir de plan.
¿Puedo emitir para varios RUC?
Sí. Una sola API Key cubre los contribuyentes de tu integración y puedes limitarla a los RUC que quieras. El paquete de comprobantes se comparte entre todos. Cada plan incluye un número de RUC: 1, 5 o 15; si atiendes a más clientes, están los planes Integrador.
¿Cuánto tiempo guardan mis XML y RIDE?
Depende del plan: 90 días en Inicio, 1 año en Crecimiento y, en Empresarial e Integrador, mientras tu plan esté vigente (hasta 7 años). Puedes descargarlos por API cuando quieras y cada año de plan incluye una exportación masiva sin costo. La obligación de conservarlos siete años es del contribuyente.
¿Ya uso otro proveedor o un sistema propio. ¿Puedo migrar?
Sí. Envías el primer comprobante con el número que sigue en tu serie y desde ahí continuamos la numeración. No hace falta migrar los comprobantes anteriores.
Mi sistema no puede conectarse a una API. ¿Puedo usarla igual?
Sí. Con el CLI puedes emitir desde Excel o CSV, o vigilar la carpeta donde tu sistema deja los comprobantes.
¿Puedo anular un comprobante por la API?
No. Un comprobante autorizado se revierte con una nota de crédito, que cuenta como otro comprobante, o con el trámite ante el SRI.
Tu primera factura de prueba, hoy
Crea tu sandbox gratis, sin contrato y sin hablar con nadie. Cuando estés listo, pasas a producción tú mismo desde el portal.