Endpoints / Empresas
Actualizar estado de empresa
Actualiza el estado de una empresa, permitiendo activar, inactivar o eliminar lógicamente desde administración central.
/companies/:id/statusCaso de Uso
Se usa cuando un administrador necesita cambiar el estado de una empresa hija, ya sea para activarla, inactivarla temporalmente o marcarla como eliminada. Al usarlo, el usuario obtiene un mensaje de confirmación del cambio de estado.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`. Solo permite acceso a usuarios con rol administrador. La empresa del usuario autenticado debe estar activa y ser empresa padre.
Parámetros de ruta
idstringobligatorioIdentificador de la empresa.
Body
emestadostringobligatorioNuevo estado de la empresa; acepta activo, inactivo o eliminado.
Reglas de negocio
Solo un usuario con rol administrador puede cambiar el estado de una empresa.
La empresa del usuario autenticado debe ser empresa padre.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
emestado es obligatorio y solo acepta activo, inactivo o eliminado.
Si la empresa objetivo está en estado eliminado, no puede cambiarse su estado nuevamente.
Este endpoint puede operar sobre cualquier empresa hija, no solo sobre la del usuario autenticado.
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 empresa objetivo no existe o la actualización no se completó.
El id enviado al servicio fue vacío.
emestado fue enviado vacío.
emestado tiene un valor no permitido.
La empresa objetivo ya está en estado eliminado.
La empresa asociada al usuario autenticado no fue encontrada.
La empresa asociada al usuario autenticado está inactiva.
La empresa del usuario autenticado no es empresa padre.
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 no tiene el rol requerido para cambiar el estado de una empresa.
El usuario autenticado está inactivo y no puede usar el sistema.
Notas de uso
Este endpoint no recibe query params.
Es un endpoint administrativo y no reemplaza la actualización de datos generales de empresa.
La respuesta exitosa no devuelve el objeto empresa completo, solo un mensaje de confirmación.