items__getItems

post

https://mcp.alegra.com/tools/items__getItems

Obtiene la lista de ítems registrados en la aplicación con filtros opcionales. Usar el parámetro "fields" para incluir datos adicionales cuando el contexto de la conversación lo requiera (e.g. inventory para consultas de stock, images para catálogos, editable/deletable para tareas de gestión).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

limit

integer

Cantidad máxima de ítems a retornar. Por defecto 30.

start

integer

Offset para paginación (número de ítems a omitir).

metadata

boolean

Si es true, la respuesta incluye { metadata: { total }, data: [...] } en lugar del array directo.

query

string

Texto libre para buscar ítems por nombre o descripción.

type

string

enum

Filtrar ítems por tipo.

Allowed:

status

string

enum

Filtrar ítems por estado.

Allowed:

name

string

Filtrar ítems por nombre exacto.

reference

string

Filtrar ítems por referencia o código SKU.

idItemCategory

string

Filtrar ítems por ID de categoría de ítem.

idWarehouse

string

Filtrar ítems por ID de bodega.

order_field

string

Campo por el cual ordenar los resultados.

order_direction

string

enum

Dirección del ordenamiento.

Allowed:

fields

string

Campos adicionales a retornar, separados por coma. Valores posibles: itemVariants, variantAttributes, subitems, editable, deletable, settingsOnShop, remissionedQuantity, negativeSale, source, simpleSale, inventory, images, attachments, productKey, tariffHeading, kitWarehouse, idGlobal.

mode

string

enum

Modo de respuesta: simple retorna un conjunto reducido de campos.

Allowed:

Responses

401

No autorizado

200Lista de ítems registrados.