---
title: "Retenciones practicadas en el período (insumo ATS-compras)"
method: GET
path: "/asesor/retenciones"
tags: ["asesor"]
---

# Retenciones practicadas en el período (insumo ATS-compras)

`GET /asesor/retenciones`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/asesor/retenciones`
- Auth: HTTP bearer

Devuelve el detalle línea a línea de las retenciones que el emisor ha practicado a sus proveedores en el período indicado (un 07 emitido por cada docSustento), junto con los totales por tipo de tributo (Renta / IVA / ISD). Solo contiene datos desde jun-2026 (activación del GAP-RET; sin backfill de 07 anteriores). Las líneas con compraId nulo corresponden a comprobantes de sustento no cargados aún en Compras.

## Query parameters

- `emisorId` string, uuid
- `anio` integer, required
- `mes` integer, required

## Response `200`

Retenciones practicadas del período

- object
  - `emisorId` string, uuid
  - `ruc` string
  - `periodo` string: "YYYY-MM"
  - `desde` string, date
  - `hasta` string, date
  - `lineas` object[]
    - `id` string, uuid
    - `claveAccesoRetencion` string
    - `proveedorRuc` string
    - `codSustento` string, nullable
    - `codDocSustento` string, nullable
    - `numDocSustento` string, nullable
    - `claveAccesoSustento` string, nullable
    - `fechaEmisionSustento` string, date, nullable
    - `tipo` '1' | '2' | '6': 1=Renta, 2=IVA, 6=ISD
    - `codigoRetencion` string
    - `baseImponible` string
    - `porcentaje` string
    - `valor` string
    - `compraId` string, uuid, nullable
  - `totales` object
    - `retencionRenta` string
    - `retencionIva` string
    - `retencionIsd` string
  - `notas` string[]
  - `disclaimer` string

## Other responses

- `400`: anio o mes fuera de rango, o emisorId ambiguo

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)