Endpoints / Stock
Crear stock
Registra un nuevo stock para una sucursal y un producto dentro de la empresa del usuario autenticado.
/stocksCaso de Uso
Se usa cuando la aplicación necesita inicializar las existencias de un producto en una sucursal específica, por ejemplo al dar de alta un producto nuevo o al configurar el inventario inicial. Al usarlo, el usuario obtiene los datos del stock creado, incluyendo 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. La empresa y el usuario autenticado deben estar activos.
Parámetros de ruta
Este endpoint no recibe parámetros de ruta.
Body
stckemidstringobligatorioIdentificador de la empresa a la que pertenecerá el stock; debe coincidir con la empresa del usuario autenticado.
stcksuidstringobligatorioIdentificador de la sucursal donde se registrará el stock; debe existir en la empresa.
stckprdtoidstringobligatorioIdentificador del producto para el que se registrará el stock; debe existir en la empresa.
stckcantidadnumberobligatorioCantidad inicial de existencias.
Reglas de negocio
Solo un usuario con rol jefe o empleado puede registrar stock.
Solo permite crear stock en la misma empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
Todos los campos del body son obligatorios.
stcksuid debe corresponder a una sucursal existente en la empresa.
stckprdtoid debe corresponder a un producto existente en la empresa.
stckcantidad debe ser un valor numérico válido.
No puede existir otro registro de stock para la misma combinación de sucursal y producto.
El stock se crea con estado activo.
Después de crear el stock, 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.
stckemid fue enviado vacío.
stcksuid fue enviado vacío.
stckprdtoid fue enviado vacío.
stckcantidad fue enviado vacío.
stckcantidad no es un número válido.
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.
stckemid pertenece a una empresa distinta a la del usuario autenticado.
El rol del usuario no está permitido para acceder al módulo de stock.
El usuario autenticado no tiene un rol permitido para crear stock.
El usuario autenticado está inactivo y no puede usar el sistema.
stcksuid no corresponde a una sucursal existente en la empresa.
stckprdtoid no corresponde a un producto existente en la empresa.
Ya hay un registro de stock para la misma combinación de sucursal y producto.
El stock fue guardado, pero no pudo consultarse para devolver la respuesta.
Ocurrió un error interno al guardar el stock.
Notas de uso
Este endpoint no recibe parámetros de ruta ni query params.
No se puede crear más de un stock para la misma sucursal y producto dentro de una empresa.
La creación de stock puede disparar la sincronización de alertas de stock bajo para el producto.
La respuesta incluye las relaciones resueltas de sucursal y producto.