Retención

POST /v1/retenciones — el comprobante al revés de los demás: lo emite quien paga una factura, no quien la cobra. Si tu empresa es agente de retención, al pagar a un proveedor emites este documento.

Renta 2 % + 30 % del IVA (el caso común)

{
  "emisor": {
    "ruc": "0999999999001",
    "razonSocial": "MI EMPRESA S.A.",
    "dirMatriz": "Av. Amazonas y Colon"
  },
  "establecimiento": "001",
  "puntoEmision": "001",
  "sujetoRetenido": {
    "tipoIdentificacion": "04",
    "identificacion": "1790012344001",
    "razonSocial": "PROVEEDOR EJEMPLO S.A."
  },
  "docsSustento": [
    {
      "codSustento": "01",
      "tipoComprobante": "01",
      "numero": "001-001-000000123",
      "fechaEmision": "10/08/2026",
      "totalSinImpuestos": "100.00",
      "codigoPorcentajeIva": "4",
      "retenciones": [
        {
          "impuesto": "1",
          "codigoRetencion": "312",
          "baseImponible": "100.00",
          "porcentaje": "2"
        },
        {
          "impuesto": "2",
          "codigoRetencion": "1",
          "baseImponible": "15.00",
          "porcentaje": "30"
        }
      ]
    }
  ]
}

Leyendo el ejemplo: sobre una factura del proveedor de 100.00 + IVA, se retiene el 2 % de renta (código 312) sobre el subtotal y el 30 % del IVA (15.00 de IVA → se retienen 4.50). Los valores retenidos se calculan solos.

Las piezas

sujetoRetenido — el proveedor al que le retienes. Con RUC va tipoIdentificacion: "04".
docsSustento — las facturas que sustentan la retención. Una retención puede cubrir varias facturas del mismo proveedor en el período.
retenciones — por cada sustento, las líneas de retención:
- impuesto: 1 renta, 2 IVA, 6 ISD.
- codigoRetencion: el código del catálogo del SRI (el 312 es «otras compras de bienes y servicios», hoy 2 %).
- porcentaje: el que aplicas — el catálogo vigente lo fija el SRI por resolución.