ALalegra
Sales Documents

Obtener notas débito de venta

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.

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

Request body

startinteger

Desplazamiento de la paginación (basado en cero). Por defecto 0.

limitinteger

Máximo de registros por página (máximo 30).

order_direction'ASC' | 'DESC'

Dirección del orden: ascendente o descendente.

order_fieldstring

Campo por el que se ordenan los resultados. Valores válidos: numberTemplate_fullNumber, date, dueDate, status.

numberTemplate_fullNumberstring

Filtra por el número completo del documento (por ejemplo "DN-001").

customerIdstring

Filtra por el ID del cliente asociado.

client_namestring

Filtra por nombre del cliente (coincidencia parcial).

client_identificationstring

Filtra por la identificación fiscal del cliente.

datestring

Filtra por fecha exacta (YYYY-MM-DD).

dateFromstring

Filtra notas débito con fecha posterior o igual a esta (YYYY-MM-DD).

dateTostring

Filtra notas débito con fecha anterior o igual a esta (YYYY-MM-DD).

dueDatestring

Filtra por fecha de vencimiento exacta (YYYY-MM-DD).

statusstring[]

Filtra por estado del documento.

emission_statusstring[]

Filtra por estado de emisión electrónica.

metadataboolean

Si es true, envuelve la respuesta como { data: [...], metadata: { total } } en lugar de un arreglo simple.

fieldsstring

Lista separada por comas de campos adicionales a expandir (por ejemplo "editable,deletable").

detailboolean

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

Lista de notas débito de venta

Changes

No recorded changes to this operation across all 1 revision of this API.