---
title: "Obtener notas débito de venta"
method: POST
path: "/tools/incomeDebitNotes_income_get-debit-notes"
tags: ["Sales Documents"]
---

# Obtener notas débito de venta

`POST /tools/incomeDebitNotes_income_get-debit-notes`

## Request

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

Herramienta MCP: `incomeDebitNotes_income_get-debit-notes`.

Obtiene o busca notas débito de venta, paginadas (máximo 30 por página). Por defecto devuelve una versión ligera de cada nota débito (IDs, fechas, estado, numeración, cliente y montos); con `detail: true` se incluye el payload completo (ítems, impuestos, etc.), solo cuando el usuario pide ese detalle.

Filtros: número completo del documento (`numberTemplate_fullNumber`, por ejemplo \"DN-001\"), cliente (por ID con `customerId`, por nombre con `client_name` o por identificación fiscal con `client_identification`), fecha exacta o rango (`date`, `dateFrom`, `dateTo`), vencimiento (`dueDate`), estado del documento (`status`) y estado de emisión electrónica (`emission_status`). `order_field` acepta `numberTemplate_fullNumber`, `date`, `dueDate` y `status`. Con `metadata: true` la respuesta se envuelve como `{ data: [...], metadata: { total } }` en lugar de un arreglo simple. Para conjuntos grandes (más de ~120 registros) o exportaciones de rangos completos de fechas, usa la herramienta exportable (`income_create-debit-notes-exportable`) en su lugar.

Solo lectura.

## Request body

- object
  - `start` integer: Desplazamiento de la paginación (basado en cero). Por defecto 0.
  - `limit` integer: Máximo de registros por página (máximo 30).
  - `order_direction` 'ASC' | 'DESC': Dirección del orden: ascendente o descendente.
  - `order_field` string: Campo por el que se ordenan los resultados. Valores válidos: numberTemplate_fullNumber, date, dueDate, status.
  - `numberTemplate_fullNumber` string: Filtra por el número completo del documento (por ejemplo "DN-001").
  - `customerId` string: Filtra por el ID del cliente asociado.
  - `client_name` string: Filtra por nombre del cliente (coincidencia parcial).
  - `client_identification` string: Filtra por la identificación fiscal del cliente.
  - `date` string: Filtra por fecha exacta (YYYY-MM-DD).
  - `dateFrom` string: Filtra notas débito con fecha posterior o igual a esta (YYYY-MM-DD).
  - `dateTo` string: Filtra notas débito con fecha anterior o igual a esta (YYYY-MM-DD).
  - `dueDate` string: Filtra por fecha de vencimiento exacta (YYYY-MM-DD).
  - `status` string[]: Filtra por estado del documento.
  - `emission_status` string[]: Filtra por estado de emisión electrónica.
  - `metadata` boolean: Si es true, envuelve la respuesta como { data: [...], metadata: { total } } en lugar de un arreglo simple.
  - `fields` string: Lista separada por comas de campos adicionales a expandir (por ejemplo "editable,deletable").
  - `detail` boolean: Con false (por defecto) devuelve una versión ligera de cada nota débito (IDs, fechas, estado, numeración, cliente y montos). Con true se incluye el payload completo (ítems, impuestos, etc.), solo cuando el usuario pide ese detalle.

## Response `200`

Lista de notas débito de venta

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