API de Facturación Electrónica SRI Ecuador | Emitir Facturas, Retenciones y Más | CipherByte

API REST · Facturación electrónica SRI Ecuador

Emite comprobantes del SRI con un solo POST

Factura, notas de crédito y débito, retenciones, guías de remisión y liquidaciones, autorizadas por el SRI. La API se encarga de la firma electrónica, la autorización, el RIDE en PDF y el XML, el envío por email y los webhooks.

Ambiente de pruebas
Gratis
Comprobantes
6 tipos
SDKs
Python · TypeScript
POST /api/comprobantes/factura
X-Api-Key: sk_tu_clave

{
  "comprobante": {
    "info_tributaria": {
      "ambiente": "2",
      "tipo_emision": "1",
      "razon_social": "MI EMPRESA S.A.",
      "ruc": "1793207433001",
      "clave_acceso": "0610202501179320743300110010010000012744521824716",
      "cod_doc": "01",
      "estab": "001",
      "pto_emi": "001",
      "secuencial": "000001274",
      "dir_matriz": "Av. Principal 123"
    },
    "info_factura": {
      "fecha_emision": "06/10/2025",
      "tipo_identificacion_comprador": "04",
      "razon_social_comprador": "CLIENTE EJEMPLO S.A.",
      "identificacion_comprador": "1790012345001",
      "total_sin_impuestos": "100.00",
      "total_descuento": "0.00",
      "total_con_impuestos": { "total_impuesto": [
        { "codigo": "2", "codigo_porcentaje": "4",
          "base_imponible": "100.00", "valor": "15.00" } ] },
      "importe_total": "115.00"
    },
    "detalles": { "detalle": [{
      "descripcion": "Servicio de consultoría",
      "cantidad": "1.00",
      "precio_unitario": "100.00",
      "descuento": "0.00",
      "precio_total_sin_impuesto": "100.00",
      "impuestos": { "impuesto": [
        { "codigo": "2", "codigo_porcentaje": "4", "tarifa": "15.00",
          "base_imponible": "100.00", "valor": "15.00" } ] }
    }] },
    "id": "comprobante",
    "version": "2.1.0"
  },
  "email_receiver": "cliente@ejemplo.com",
  "callback_url": "https://tu-sistema.com/webhook"
}

Cómo funciona

De cero a comprobante autorizado

01

Prepara tu cuenta

Sube el certificado .p12 y el logo de cada empresa, y crea una API key con los permisos que necesites.

02

Emite con un POST

Envía el comprobante a un endpoint por tipo. La API lo valida, lo firma y lo transmite; responde al instante con un id y estado encolado.

03

Recibe el resultado

El estado final llega por webhook o por consulta. Al autorizarse obtienes XML, RIDE en PDF y el envío por email.

Todo incluido

La API resuelve lo difícil de la facturación

Firma con tu certificado, transmisión al SRI y entrega de los documentos finales a tus clientes. Tú envías el comprobante; nosotros nos encargamos del resto.

Firma electrónica gestionada

Subes tu certificado .p12 una vez por RUC; se cifra y la clave privada nunca queda legible. La API firma cada comprobante.

Autorización ante el SRI

Transmitimos al SRI con reintentos automáticos y te devolvemos el estado, sin que escribas integraciones SOAP.

RIDE en PDF y XML

Cada comprobante autorizado expone su XML firmado y su RIDE en PDF, con el logo de tu empresa.

Envío por email

Entrega el comprobante a tus clientes al emitir (hasta 10 correos) o reenvíalo después.

Webhooks y estado

Recibe el resultado por webhook cuando el SRI responde, o consúltalo por id. Sin polling forzado.

Esquemas validados

Modelos totalmente tipados: cada campo se valida contra el esquema del SRI antes de firmar.

Precios

Prueba gratis, paga solo por lo que emites

El ambiente de pruebas del SRI es gratuito para validar tu integración. En producción pagas por uso según tu volumen, y los comprobantes rechazados por el SRI no se cobran.

Pruebas

$0

Valida tu integración end-to-end antes de salir a producción.

  • Todos los tipos de comprobante
  • Firma, RIDE en PDF y XML
  • SDKs Python y TypeScript
