GET
/api/mod/productos/{espacio}/inventory/summaryEl resumen del stock
Las cifras de salud del inventario: cuántas variantes con stock, agotadas, en stock bajo y reservas activas.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Productos. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| total | integer | Variantes con stock cargado (por bodega). |
| con_stock · agotados | integer | Con algo disponible, y con 0. |
| stock_bajo | integer | En o bajo su umbral. |
| reservas_activas | integer | Reservas reteniendo stock ahora. |
| last_sync | object | null | La última carga masiva: fuente (file, un archivo; contable, tu software contable), items_upserted y created_at. null si nunca hubo. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Productos | módulo no habilitado para este espacio. |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.