ALalegra
Gastos

Listar órdenes de compra

Herramienta MCP: expenses_list-purchase-orders.

Lista órdenes de compra con paginación (start por defecto 0, limit por defecto 30) y filtros de fechas, estado, nombre del proveedor, ítem, bodega, centro de costos y número.

Úsala para descubrir los id de las órdenes de compra antes de consultar una con expenses_get-purchase-order, filtrar documentos abiertos o localizar las órdenes de un proveedor. Con metadata: true la respuesta envuelve los resultados como { metadata: { total }, data: [...] } en lugar de un arreglo.

Errores relevantes: start negativo o limit fuera del rango 0–30 → código 903.

Solo lectura.

post/tools/expenses_list-purchase-orders

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/expenses_list-purchase-orders
  • Auth
    HTTP bearer

Request body

startinteger

Desplazamiento inicial de la paginación (debe ser >= 0).

limitinteger

Tamaño de página 0–30; por defecto 30 (0 = sin límite en el controlador de la API).

metadataboolean

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

order_field'name' | 'date' | 'id' | 'deliveryDate' | 'status'

Campo por el que se ordenan los resultados.

order_direction'ASC' | 'DESC'

Dirección del orden: ASC (ascendente) o DESC (descendente).

currencystring

Filtra por código de moneda.

costCenter_idstring

Filtra por ID local del centro de costos; usa "null", "none" o "0" para documentos sin centro de costos.

fullNumberstring

Filtra por el número completo del documento.

numberstring

Alias del filtro fullNumber.

warehouse_idstring

Filtra por ID local de la bodega.

item_idinteger

Filtra órdenes que contengan un ítem con este ID local.

idstring

Lista separada por comas de IDs locales.

datestring

Fecha exacta de emisión (YYYY-MM-DD).

deliveryDatestring

Fecha exacta de entrega (YYYY-MM-DD).

delivery_datestring

Fecha de entrega (formato alternativo admitido por la API).

statusstring

Filtra por estado del documento.

provider_namestring

Filtra por nombre del proveedor.

client_idinteger

Filtra por ID numérico local del proveedor.

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 de emisión.

fieldsstring

Campos adicionales separados por comas: editable, deletable, voidable, comments, companyCurrencyValues, pdf, billType, purchaseIndex, billedQuantity, excludeMaxBilled, calculationTotalMethod, partiallyBilled, uuid.

Response

Lista de órdenes de compra

Changes

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