ALalegra
Gastos

Listar notas de débito de compra

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.

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

Request body

client_idinteger

ID numérico local del proveedor. Limita la lista a sus documentos.

datestring

Fecha exacta del documento (YYYY-MM-DD).

date_afterOrNowstring

Filtro: fecha de emisión >= valor (YYYY-MM-DD).

date_beforeOrNowstring

Filtro: fecha de emisión <= valor (YYYY-MM-DD).

date_betweenstring

Rango de fechas requerido por los filtros de la API.

emissionStatusstring

Filtro de estado de emisión electrónica, separado por comas o con varios valores.

fieldsstring

Campos adicionales separados por comas: editable, deletable, stamp, xml, idGlobal, uid, createdAt, updatedAt, companyCurrencyValues, calculationTotalMethod, bills.idGlobal, bills.currency, accountingVouchers, etc.

idstring

Lista separada por comas de IDs locales a recuperar en una petición (máximo 30). Alternativa a listar todos.

idGlobalstring

Filtro por identificador global del documento.

item_idinteger

Filtra documentos que contengan un ítem con este ID local.

limitinteger

Tamaño de página; 0 = sin límite (sujeto al máximo del servidor). Por defecto 30.

metadataboolean

Si es true, la respuesta es { metadata: { total }, data: [...] }.

numberstring

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_namestring

Filtra por nombre del proveedor.

startinteger

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

Lista de notas de débito de compra

Changes

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