Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Carlos-Gnd/FERRED-Inventario-y-Ventas/llms.txt

Use this file to discover all available pages before exploring further.

El Bodeguero gestiona el inventario físico de su sucursal asignada: ajusta cantidades de stock, recibe mercancía de proveedores y supervisa alertas de nivel crítico. Al igual que el CAJERO, el rol BODEGA está restringido a una sucursal — el sucursalId del JWT determina qué datos puede leer y escribir.
El Bodeguero solo puede ver y gestionar el inventario de su propia sucursal. Intentar acceder al stock o alertas de otra sucursal devuelve 403 No podés acceder a recursos de otra sucursal.

​
Gestión de inventario

Las cantidades de stock y el umbral mínimo se ajustan con: 
PATCH /api/inventario/:productoId/ajuste
Authorization: Bearer <token>
Content-Type: application/json

{
  "sucursalId": 1,
  "cantidad": 50,
  "minimo": 5,
  "motivo": "Recepción proveedor"
}
El endpoint usa roleMiddleware('ADMIN', 'BODEGA'). El sucursalId del cuerpo se valida contra el token del usuario con assertSameSucursal. La operación hace un upsert — crea el registro stockSucursal si no existe, o lo actualiza si ya existe. Después del ajuste, se recalcula el stockActual del producto como la suma de todas las sucursales.

​
Alertas de stock crítico

GET /api/inventario/criticos/:sucursalId
Devuelve todos los productos activos de la sucursal con cantidad <= minimo, ordenados de menor a mayor. Cada registro incluye productoId, nombre, cantidad, minimo y tipoUnidad. 
GET /api/inventario/criticos-detalle
Devuelve los mismos datos con campos adicionales (codigoBarras, sucursalNombre, estado) y distingue entre critico (cantidad = 0) y bajo (cantidad > 0 pero ≤ mínimo). Para usuarios BODEGA, los resultados se filtran automáticamente a su sucursal.

​
Recepción de mercancía

Cuando llega mercancía de un proveedor, el Bodeguero la registra usando POST /api/proveedores/recepcion. Este endpoint crea la RecepcionMercancia e incrementa el stock de cada artículo en la sucursal de forma atómica.
1

Identificar el proveedor

Selecciona el proveedor de la lista con GET /api/proveedores o créalo con POST /api/proveedores.
2

Registrar la recepción

Llama a POST /api/proveedores/recepcion con el proveedorId, sucursalId, y el arreglo de items con productoId, cantidad y costoUnit.
3

Verificar alertas de stock

Revisa GET /api/inventario/criticos/:sucursalId para confirmar que el producto ya no aparece en la lista de críticos.

​
Consulta de stock

GET /api/inventario/stock/:sucursalId
Devuelve la lista completa de stock de la sucursal con nombres de producto, códigos de barras, precios y tipos de unidad. El guard assertSameSucursal restringe la consulta a la sucursal propia del Bodeguero.

​
Crear productos

POST /api/productos
El rol BODEGA tiene permiso para crear nuevos productos. Esto permite al personal de bodega registrar artículos nuevos cuando llegan de un proveedor, antes de agregarlos al stock.

​
Lo que NO puede hacer

Las siguientes acciones están bloqueadas para el rol BODEGA:
  • Registrar ventas en el POS (POST /api/ventas — solo ADMIN y CAJERO)
  • Gestionar o ver otros usuarios (/api/usuarios — solo ADMIN)
  • Configurar precios de productos (solo ADMIN)
  • Transferir stock entre sucursales (POST /api/inventario/transferencia — solo ADMIN)
  • Ver stock o datos de inventario de otras sucursales

​
Credenciales de prueba

CampoValor
Correobodega@ferred.com
Contraseñabodega123
URLhttps://ferred.netlify.app

Build docs developers (and LLMs) love

Get started for freeTalk to us