API para emitir facturas electrónicas del SRI
Genera facturas electrónicas autorizadas por el SRI directamente desde tu ERP, e-commerce o punto de venta. La API valida y firma con tu certificado, autoriza ante el SRI y te devuelve el RIDE en PDF y el XML, además de enviarlo por email a tu cliente.
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"
}{
"id": "cmp_AbC123Def456",
"estado": "encolado",
"tipo": "factura",
"clave_acceso": "0610202501179320743300110010010000012744521824716",
"mensaje": "Comprobante recibido y en proceso de autorización."
}Qué es
La factura electrónica, automatizada de punta a punta
La factura electrónica es el comprobante de venta más común en Ecuador y respalda la transferencia de bienes o la prestación de servicios. Para que tenga validez tributaria debe estar firmada electrónicamente y autorizada por el SRI.
En lugar de implementar la firma XAdES, los servicios web del SRI y la generación del RIDE por tu cuenta, la API resuelve todo el ciclo: recibes los datos, devuelves una factura autorizada lista para entregar a tu cliente.
Qué incluye la emisión por API
- Con los SDKs, cálculo automático de subtotales, IVA (incluido el 15 %) y total.
- Con los SDKs, generación de la clave de acceso de 49 dígitos (dígito verificador módulo 11).
- Firma electrónica del XML con tu certificado .p12 cifrado.
- Transmisión y autorización ante el SRI, con reintentos automáticos.
- RIDE en PDF con el logo de tu empresa y XML firmado descargables.
- Envío de la factura por email al comprador al momento de emitir.
Versiones y estructura
La factura electrónica, campo por campo
La API valida tu factura contra el esquema oficial del SRI según la versión que declares en comprobante.version. Una factura mínima se arma con tres bloques; los campos opcionales (comercio exterior, reembolsos, retenciones, formas de pago e información adicional) ya están tipados y disponibles. Forma parte de la API de Facturación Electrónica.
Versiones soportadas
2.1.0 · 2.0.0 · 1.1.0 · 1.0.0
info_tributaria Ambiente, RUC, clave de acceso de 49 dígitos, tipo de documento (cod_doc 01) y secuencia del comprobante.
info_factura Datos del comprador, totales, IVA (total_con_impuestos) e importe total de la factura.
detalles Líneas de la factura: descripción, cantidad, precio unitario, descuento e impuestos por ítem.
opcionales reembolsos, retenciones, info_sustitutiva_guia_remision, otros_rubros_terceros e info_adicional.
Sigue explorando la API de facturación electrónica
API de Facturación Electrónica
La API completa: todos los comprobantes, firma, RIDE, XML y webhooks.
API de Notas de Crédito
Anula o ajusta tus facturas por devoluciones y descuentos.
API de Retenciones
Emite retenciones de IVA y Renta como agente de retención.
API de Guías de Remisión
Respalda el traslado de la mercadería de tus facturas.
Portal de Comprobantes
Consulta y descarga comprobantes ya emitidos ante el SRI.
API de Consulta RUC
Valida la razón social y el estado del comprador antes de facturar.
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é versiones de factura electrónica soporta la API? ▾
Soportamos las versiones 1.0.0, 1.1.0, 2.0.0 y 2.1.0 del esquema de factura del SRI. Declaras la versión en el campo comprobante.version y validamos tu factura contra ese esquema exacto. Para nuevas integraciones recomendamos la 2.1.0, la más reciente.
¿Cómo emito una factura electrónica con la API? ▾
Envías un POST al endpoint de facturas con el comprobante (info tributaria, info de factura y detalles) y el correo del comprador. La API valida el comprobante, 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 por webhook o consultando el estado por id, con el XML firmado y el RIDE en PDF.
¿Quién calcula el IVA, los totales y la clave de acceso? ▾
Los SDKs oficiales (Python y TypeScript) arman el comprobante tipado y calculan los precios por línea, los impuestos, los totales y la clave de acceso por ti. Si integras por HTTP directo, envías esos valores ya calculados y la API los valida contra el esquema del SRI antes de firmar.
¿Puedo anular una factura ya emitida? ▾
Sí. La anulación de un comprobante autorizado es un trámite ante el SRI y requiere acceso a tu cuenta del SRI; podemos integrarlo a tu medida si lo necesitas (escríbenos por WhatsApp o correo). Es distinto de reversar el valor: para devoluciones, descuentos o correcciones se emite una nota de crédito que referencia la factura de origen, disponible en la API.
¿La factura se envía automáticamente al cliente? ▾
Sí. Si incluyes el correo del comprador, la API envía el XML y el RIDE en PDF al emitir. También puedes reenviar el comprobante a nuevos destinatarios más tarde.
¿Funciona para personas naturales y sociedades? ▾
Sí. Puedes emitir facturas tanto si tu RUC es de persona natural como de sociedad, siempre que cuentes con tu certificado de firma electrónica y estés habilitado como emisor electrónico ante el SRI.
Acceso y soporte
Empieza a emitir facturas electrónicas 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.
Respuesta promedio en menos de 15 minutos en horario laboral. +593 99 083 3993