Inventario
Bodegas, stock por producto y consultas de inventario. Todas las rutas requieren autenticación.
Bodegas (Warehouses)
| Método | Ruta | Descripción |
|---|---|---|
| GET | /warehouses | Lista bodegas |
| GET | /warehouses/:id | Una bodega por ID (404 si no existe) |
| POST | /warehouses | Crea una bodega |
Matriz tipo de documento × movimiento de stock: inventory-document-stock-matrix.md.
Stock
| Método | Ruta | Descripción |
|---|---|---|
| GET | /stocks | Lista registros de stock |
| GET | /stocks/:id | Obtiene un registro de stock por ID |
| POST | /stocks | Crea registro de stock |
| PUT | /stocks/:id | Actualiza stock |
| GET | /stock/by-warehouse/:productId | Stock de un producto por bodega |
Movimientos manuales de inventario
Base: /inventory-movements. Requiere permisos según operación (p. ej. inventorys.view para lectura; creación según inventorys.movements.*).
| Método | Ruta | Descripción |
|---|---|---|
| GET | /inventory-movements | Lista movimientos (filtros según controlador) |
| GET | /inventory-movements/:id | Detalle de un movimiento y sus líneas |
| POST | /inventory-movements | Crea movimiento (ingreso, salida, transferencia, revalorización) |
| POST | /inventory-movements/:id/print | Genera PDF del movimiento (Jasper: movimiento_inventario). Respuesta application/pdf; cabecera X-Filename con nombre sugerido. Mismo permiso que ver el movimiento (inventorys.view). |
Ejemplo: listar bodegas
bash
curl -X GET "https://api.abaco.hn/warehouses" \
-H "Authorization: Bearer TU_KEY_ID:TU_SECRET"Ejemplo: stock por bodega para un producto
bash
curl -X GET "https://api.abaco.hn/stock/by-warehouse/123" \
-H "Authorization: Bearer TU_KEY_ID:TU_SECRET"Errores comunes
- 401: API key inválida o expirada.
- 403: Sin permiso para el recurso.
- 404: Recurso no encontrado.