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
API REST · Facturación electrónica SRI Ecuador
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.
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"
} // 200 — respuesta inmediata (asíncrona)
{
"id": "cmp_AbC123Def456",
"estado": "encolado",
"tipo": "factura",
"clave_acceso": "0610202501179320743300110010010000012744521824716",
"mensaje": "Comprobante recibido y en proceso de autorización."
}
// luego: GET /api/comprobantes/estado/{id}
{ "estado": "autorizado", "pdf_url": "…", "xml_url": "…" } from cipherbyte_comprobantes import ComprobantesClient
client = ComprobantesClient(api_key="sk_tu_clave")
# El SDK arma el comprobante tipado y calcula los
# totales, los impuestos y la clave de acceso por ti.
factura = client.facturas.crear(version="2.1.0", ...)
resp = client.facturas.emitir(
factura, email_receiver="cliente@ejemplo.com"
)
print(resp.id, resp.estado) # cmp_..., encolado import { ComprobantesClient } from "@cipherbyte/comprobantes-sri";
const client = new ComprobantesClient({ apiKey: "sk_tu_clave" });
// El SDK arma el comprobante tipado y calcula los
// totales, los impuestos y la clave de acceso por ti.
const factura = client.facturas.crear({ version: "2.1.0", /* ... */ });
const resp = await client.facturas.emitir(factura, {
emailReceiver: "cliente@ejemplo.com",
});
console.log(resp.id, resp.estado); // cmp_..., encolado Referencia
La misma interfaz para todo el ciclo de facturación electrónica: cambia el tipo en la ruta y el cuerpo del comprobante. Explora el detalle de cada uno.
Venta de bienes y servicios con IVA.
POST /api/comprobantes/factura Anula o disminuye una factura.
POST /api/comprobantes/nota_credito Cobra intereses, mora o recargos.
POST /api/comprobantes/nota_debito Retención de IVA y de Renta.
POST /api/comprobantes/retencion Traslado de mercadería.
POST /api/comprobantes/guia_remision Compras a proveedores sin factura.
POST /api/comprobantes/liquidacion_compra Cómo funciona
Sube el certificado .p12 y el logo de cada empresa, y crea una API key con los permisos que necesites.
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.
El estado final llega por webhook o por consulta. Al autorizarse obtienes XML, RIDE en PDF y el envío por email.
Todo incluido
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.
Subes tu certificado .p12 una vez por RUC; se cifra y la clave privada nunca queda legible. La API firma cada comprobante.
Transmitimos al SRI con reintentos automáticos y te devolvemos el estado, sin que escribas integraciones SOAP.
Cada comprobante autorizado expone su XML firmado y su RIDE en PDF, con el logo de tu empresa.
Entrega el comprobante a tus clientes al emitir (hasta 10 correos) o reenvíalo después.
Recibe el resultado por webhook cuando el SRI responde, o consúltalo por id. Sin polling forzado.
Modelos totalmente tipados: cada campo se valida contra el esquema del SRI antes de firmar.
Precios
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.
Producción · Recomendado
Cotizar según volumen
Emisión real ante el SRI con precio por comprobante.
FAQ
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.
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.
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.
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.
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.
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.
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.
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.
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
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.
Respuesta promedio en menos de 15 minutos en horario laboral. +593 99 083 3993