3. Gestión de operadores

Ruta:

1. Inicie sesión en /admin.
2. Abra Ajustes.
3. Pulse Gestión de personal.

La pantalla Gestión de personal muestra las columnas:

• ID
• Nombre
• Usuario
• Correo
• Rol
• Estado
• acciones de Editar y Eliminar

Pulse Nuevo para crear una cuenta. El botón circular de recarga actualiza la lista sin abandonar la pantalla.

En Nuevo Operador, complete el bloque Datos:

• Nombre: nombre identificable del empleado.
• Usuario: identificador único para iniciar sesión.
• Email: correo único.
• Télefono móvil: opcional, pero útil para coordinación.
• Facebook y Twitter: opcionales; no son necesarios para autenticar.

En Configuración:

1. Seleccione Permisos Router.
2. Seleccione Tipo de Operador.
3. Decida si activa Recibir correo soporte.
4. Si cobra, indique Comisión Cobrador.
5. Marque los días de Horario acceso.
6. Complete INICIA y TERMINA.
7. Mantenga Activar acceso API apagado salvo necesidad expresa.

En Contraseña de acceso:

• escriba Contraseña;
• repítala en Repite contraseña.

En la columna Permisos, abra cada grupo y active únicamente lo necesario. Finalmente pulse Guardar. El panel debe responder Operador registrado correctamente.

Errores de alta:

• El nombre de usuario ya esta en uso. Elija otro Usuario.
• El correo ya está en uso. Use un correo distinto.
• Las contraseñas indicadas no son correctas. Vuelva a escribir ambas.
• Error de horario: TERMINA debe ser posterior a INICIA. El formulario no admite una franja que cruce medianoche; divida la política o use una franja dentro del mismo día.

El campo visible se llama Tipo de Operador y ofrece:

• Administrador
• Pagos
• Soporte técnico
• Vendedor

Este valor clasifica el rol mostrado en la lista, pero no reemplaza los interruptores de Permisos. Seleccione primero el tipo que mejor representa el puesto y después conceda cada permiso granular.

Regla práctica:

• Administrador: solo responsables del sistema.
• Pagos: caja y conciliación, sin red ni ajustes sensibles.
• Soporte técnico: clientes, tickets y diagnóstico, sin eliminación financiera.
• Vendedor: alta y consulta comercial, sin pagos, red ni ajustes.

No asuma que elegir Soporte técnico activa automáticamente todos los permisos de soporte. Compruebe los interruptores.

Use el selector múltiple Permisos Router:

• Todos los Routers concede alcance global;
• elegir nodos concretos limita la cuenta a esos nodos.

Si selecciona Todos los Routers, el formulario desmarca las selecciones individuales. Para una cuenta restringida:

1. quite Todos los Routers;
2. seleccione uno o varios nodos;
3. guarde;
4. pruebe búsquedas, tickets y clientes de un nodo permitido y de otro no permitido.

Los permisos y los nodos se complementan. Un operador puede tener permiso para abrir Clientes, pero ver un subconjunto por su alcance de nodos.

En Horario acceso, marque:

• DOM
• LUN
• MAR
• MIE
• JUE
• VIE
• SAB

Después indique:

• INICIA
• TERMINA

Ejemplo ficticio: marque LUN a SAB, escriba 08:00 en INICIA y 18:00 en TERMINA.

Pruebe tres situaciones:

1. un día y hora permitidos;
2. una hora anterior o posterior;
3. un día desmarcado.

No deje una sesión ya abierta como única prueba: cierre sesión y vuelva a entrar.

• Recibir correo soporte: actívelo solo para quienes deban recibir avisos de tickets.
• Comisión Cobrador: valor por cada pago registrado por el operador. Use 0 si no corresponde.
• Activar acceso API: obligatorio para que el operador pida un token Bearer. Sin esta casilla, POST /auth/token responde api_disabled.
• La documentación completa y el laboratorio de pruebas están en API REST v1.

No muestre tokens en capturas ni los pegue en tickets.

La API oficial usa Bearer tokens. Primero active Activar acceso API en Ajustes → Gestión de personal. Luego pida un token con usuario y contraseña en POST /auth/token.

La documentación completa, los permisos de cada ruta y un laboratorio estilo Postman están en API REST v1.

La API de comandos antigua (POST /api/v1/GetInvoice con token_api en el cuerpo) ya no existe.

Use el laboratorio de la documentación, o POST /auth/token y POST /auth/token/revoke. No registre el token en logs ni capturas. Si un operador deja de necesitar la API, desactive Activar acceso API.

En Gestión de personal, pulse el icono Editar.

La pantalla Editar Operador añade el campo Estado:

• Habilitado
• Deshabilitado

Para suspender temporalmente a una persona, prefiera Deshabilitado en vez de eliminarla. Esto facilita conservar trazabilidad e inventario.

Para cambiar la contraseña:

1. escriba la nueva en Contraseña;
2. repítala en Repite contraseña;
3. pulse Guardar.

Si no desea cambiarla, deje ambos campos vacíos. Si escribe valores distintos, el cambio no se aplica; corrija y vuelva a guardar.

Al terminar una relación laboral:

1. cambie Estado a Deshabilitado;
2. desactive Activar acceso API;
3. rote el token si pudo copiarse;
4. devuelva el inventario;
5. reasigne tickets y tareas;
6. revise pagos, herramientas de IA y conversaciones;
7. elimine la cuenta solo cuando la política de auditoría lo permita.

En la lista, pulse el icono Eliminar. El diálogo Eliminar Operador pregunta:

Esta seguro que desea eliminar este operador?

Pulse Eliminar solo después de verificar:

• inventario devuelto;
• tareas y tickets reasignados;
• sesiones e integraciones revocadas;
• registros contables y de auditoría identificables;
• existencia de otra cuenta administrativa funcional.