---
title: "Listar notas de débito de compra"
method: POST
path: "/tools/expenses_list-debit-notes"
tags: ["Gastos"]
---

# Listar notas de débito de compra

`POST /tools/expenses_list-debit-notes`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/expenses_list-debit-notes`
- Auth: HTTP bearer

Herramienta MCP: `expenses_list-debit-notes`.

Lista notas de débito de compras (cuentas por pagar) con paginación y filtros: proveedor, fecha, estado de emisión, número de documento o tipo de documento (nota estándar frente a nota de ajuste).

Úsala para descubrir los `id` que necesita `expenses_get-debit-note`, auditar notas de débito abiertas o filtrar los documentos de un proveedor con `client_id`. Con `id` puedes recuperar hasta 30 documentos por sus IDs locales separados por comas en una sola petición. Con `metadata: true` la respuesta envuelve los resultados como `{ metadata: { total }, data: [...] }` en lugar de un arreglo.

Notas por país: en Colombia el filtro `type=adjustmentNote` es relevante para los flujos de notas de ajuste; en Costa Rica los documentos se rigen por la facturación electrónica de Ministerio de Hacienda; en México operan bajo las reglas SAT (CFDI).

Errores relevantes: `start` o `limit` inválidos, o más de 30 IDs en `id` → código 903; documento no encontrado → 404 (código 13005); acceso denegado por permisos → 403.

Solo lectura.

## Request body

- object
  - `client_id` integer: ID numérico local del proveedor. Limita la lista a sus documentos.
  - `date` string: Fecha exacta del documento (YYYY-MM-DD).
  - `date_afterOrNow` string: Filtro: fecha de emisión >= valor (YYYY-MM-DD).
  - `date_beforeOrNow` string: Filtro: fecha de emisión <= valor (YYYY-MM-DD).
  - `date_between` string: Rango de fechas requerido por los filtros de la API.
  - `emissionStatus` string: Filtro de estado de emisión electrónica, separado por comas o con varios valores.
  - `fields` string: Campos adicionales separados por comas: editable, deletable, stamp, xml, idGlobal, uid, createdAt, updatedAt, companyCurrencyValues, calculationTotalMethod, bills.idGlobal, bills.currency, accountingVouchers, etc.
  - `id` string: Lista separada por comas de IDs locales a recuperar en una petición (máximo 30). Alternativa a listar todos.
  - `idGlobal` string: Filtro por identificador global del documento.
  - `item_id` integer: Filtra documentos que contengan un ítem con este ID local.
  - `limit` integer: Tamaño de página; 0 = sin límite (sujeto al máximo del servidor). Por defecto 30.
  - `metadata` boolean: Si es true, la respuesta es { metadata: { total }, data: [...] }.
  - `number` string: Filtra por número del documento.
  - `order_direction` 'ASC' | 'DESC': Dirección del orden: ASC (ascendente) o DESC (descendente).
  - `order_field` 'number' | 'name' | 'date' | 'id': Campo por el que se ordenan los resultados.
  - `provider_name` string: Filtra por nombre del proveedor.
  - `start` integer: Desplazamiento inicial de la paginación (debe ser >= 0).
  - `type` 'normal' | 'adjustmentNote' | 'all': Filtro de estirpe del documento: nota de débito estándar, nota de ajuste o todas.

## Response `200`

Lista de notas de débito de compra

## Other responses

- `401`: No autorizado

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)