API de facturación electrónica del SRI para Ecuador

Una API REST para emitir los seis comprobantes electrónicos del SRI. Tú envías el pedido en JSON; nosotros validamos, firmamos con tu certificado, hablamos con el SRI y te avisamos con un webhook cuando decide.

Crear cuenta gratis Ver documentación

Sandbox gratis, sin RUC ni tarjeta

Lo que el SRI espera de tu sistema

El SRI no recibe JSON. Recibe XML firmado, por servicios web SOAP.

Cada comprobante electrónico es un XML que sigue el esquema oficial de su tipo, lleva una clave de acceso de 49 dígitos y va firmado con XAdES-BES. El SRI lo recibe en un primer servicio y lo autoriza en un segundo: que lo reciba no es que lo autorice.

Desde el 1 de enero de 2026 los comprobantes se transmiten en el momento de emitirlos (resolución NAC-DGERCGC25-00000014, reformada por la NAC-DGERCGC25-00000017). Un sistema que factura necesita, entonces, conversar con el SRI en tiempo real y saber qué hacer cuando no contesta.

Integrarlo directamente significa mantener los esquemas, la firma, el SOAP, los reintentos, los códigos de error y el RIDE. Una API se encarga de eso una sola vez para todos tus sistemas.

Lo que hace Fiscalbase por ti

Un POST por comprobante, y cada paso con su hora.

Seis recursos con la forma del SRI: facturas, notas de crédito, notas de débito, retenciones, guías de remisión y liquidaciones de compra.
Validamos tus datos y las reglas del SRI antes de darle un número. Un rechazo nuestro no consume secuencial.
Idempotency-Key en cada POST: reintentar con la misma clave devuelve el mismo comprobante.
Firmamos con tu certificado, que queda sellado: la API puede guardarlo, pero no abrirlo.
Enviamos al SRI y esperamos su decisión. Si no responde, volvemos a preguntar con la misma clave de acceso.
Guardamos el XML autorizado, generamos el RIDE y se lo enviamos a tu cliente. Tú recibes un webhook firmado.
Sandbox gratis para construir sin RUC ni certificado, y los ambientes de Pruebas y Producción del SRI cuando tu negocio es real.

En la API

La misma solicitud que enviarías desde tu sistema.

Emitir una factura

Precios y cantidades como texto decimal. El IVA y los totales los calculamos nosotros.

POST /v1/ec/invoices
Authorization: Bearer fb_sandbox_…
Idempotency-Key: pedido-1041

{
  "buyer": {
    "identification_type": "cedula",
    "identification": "1712345675",
    "name": "María José Andrade",
    "email": "maria@example.ec"
  },
  "lines": [
    {
      "description": "Juego de brocas",
      "quantity": "2",
      "unit_price": "36.00",
      "taxes": [
        {
          "type": "iva",
          "rate": "iva_15"
        }
      ]
    }
  ],
  "payments": [
    {
      "method": "tarjeta_credito"
    }
  ]
}

201 Created

{
  "id": "0f6c8f4e-…",
  "number": "001-001-000000042",
  "status": "pending",
  "total": "82.80"
}

Preguntas frecuentes

Lo que suelen preguntar antes de integrar.

¿Necesito mi propia firma electrónica?

Para Pruebas y Producción sí: el certificado .p12 de tu RUC, que subes una sola vez. En Sandbox no, porque firmamos con un certificado de práctica.

¿Puedo probar la API sin RUC?

Sí. El Sandbox simula al SRI con un RUC de práctica, es gratis y no pide tarjeta. Cuando tu negocio tiene RUC pasas a los ambientes del SRI.

¿Qué pasa si el SRI no responde o devuelve el comprobante?

Si no responde, volvemos a preguntar con la misma clave de acceso. Si lo devuelve o no lo autoriza, el comprobante queda con los mensajes del SRI para que lo corrijas y lo reenvíes con el mismo número y la misma clave.

¿Cómo me entero de que el SRI autorizó?

Con un webhook firmado con Standard Webhooks, o consultando el comprobante por su id. Al autorizarse también puedes descargar su XML y su RIDE.

¿Cuánto cuesta?

El Sandbox es gratis. Los negocios con RUC eligen un plan mensual según su volumen de comprobantes en Producción, y Pruebas no cuenta. Los precios están en la página principal, con el IVA incluido.

Sigue leyendo

Otras guías para la misma integración.

Ambiente de pruebas

Prueba tu facturación electrónica en Sandbox sin RUC ni certificado, y en el ambiente de pruebas del SRI (celcer) con tu RUC, antes de emitir en producción.

Webhooks

Recibe un webhook firmado cuando el SRI autoriza, devuelve o no autoriza un comprobante. Standard Webhooks, reintentos durante tres días y secreto rotable.

Errores del SRI

Qué hacer cuando el SRI devuelve un comprobante, no lo autoriza o responde código 70, 43 o 45. Cómo Fiscalbase corrige y reenvía con la misma clave de acceso.

Tu primera factura hoy

Crea tu cuenta y emite en Sandbox en minutos.

Crear cuenta Ver documentación