---
title: "Documentos por cobrar, con su saldo"
method: GET
path: "/tesoreria/por-cobrar"
tags: ["tesoreria"]
---

# Documentos por cobrar, con su saldo

`GET /tesoreria/por-cobrar`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/tesoreria/por-cobrar`
- Auth: HTTP bearer

Facturas (01) y notas de débito (05) emitidas, autorizadas y de Producción, con lo que falta por cobrar de cada una: su importe menos las notas de crédito autorizadas que la modifican, las retenciones que le hicieron al emisor y los cobros que se le aplicaron. El saldo no se guarda: se calcula de los documentos. Una retención se casa con su factura por la clave de acceso del sustento y, si no la trae, por su número.

## Query parameters

- `emisorId` string, uuid, required
- `identificacion` string
- `q` string
- `vencido` boolean
- `limit` integer
- `offset` integer

## Response `200`

Los documentos con saldo, del que vence antes al que vence después

- Cartera
  - `emisorId` string, uuid
  - `lado` 'cobrar' | 'pagar'
  - `hoy` string, date: La fecha, en hora de Ecuador, con la que se decidió qué está vencido
  - `inicio` string, date, nullable: Inicio de la contabilidad del emisor: los documentos anteriores no tienen saldo aquí, están en los saldos iniciales
  - `totales` object: De todo lo filtrado, no de la página
    - `documentos` integer
    - `saldo` number
    - `vencido` number
  - `terceros` object[]: A quién se le cobra o se le paga, del saldo mayor al menor (hasta 100)
    - `tipo` string, nullable
    - `identificacion` string, nullable
    - `nombre` string, nullable
    - `documentos` integer
    - `saldo` number
    - `vencido` number
  - `documentos` object[]
    - `origen` 'comprobante' | 'compra' | 'apertura': `comprobante`: emitido por el emisor. `compra`: recibido. `apertura`: pendiente al día del corte de los saldos iniciales (`tipoComprobante` `SI`)
    - `id` string, uuid
    - `tipoComprobante` string
    - `numero` string
    - `fechaEmision` string, date
    - `venceEl` string, date: El día de emisión si el documento no tiene plazo
    - `diasVencido` integer: Cero si no ha vencido
    - `terceroTipo` string, nullable
    - `terceroIdentificacion` string, nullable
    - `terceroNombre` string, nullable
    - `importe` number
    - `notasCredito` number
    - `retenciones` number
    - `aplicado` number: Cobros o pagos ya aplicados
    - `saldo` number: `importe − notasCredito − retenciones − aplicado`. Siempre mayor que cero
  - `limit` integer
  - `offset` integer

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)
- `402`: La cuenta no tiene el módulo `tesoreria`
- `403`: Token/key ausente, inválido o expirado

---

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