Logo de LiminarLiminar
AyudaDocs APINovedades
Ir a Liminar

Productos

Listar, consultar y crear productos, y ajustar stock por depósito

GET/api/v1/productsscope: products:read

Parámetros

NombreTipoObligatorioNotas
pagenumbernodefault 1
pageSizenumbernodefault 20, tope 100
searchstringnobusca por código o descripción

Ejemplo de request

curl https://tu-tenant.liminar.cloud/api/v1/products?search=tornillo \
-H "Authorization: Bearer lim_live_xxxxxxxx"

Cómo se ve en el sistema

Inventario → Productos.

GET/api/v1/products/:idscope: products:read

Cómo se ve en el sistema

Detalle de producto en Inventario → Productos.

POST/api/v1/productsscope: products:write

Parámetros

NombreTipoObligatorioNotas
codigostringsíN/D
descripcionstringsíN/D
unidadMedidastringnoN/D
tipostringnoN/D

Ejemplo de request

curl -X POST https://tu-tenant.liminar.cloud/api/v1/products \
-H "Authorization: Bearer lim_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"codigo":"TOR-001","descripcion":"Tornillo M6x20"}'

Cómo se ve en el sistema

El producto aparece de inmediato en Inventario → Productos.

POST/api/v1/products/:id/stockscope: products:write

Reintentar la misma request con el mismo par refType/refId no duplica el ajuste de stock.

Parámetros

NombreTipoObligatorioNotas
depotIdstringsíN/D
quantitynumbersíN/D
typestringsíej. "ingreso", "egreso", "ajuste"
refTypestringsíjunto a refId, hace el movimiento idempotente
refIdstringsíjunto a refType, hace el movimiento idempotente
reasonstringnoN/D
unitCostnumbernoN/D

Cómo se ve en el sistema

El movimiento aparece en el historial de stock del depósito, dentro del detalle del producto.