---
title: "Estado de cuenta de un cliente o un proveedor"
method: GET
path: "/tesoreria/estado-cuenta"
tags: ["tesoreria"]
---

# Estado de cuenta de un cliente o un proveedor

`GET /tesoreria/estado-cuenta`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/tesoreria/estado-cuenta`
- Auth: HTTP bearer

Lo pendiente al cerrar `hasta`, documento por documento y con su antigüedad, y los cobros, pagos y cruces vivos del período. 404 si la identificación tiene una supresión vigente.

## Query parameters

- `emisorId` string, uuid, required
- `lado` 'cobrar' | 'pagar', required
- `identificacion` string, required
- `desde` string, date
- `hasta` string, date

## Response `200`

El estado de cuenta

- EstadoCuentaTercero
  - `emisorId` string, uuid
  - `lado` 'cobrar' | 'pagar'
  - `tercero` object
    - `identificacion` string
    - `nombre` string, nullable
  - `desde` string, date
  - `hasta` string, date
  - `documentos` object[]: Lo pendiente al cerrar `hasta`, con `diasVencido`
  - `totales` object
    - `documentos` integer
    - `saldo` number
    - `vencido` number
  - `tramos` string[]
  - `antiguedad` number[]: Por vencer, de 1 a 30, de 31 a 60, de 61 a 90, de 91 a 120 y más de 120 días
  - `movimientos` object[]
    - `id` string, uuid
    - `fecha` string, date
    - `sentido` 'cobro' | 'pago' | 'cruce'
    - `importe` number
    - `formaPago` string, nullable
    - `referencia` string, nullable
    - `cuenta` string, nullable
  - `notas` string[]

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)
- `404`: Identificación con una supresión vigente

---

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