Ir al contenido

Usuarios y organización

Esta guía recorre las personas y la organización de la empresa por API. El agente que integra con IA tiene la versión resumida en la ficha Usuarios y organización. Desde la terminal, cada operación tiene su subcomando, por ejemplo redcumbre usuarios invitar; la lista completa está en CLI de REDCUMBRE.

  • Una llave FULL-API de producción, o de prueba para ensayar. Cómo crearla: Modo de prueba.
  • Mandar sólo los campos que cada operación declara: un campo de más responde 400 y no se guarda nada.
  • Asignar roles de plataforma o de máquina. SUPER-ADMIN, MASTER y los roles de las llaves responden 403, también dentro de un grupo de roles o al invitar. GET /{tenantSlug}/roles/assignable lista lo que sí puedes dar.
  • Tocar cuentas intocables. Una persona con SUPER-ADMIN en cualquier empresa, con un rol global o con un grupo de roles activo que lo contiene no se edita, no se quita, no se le cambian los roles ni la clave, y sus sesiones no se listan ni se cierran: responde 403.
  • Editar a una persona de dos empresas. Editar su perfil, listar sus sesiones y cerrarlas responde 403 sin nombrar a la otra empresa. Cambiarle roles, quitarla de tu empresa, restablecerle la clave y asignarle sucursales siguen abiertos.
  • Ver personas de otra empresa. Un id ajeno responde 404, igual que uno inventado.
  • Dar de alta con clave. Sólo se invita por correo (passwordMode auto_invite); temp_password, tempPassword y manual_invite responden 400. Consultar un correo responde sólo si ya es de tu empresa.
  • Fijar o leer claves. El restablecimiento sólo envía el correo: una petición con password responde 400 y ninguna respuesta trae una clave.
  • Registrar, conectar o anular puestos. Registrar un puesto, usar «este navegador», la reconexión, anular y levantar el bloqueo son del panel y del aparato del puesto.
  • Cambiar el RUT de una persona. Es sólo del panel.

Cada vez que una llave de producción da ADMIN, los SUPER-ADMIN de la empresa reciben un aviso que nombra a la persona y a la llave.

