Stock
Existencias por almacén, ubicación, lote y SKU: totales, disponibles, reservados y en tránsito.
Este recurso sólo se consulta: su contenido lo calculan los procesos del sistema. POST, PUT, PATCH y DELETE responden 405 READ_ONLY.
GET /v1/stock Listar registros ▶
| Parám. | Descripción | Defecto |
|---|---|---|
page | Número de página | 1 |
per_page | Registros por página (máx. 1000) | 20 |
since | Inicio del rango de creación (columna entered). Solo fecha = desde las 00:00:00 | — |
until | Fin del rango de creación. Solo fecha = hasta las 23:59:59 | — |
q | Búsqueda de texto en los campos indicados en cada recurso: name description | — |
s / o | Campo de ordenamiento · Sentido: asc o desc | según recurso |
f | Filtros exactos en JSON | — |
# página 2, 20 por página
curl -H "X-SYNCS-API-TOKEN: TU_TOKEN" "https://sandbox.minimarket.digital/v1/stock?page=2&per_page=20"
# creados en un rango de fechas, más recientes primero
curl -H "X-SYNCS-API-TOKEN: TU_TOKEN" "https://sandbox.minimarket.digital/v1/stock?since=2026-07-01&until=2026-07-31&s=entered&o=desc"Respuesta
{
"status": "success",
"code": "200",
"message": "LIST",
"data": {
"a1b2c3d4-5e6f-7890-abcd-ef1234567890": {
"id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
"wrh_id": "WRH-01",
"wrh_loc_id": "A-01-02",
"prd_id": "PRD-0001",
"prd_sku_id": "---",
"prd_bat_id": "L2026-07",
"uni_id": "U",
"factor": 1,
"stock_min": 10,
"stock_total": 250,
"stock_available": 240,
"stock_reserved": 10,
"price_cost": 8.9
}
},
"meta": {
"page": 1,
"per_page": 20,
"count": 1,
"total": 134
}
}GET /v1/stock/{id} Obtener un registro ▶
Campos
| Campo | Etiqueta | Tipo |
|---|---|---|
name | — | texto |
description | — | texto |
uni_id | — | texto |
factor | — | número |
stock_min | — | número |
stock_max | — | número |
stock_total | — | número |
stock_transit | — | número |
stock_available | — | número |
stock_reserved | — | número |
price_cost | — | número |
price_sell | — | número |
price_storage | — | número |
Componentes de la clave com_suc_id cou_id geo_id wrh_id wrh_loc_id prd_bat_id prd_id prd_sku_id lpn_id sts_id
curl -H "X-SYNCS-API-TOKEN: TU_TOKEN" "https://sandbox.minimarket.digital/v1/stock/ID"Respuesta
{
"status": "success",
"code": "200",
"message": "GET",
"data": {
"id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
"wrh_id": "WRH-01",
"wrh_loc_id": "A-01-02",
"prd_id": "PRD-0001",
"prd_sku_id": "---",
"prd_bat_id": "L2026-07",
"uni_id": "U",
"factor": 1,
"stock_min": 10,
"stock_total": 250,
"stock_available": 240,
"stock_reserved": 10,
"price_cost": 8.9
}
}