Listar órdenes de compra

post

https://mcp.alegra.com/tools/expenses_list-purchase-orders

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

start

integer

≥ 0

Defaults to 0

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

limit

integer

0 to 30

Defaults to 30

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

metadata

boolean

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

order_field

string

enum

Campo por el que se ordenan los resultados.

Allowed:

order_direction

string

enum

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

Allowed:

currency

string

Filtra por código de moneda.

costCenter_id

string

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

fullNumber

string

Filtra por el número completo del documento.

number

string

Alias del filtro fullNumber.

warehouse_id

string

Filtra por ID local de la bodega.

item_id

integer

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

string

Lista separada por comas de IDs locales.

date

string

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

deliveryDate

string

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

delivery_date

string

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

status

string

Filtra por estado del documento.

provider_name

string

Filtra por nombre del proveedor.

client_id

integer

Filtra por ID numérico local del proveedor.

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

fields

string

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

Responses

401

No autorizado

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Lista de órdenes de compra