---
title: "Documentos: ventas y compras en una sola lista"
method: GET
path: "/documentos"
tags: ["comprobantes"]
---

# Documentos: ventas y compras en una sola lista

`GET /documentos`

## Request

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

Une los comprobantes emitidos y las compras registradas, ordenados por fecha de emisión (lo más reciente primero) y paginados en la base. Las ventas siguen las reglas del listado de comprobantes: solo el ambiente activo y sin lo bloqueado. `ventas` y `compras` cuentan cada clase con los mismos filtros, pida la clase que pida; `total` es el de la clase pedida. Cada fila lleva la identificación y el nombre de un cliente o de un proveedor: el listado se audita.

## Query parameters

- `emisorId` string, uuid
- `clase` 'todos' | 'venta' | 'compra'
- `desde` string, date
- `hasta` string, date
- `q` string
- `limit` integer
- `offset` integer

## Response `200`

Página de documentos

- object
  - `total` integer
  - `ventas` integer
  - `compras` integer
  - `filas` object[]
    - `clase` 'venta' | 'compra'
    - `id` string, uuid
    - `tipoComprobante` string: Código del SRI: 01, 03, 04, 05, 06 o 07.
    - `numero` string, nullable: `001-001-000000123`. `null` en una compra dada de alta sin serie.
    - `fechaEmision` string, date
    - `contraparteIdentificacion` string, nullable
    - `contraparteNombre` string, nullable
    - `neto` string: Suma de las bases, sin impuestos.
    - `montoIva` string
    - `total` string, nullable
    - `estado` string, nullable: Estado del comprobante emitido. `null` en las compras.

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