Empezar pruebas

Producción · Recomendado

Cotizar según volumen

Emisión real ante el SRI con precio por comprobante.

  • Todo lo del ambiente de pruebas
  • Multiempresa y permisos por IP
  • Comprobantes rechazados no se cobran
  • Soporte por WhatsApp

Contáctanos

Estamos aquí para ayudarte. Elige el canal más rápido para ti: respondemos por WhatsApp en minutos, o por correo a la brevedad.

Chatear por WhatsApp +593 99 083 3993, respuesta en minutos
o por correo
cotizacion@cipherbyte.ec

FAQ

Preguntas frecuentes

Resolvemos las dudas más comunes sobre la emisión de comprobantes electrónicos del SRI mediante la API, la firma electrónica, los ambientes y la integración.

¿Qué comprobantes electrónicos puedo emitir con la API?

Puedes emitir los seis comprobantes oficiales del SRI de Ecuador: factura, nota de crédito, nota de débito, comprobante de retención, guía de remisión y liquidación de compra. Cada tipo tiene su endpoint y se firma y autoriza ante el SRI automáticamente.

¿Necesito mi propio certificado de firma electrónica?

Sí. Utilizas tu certificado de firma electrónica (.p12 o .pfx) emitido por una entidad de certificación autorizada en Ecuador. Lo subes una sola vez por RUC; se cifra al guardarse y la clave privada nunca queda legible por el servidor. La API firma cada comprobante por ti.

¿Cómo se autoriza el comprobante ante el SRI?

Envías el comprobante (con su clave de acceso de 49 dígitos, que generas tú o el SDK por ti) a un único POST. La API lo valida contra el esquema del SRI, lo firma con tu certificado y lo transmite al SRI; te responde al instante con un id y el estado «encolado». El resultado final (autorizado o rechazado) llega de forma asíncrona por webhook o consultando el estado por id. No necesitas implementar los servicios web SOAP del SRI ni manejar reintentos.

¿Puedo probar antes de pasar a producción?

Sí. El ambiente lo define el dígito de ambiente de la clave de acceso: 1 = pruebas (gratis) y 2 = producción (se cobra). Validas tu integración en pruebas sin costo y pasas a producción con el mismo código, cambiando solo el ambiente.

¿La API genera el PDF (RIDE) y envía el comprobante por email?

Sí. Cada comprobante autorizado expone su XML firmado y su RIDE en PDF, con el logo de tu empresa incrustado. Además puedes enviar el comprobante por correo a tu cliente automáticamente al emitir, o reenviarlo después.

¿Hay SDK para mi lenguaje?

Ofrecemos SDKs para Python y TypeScript que arman el comprobante tipado y calculan totales, impuestos y la clave de acceso por ti. También puedes consumir la API REST directamente desde cualquier lenguaje.

¿Cómo se cobra el servicio?

El modelo es de pago por uso según el volumen de comprobantes emitidos en producción. El ambiente de pruebas es gratuito y los comprobantes rechazados por el SRI no se cobran. Escríbenos por WhatsApp o correo y te preparamos una cotización ajustada a tu volumen.

¿Cómo solicito acceso a la API?

Contáctanos por WhatsApp al +593 99 083 3993 o por correo a cotizacion@cipherbyte.ec indicando tu RUC, los tipos de comprobante que emites y tu volumen estimado. Te damos acceso al ambiente de pruebas, las credenciales y el acompañamiento para integrar.

Acceso y soporte

Empieza a emitir comprobantes electrónicos del SRI hoy

Cuéntanos tu caso de uso y volumen estimado. Te damos acceso al ambiente de pruebas, las credenciales y el acompañamiento para integrar la API en tu sistema. Respondemos por WhatsApp en minutos.

Solicitar acceso por WhatsApp

Contáctanos

Estamos aquí para ayudarte. Elige el canal más rápido para ti: respondemos por WhatsApp en minutos, o por correo a la brevedad.

Chatear por WhatsApp +593 99 083 3993, respuesta en minutos
o por correo
cotizacion@cipherbyte.ec

Respuesta promedio en menos de 15 minutos en horario laboral. +593 99 083 3993

No se pudo cargar la app.