Endpoints / Stock
Actualizar stock
Actualiza parcialmente la cantidad o el estado de un stock existente, dentro de la empresa del usuario autenticado.
/stocks/:idCaso de Uso
Se usa cuando la aplicación necesita ajustar manualmente la cantidad disponible de un producto en una sucursal, o cambiar su estado operativo. Al usarlo, el usuario obtiene los datos del stock actualizado con las relaciones resueltas de sucursal y producto.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`. Permite acceso a usuarios con rol jefe o empleado.
Parámetros de ruta
idstringobligatorioIdentificador del stock a actualizar.
Body
stcksuidstringobligatorioIdentificador de la sucursal; debe existir en la empresa y coincidir con la sucursal real del stock.
stckcantidadnumber opcionalNueva cantidad de existencias.
stckestadostring opcionalNuevo estado del stock; acepta activo, inactivo o eliminado.
Reglas de negocio
Solo un usuario con rol jefe o empleado puede actualizar stock.
Solo permite actualizar stock de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
stcksuid es obligatorio y debe corresponder a una sucursal existente en la empresa.
El id de la ruta y el stcksuid del body deben coincidir con la sucursal real del stock.
No se permite cambiar el producto asociado al stock mediante este endpoint.
Un stock con estado eliminado no puede actualizarse.
Debe enviarse al menos stckcantidad o stckestado con un valor diferente al actual.
Si se envía stckcantidad, debe ser un número válido.
Si se envía stckestado, solo puede ser activo, inactivo o eliminado.
Después de actualizar, el backend sincroniza automáticamente las alertas de stock bajo.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
No se envió el parámetro id en la ruta.
No se envió stcksuid en el body.
stckcantidad fue enviado vacío.
stckcantidad no es un número válido.
stckestado fue enviado vacío.
stckestado tiene un valor no permitido.
No se envió ningún campo editable o todos los valores enviados son iguales a los actuales.
El stock no existe dentro de la empresa del usuario autenticado, o no coincide con la sucursal enviada.
El stock existe, pero está en estado eliminado.
stcksuid no corresponde a una sucursal existente en la empresa.
La empresa asociada al usuario autenticado no fue encontrada.
La empresa asociada al usuario autenticado está inactiva.
El usuario autenticado no fue encontrado dentro de su empresa.
El usuario autenticado no pertenece a la empresa indicada por su sesión.
El usuario autenticado intentó acceder a una empresa distinta a la suya.
El rol del usuario no está permitido para acceder al módulo de stock.
El usuario autenticado no tiene un rol permitido para actualizar stock.
El usuario autenticado está inactivo y no puede usar el sistema.
Notas de uso
Este endpoint no recibe query params.
stcksuid es obligatorio y debe coincidir con la sucursal real del stock.
No se puede cambiar el producto del stock mediante este endpoint.
stckestado permite el valor eliminado para eliminación lógica.
La actualización puede disparar la sincronización de alertas de stock bajo.