API de comprobantes de retención del SRI
Emite comprobantes de retención electrónicos de IVA y Renta como agente de retención. Declara una o varias retenciones por comprobante; la API valida, firma y autoriza ante el SRI y entrega el RIDE en PDF y el XML.
POST /api/comprobantes/retencion
X-Api-Key: sk_tu_clave
{
"comprobante": {
"info_tributaria": {
"ambiente": "2",
"tipo_emision": "1",
"razon_social": "MI EMPRESA S.A.",
"ruc": "1793207433001",
"clave_acceso": "1210202607179320743300110010010000000451234567819",
"cod_doc": "07",
"estab": "001",
"pto_emi": "001",
"secuencial": "000000045",
"dir_matriz": "Av. Principal 123"
},
"info_comp_retencion": {
"fecha_emision": "12/06/2026",
"tipo_identificacion_sujeto_retenido": "04",
"parte_rel": "NO",
"razon_social_sujeto_retenido": "PROVEEDOR EJEMPLO S.A.",
"identificacion_sujeto_retenido": "1790012345001",
"periodo_fiscal": "06/2026"
},
"docs_sustento": { "doc_sustento": [{
"cod_sustento": "01",
"cod_doc_sustento": "01",
"num_doc_sustento": "001001000000045",
"fecha_emision_doc_sustento": "12/06/2026",
"pago_loc_ext": "01",
"total_sin_impuestos": "100.00",
"importe_total": "115.00",
"impuestos_doc_sustento": { "impuesto_doc_sustento": [
{ "cod_impuesto_doc_sustento": "2", "codigo_porcentaje": "4",
"base_imponible": "100.00", "tarifa": "15.00", "valor_impuesto": "15.00" } ] },
"retenciones": { "retencion": [
{ "codigo": "1", "codigo_retencion": "312",
"base_imponible": "100.00", "porcentaje_retener": "1.75",
"valor_retenido": "1.75" } ] },
"pagos": { "pago": [ { "forma_pago": "01", "total": "115.00" } ] }
}] },
"id": "comprobante",
"version": "2.0.0"
},
"email_receiver": "proveedor@ejemplo.com"
}{
"id": "cmp_a47b9f10",
"estado": "encolado",
"tipo": "retencion",
"clave_acceso": "1210202607179320743300110010010000000451234567819",
"mensaje": "Comprobante recibido y en proceso de autorización."
}Cómo funciona
Retenciones de IVA y Renta, listas para el SRI
Como agente de retención, cada vez que pagas a un proveedor puedes retener un porcentaje de IVA y de Renta. La API arma el comprobante con sus sustentos y lo autoriza por ti.
Retención de Renta e IVA
Declara una o varias retenciones por comprobante, con su código, base imponible y porcentaje vigente del SRI.
Período fiscal y sustento
Vincula la retención al período fiscal y al comprobante de sustento (la factura del proveedor).
Cálculo del valor retenido
Con los SDKs, cálculo del valor retenido por línea y del total, listo para tus anexos y conciliaciones.
Firma y autorización
Se firma con tu certificado y se autoriza ante el SRI, con RIDE en PDF y XML firmado.
Versiones y estructura
El comprobante de retención, campo por campo
La API valida la retención contra el esquema oficial del SRI según la versión que declares en comprobante.version. La 2.0.0 estructura las retenciones dentro de docs_sustento; la 1.0.0 usa el bloque impuestos. Forma parte de la API de Facturación Electrónica.
Versiones soportadas
2.0.0 · 1.0.0
info_tributaria Ambiente, RUC, clave de acceso de 49 dígitos, tipo de documento (cod_doc 07) y secuencia.
info_comp_retencion Sujeto retenido, período fiscal y fecha de emisión del comprobante.
docs_sustento Documento de sustento con sus retenciones de IVA y Renta: código, base imponible, porcentaje y valor retenido (versión 2.0.0).
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 Facturas
Emite facturas electrónicas de venta con IVA y autorización del SRI.
API de Notas de Crédito
Anula o ajusta tus facturas por devoluciones y descuentos.
API de Guías de Remisión
Respalda el traslado de la mercadería de tus facturas.
Portal de Comprobantes
Consulta retenciones recibidas y emitidas ante el SRI.
API de Consulta RUC
Verifica el RUC del proveedor antes de retener.
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 comprobante de retención soporta la API? ▾
Soportamos las versiones 1.0.0 y 2.0.0 del esquema de retención del SRI. La 2.0.0 estructura las retenciones dentro de docs_sustento (documento de sustento); la 1.0.0 usa el bloque impuestos. Declaras la versión en comprobante.version; recomendamos la 2.0.0 para nuevas integraciones.
¿Quién emite comprobantes de retención? ▾
Los emiten los agentes de retención cuando pagan a un proveedor y deben retener un porcentaje de IVA y/o de Renta. El comprobante respalda esa retención ante el SRI y sirve al proveedor como crédito tributario.
¿Puedo incluir varias retenciones en un solo comprobante? ▾
Sí. Un comprobante de retención puede contener varias retenciones sobre el mismo documento de sustento: por ejemplo, una de Renta y otra de IVA. La API valida cada código y porcentaje contra el esquema del SRI; los SDKs calculan el total retenido.
¿La API conoce los códigos y porcentajes de retención? ▾
Tú indicas el código de retención, la base imponible y el porcentaje aplicable; la API valida el formato contra el esquema del SRI y los SDKs calculan el valor retenido. Así mantienes el control de las tarifas vigentes según la normativa.
¿Sirve para preparar el ATS y las declaraciones? ▾
Sí. Cada comprobante autorizado queda con su XML y sus valores de retención, lo que facilita armar el Anexo Transaccional Simplificado (ATS) y las conciliaciones mensuales.
Acceso y soporte
Empieza a emitir comprobantes de retención 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