Qué hacesRutaComando
Invitar a una personaPOST /{tenantSlug}/usersredcumbre usuarios invitar
Saber si un correo ya es de la empresaGET /{tenantSlug}/users/check-emailredcumbre usuarios verificar-correo
Listar a las personas (paginado)GET /{tenantSlug}/usersredcumbre usuarios listar
Ver a una personaGET /{tenantSlug}/users/{id}redcumbre usuarios ver
Editar nombre, apellido o teléfonoPATCH /{tenantSlug}/users/{id}redcumbre usuarios editar
Quitarla de la empresaDELETE /{tenantSlug}/users/{id}redcumbre usuarios quitar
Ver el estado de su PIN del puestoGET /{tenantSlug}/users/{id}/pin-del-puestoredcumbre usuarios pin-del-puesto
Marcar si opera en puestosPUT /{tenantSlug}/users/{id}/pin-del-puesto/marcaredcumbre usuarios opera-en-puestos
Cambiar sus rolesPOST /{tenantSlug}/users/{id}/rolesredcumbre usuarios asignar-roles
Ver sus rolesGET /{tenantSlug}/users/{id}/rolesredcumbre usuarios roles
Enviarle el correo para elegir una clave nuevaPOST /{tenantSlug}/users/{id}/reset-passwordredcumbre usuarios restablecer-clave
Listar sus sesionesGET /{tenantSlug}/users/{id}/sessionsredcumbre usuarios sesiones
Cerrar sus sesionesPOST /{tenantSlug}/users/{id}/terminate-sessionsredcumbre usuarios cerrar-sesiones
Qué hacesRutaComando
Listar el catálogo de rolesGET /rolesredcumbre roles listar
Listar los roles asignablesGET /roles/assignableredcumbre roles asignables
Listar lo que la llave puede asignar en la empresaGET /{tenantSlug}/roles/assignableredcumbre roles asignables-de-empresa
Ver un rolGET /roles/{roleId}redcumbre roles ver
Qué hacesRutaComando
Listar los gruposGET /{tenantSlug}/role-groupsredcumbre grupos-de-roles listar
Ver si están al día con el proveedor de identidadGET /{tenantSlug}/role-groups/sync-statusredcumbre grupos-de-roles sincronizacion
Ver un grupoGET /{tenantSlug}/role-groups/{id}redcumbre grupos-de-roles ver
Ver sus miembrosGET /{tenantSlug}/role-groups/{id}/usersredcumbre grupos-de-roles usuarios
Crear un grupoPOST /{tenantSlug}/role-groupsredcumbre grupos-de-roles crear
Editar un grupoPUT /{tenantSlug}/role-groups/{id}redcumbre grupos-de-roles editar
Eliminar un grupoDELETE /{tenantSlug}/role-groups/{id}redcumbre grupos-de-roles eliminar
Activar o desactivar un grupoPATCH /{tenantSlug}/role-groups/{id}/toggle-activeredcumbre grupos-de-roles activar-o-desactivar
Qué hacesRutaComando
Listar los gruposGET /{tenantSlug}/grupos-de-personasredcumbre grupos-de-personas listar
Crear un grupoPOST /{tenantSlug}/grupos-de-personasredcumbre grupos-de-personas crear
Ver un grupoGET /{tenantSlug}/grupos-de-personas/{id}redcumbre grupos-de-personas ver
Cambiarle el nombrePATCH /{tenantSlug}/grupos-de-personas/{id}redcumbre grupos-de-personas editar
Archivar un grupoPOST /{tenantSlug}/grupos-de-personas/{id}/archivarredcumbre grupos-de-personas archivar
Sumar una personaPOST /{tenantSlug}/grupos-de-personas/{id}/personasredcumbre grupos-de-personas agregar-persona
Ver qué pasa si se quita a una personaGET /{tenantSlug}/grupos-de-personas/{id}/personas/{usuarioId}/quitarredcumbre grupos-de-personas consultar-quitar-persona
Quitar a una personaDELETE /{tenantSlug}/grupos-de-personas/{id}/personas/{usuarioId}redcumbre grupos-de-personas quitar-persona
Qué hacesRutaComando
Listar las áreasGET /{tenantSlug}/areas-de-trabajoredcumbre areas listar
Crear un áreaPOST /{tenantSlug}/areas-de-trabajoredcumbre areas crear
Ver las opciones para armar los filtrosGET /{tenantSlug}/areas-de-trabajo/opcionesredcumbre areas opciones
Ver un áreaGET /{tenantSlug}/areas-de-trabajo/{id}redcumbre areas ver
Ver quién operó en el áreaGET /{tenantSlug}/areas-de-trabajo/{id}/quien-operoredcumbre areas quien-opero
Ver, por puesto del área, las personas disponiblesGET /{tenantSlug}/areas-de-trabajo/{id}/disponiblesredcumbre areas disponibles
Editar un áreaPATCH /{tenantSlug}/areas-de-trabajo/{id}redcumbre areas editar
Archivar un áreaPOST /{tenantSlug}/areas-de-trabajo/{id}/archivarredcumbre areas archivar
Asociar bodegas al áreaPUT /{tenantSlug}/areas-de-trabajo/{id}/bodegasredcumbre areas asociar-bodegas
Qué hacesRutaComando
Ver la configuración de los puestosGET /{tenantSlug}/puestos/configuracionredcumbre puestos configuracion
Configurar el cambio rápidoPATCH /{tenantSlug}/puestos/configuracion/cambio-rapidoredcumbre puestos cambio-rapido
Configurar los tiemposPATCH /{tenantSlug}/puestos/configuracionredcumbre puestos tiempos
Listar los puestosGET /{tenantSlug}/puestosredcumbre puestos listar
Ver un puestoGET /{tenantSlug}/puestos/{id}redcumbre puestos ver
Editar un puestoPATCH /{tenantSlug}/puestos/{id}redcumbre puestos editar
Dar de baja un puestoPOST /{tenantSlug}/puestos/{id}/bajaredcumbre puestos desactivar
Ver los movimientos de un puestoGET /{tenantSlug}/puestos/{id}/movimientosredcumbre puestos movimientos
Qué hacesRutaComando
Asignar sucursales a una personaPOST /{tenantSlug}/dte/usuarios/{userId}/sucursalesredcumbre sucursales-de-usuarios asignar
Listar las sucursales que se pueden asignarGET /{tenantSlug}/dte/sucursales/para-asignacionredcumbre sucursales-de-usuarios para-asignacion
Ver las sucursales de una personaGET /{tenantSlug}/dte/usuarios/{userId}/sucursalesredcumbre sucursales-de-usuarios listar
Quitarle las sucursales de un emisorDELETE /{tenantSlug}/dte/usuarios/{userId}/emisores/{emisorId}/sucursalesredcumbre sucursales-de-usuarios quitar-de-emisor

Una persona sale con id, zitadelUserId, email, nombre, apellido, nombreCompleto, rut, telefono, sus roles y gruposDeRoles de esta empresa, createdAt y updatedAt; nunca claves, segundo factor, IP ni roles de otra empresa. GET /{tenantSlug}/users se pagina con page y limit (hasta 300). Las rutas de sucursales usan el zitadelUserId de la persona. El 409 de una invitación significa que la persona ya es de tu empresa.

Con una llave de prueba, todo responde desde un conjunto de ejemplo y no se guarda nada: no se invita a nadie, no se cambian roles y no se manda ningún correo. Las escrituras validan el cuerpo como en producción y responden como hechas, con identificadores negativos. El techo de roles y las cuentas intocables rigen igual. Nada se cobra. Cuando todo funcione, repite con la llave de producción.