Comprobante de retención electrónico del SRI
Si eres agente de retención, cada compra sujeta a retención termina en un comprobante que entregas a tu proveedor. Fiscalbase lo arma con sus documentos de sustento y los porcentajes de la fecha.
De un vistazo
Lo esencial antes de integrar.
Los seis comprobantes del SRI
Una API y un mismo modelo
Sandbox gratis
Sin RUC ni tarjeta
Webhooks firmados
Te avisamos cuando el SRI decide
Desde USD 15 al mes
Con 500 comprobantes incluidos
Cómo lo trata el SRI
Un comprobante, uno o varios documentos de sustento.
El comprobante de retención (versión 2.0.0) lista cada documento de sustento con su código de sustento, sus totales, el IVA que su emisor facturó, las retenciones aplicadas y los pagos. El período fiscal es el mes de emisión.
Los porcentajes dependen del código y de la fecha: varios códigos de renta cambiaron el 1 de marzo de 2026. Para un contribuyente especial, el IVA se retiene al 30 % en bienes y al 70 % en servicios cuando el proveedor no es especial, y al 10 % y 20 % cuando sí lo es.
La retención se entrega al proveedor dentro de los cinco días hábiles siguientes a la factura.
Construirlo tú mismo no termina nunca
Esto es lo que tu equipo tendría que construir y mantener para siempre.
Por tu cuenta
Seis esquemas XSD del SRI, y cada cambio de versión
Clave de acceso de 49 dígitos con su dígito verificador
Firma XAdES-BES con el certificado de cada RUC
Dos servicios SOAP: recepción y autorización
Reintentos cuando el SRI no responde, sin duplicar
Errores del SRI traducidos a algo que tu equipo entienda
RIDE en PDF para los seis comprobantes
Correo al cliente, con el XML y el RIDE
Avisos antes de que venza cada certificado
Nuevas resoluciones del SRI, cada año
Desde USD 15 al mes
Un POST a /v1/ec/invoices
Validamos antes de numerar
Firmamos, enviamos y reintentamos
Te avisamos con un webhook
Entregamos el RIDE y el XML a tu cliente
Seguimos cada cambio del SRI por ti
Cómo lo emites con Fiscalbase
Tú nombras el código y la base; el resto lo comprobamos.
Proveedor y documentos de sustento
POST /v1/ec/withholdings con el proveedor y sus documentos de sustento.
Códigos por fecha de emisión
Conocemos los códigos de renta y de ISD por fecha de emisión.
Rechazo antes de numerar
Si un código conocido no concuerda con el porcentaje, lo rechazamos antes de numerar.
Valor retenido calculado
Calculamos el valor retenido de cada línea a partir de su base y su porcentaje.
Período fiscal y sustento
Escribimos el período fiscal y el número del documento de sustento como el SRI los espera.
RIDE y XML para el proveedor
El proveedor recibe el RIDE y el XML autorizado por correo y los encuentra en el portal.
Retener renta e IVA de una factura de servicios
Un documento de sustento, con su base de renta y su retención de IVA.
POST /v1/ec/withholdings
{
"supplier": {
"identification_type": "ruc",
"identification": "1792233445001",
"name": "TRANSPORTES ANDES CÍA. LTDA.",
"email": "cobros@andes.ec"
},
"support_documents": [
{
"document_type": "factura",
"number": "001-001-000118802",
"issue_date": "2026-09-25",
"authorization_number": "2509202601179223344500110010010001188021234567811",
"tax_support": "01",
"subtotal": "771.00",
"total": "886.65",
"taxes": [
{
"type": "iva",
"rate": "iva_15",
"base": "771.00",
"value": "115.65"
}
],
"withholdings": [
{
"tax": "renta",
"code": "312",
"base": "771.00"
},
{
"tax": "iva",
"rate": "iva_30",
"base": "115.65"
}
],
"payments": [
{
"method": "otros_sistema_financiero"
}
]
}
]
}Cada comprobante, paso a paso
Recibida, autorizada, RIDE generado, correo y portal. Con su hora, en la consola.
Factura 001-001-000001002
Ferretería El Sol S.A.
USD 285,00
- Recibida10:30:02
- Autorizado por el SRIIntento #2 10:42:11
- RIDE generado10:42:12
- Correo enviadocompras@elsol.ecPortal de clientesDisponible para su descarga
Recibida
10:30:02
Autorizado por el SRI
12 min
10:42:11
RIDE generado
< 1 s
10:42:12
Webhooks
Firmado y con reintentos cuando el SRI decide.
POST https://erp.andina.ec/webhooks
{
"id": "3c1a7e52-…",
"type": "invoice.authorized",
"timestamp": "2026-10-03T10:42:07.118Z",
"data": {
"id": "0f6c8f4e-…",
"object": "invoice",
"status": "authorized",
"environment": "sandbox",
"country": "ec",
"entity_id": "01926c10-…",
"number": "001-001-000001002"
}
}API keys
Una API key por ambiente. El prefijo dice dónde emites.
- Sandbox
fb_sandbox_
••••••••
Sin validez tributaria
- Pruebas
fb_test_
••••••••
Ambiente de pruebas del SRI
- Producción
fb_live_
••••••••
Validez tributaria
Todo para empezar
Tu primera factura
De cero a una factura autorizada en Sandbox.
Referencia de la API
Cada endpoint, sus campos y sus errores.
Sandbox
Prueba sin RUC ni tarjeta.
Preguntas frecuentes
Sigue leyendo
API de facturación electrónica SRI Ecuador
Una API para los seis comprobantes.
LeerNota de crédito electrónica SRI
Corrige una factura ya emitida.
LeerGuía de remisión electrónica SRI
Respalda el traslado de tu mercadería.
LeerLiquidación de compra electrónica SRI
Compra a quien no puede facturarte.
LeerEmpieza a facturar hoy
Sandbox gratis, sin RUC ni tarjeta.