---
title: "Subir un 07 recibido de un cliente (retención sobre ventas)"
method: POST
path: "/compras/retencion-recibida"
tags: ["compras"]
---

# Subir un 07 recibido de un cliente (retención sobre ventas)

`POST /compras/retencion-recibida`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/compras/retencion-recibida`
- Auth: HTTP bearer

Parsea y registra un comprobante de retención (codDoc 07) emitido por un cliente del tenant sobre sus ventas. Persiste las líneas en `retenciones_recibidas` y concilia contra las ventas del tenant por clave de acceso. Idempotente por clave de acceso del 07. El valor tipo IVA (codigo=2) alimenta el campo `retencionIvaRecibida` del F104. Límite: 2 MB por archivo.

## Request body

- object
  - `emisorId` string, uuid, required
  - `nombre` string, required
  - `base64` string, required: Contenido del XML codificado en base64 (máx. 2 MB)

## Response `200`

Retención recibida registrada o ya existente

- RetencionRecibidaResultado: Resultado de subir un 07 recibido de un cliente
  - `id` string, uuid: ID de la primera línea insertada (uuid de retenciones_recibidas)
  - `duplicado` boolean: true si la clave de acceso del 07 ya estaba registrada
  - `lineas` integer: Número total de líneas de retención en el 07
  - `conciliadas` integer: Líneas que se conciliaron con una venta del tenant
  - `huerfanas` integer: Líneas sin venta correspondiente en Contadeo (fiscalmente válidas)

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)
- `403`: Rol insuficiente o acceso denegado

---

[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)