Endpoints / Medidas
Actualizar Medida
Actualiza parcialmente los datos editables de una medida, dentro de la empresa del usuario autenticado.
/medidas/:idCaso de Uso
Se usa cuando la aplicación necesita modificar el nombre, la abreviatura o el estado de una medida existente. Al usarlo, el usuario obtiene los datos completos de la medida actualizada.
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
idstringobligatorioIdentificador de la medida.
Body
mdianombrestring opcionalNuevo nombre de la medida; debe ser único dentro de la empresa.
mdiaabreviaturastring opcionalNueva abreviatura de la medida; debe ser única dentro de la empresa.
mdiaestadostring opcionalNuevo estado de la medida; acepta activo, inactivo o eliminado.
Reglas de negocio
Solo un usuario con rol jefe o empleado puede actualizar medidas.
Solo permite actualizar medidas de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
La medida debe existir dentro de la empresa autenticada.
Una medida con estado eliminado no puede actualizarse.
Debe enviarse al menos un campo editable con un valor diferente al actual.
Si se envía mdianombre, no puede estar vacío.
Si se envía mdiaabreviatura, no puede estar vacía.
mdianombre no puede repetirse en otra medida de la misma empresa.
mdiaabreviatura no puede repetirse en otra medida de la misma empresa.
Si se envía mdiaestado, solo puede ser activo, inactivo o eliminado.
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.
La medida no existe dentro de la empresa del usuario autenticado o la actualización no devolvió resultados.
mdianombre fue enviado vacío.
mdiaabreviatura fue enviado vacío.
mdiaestado fue enviado vacío.
mdiaestado tiene un valor no permitido.
La medida existe, pero está en estado eliminado.
Otra medida de la misma empresa ya usa el mdianombre enviado.
Otra medida de la misma empresa ya usa la mdiaabreviatura enviada.
No se envió ningún campo editable o todos los valores enviados son iguales a los actuales.
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 medidas.
El usuario autenticado no tiene un rol permitido para actualizar medidas.
El usuario autenticado está inactivo y no puede usar el sistema.
Notas de uso
Este endpoint no recibe query params.
Envía solo los campos que deseas actualizar.
El body debe incluir al menos un campo editable con un valor distinto al actual.
mdiaestado permite el valor eliminado para eliminación lógica de la medida.