Configuración inicial (asistente)

Para qué sirve

El asistente te guía, paso a paso, para dejar tu primera estación lista para vender: datos de la empresa, estación, tanques con su tabla de aforo, islas y mangueras, precios, playeros con PIN y el primer turno. No es un formulario aparte: cada paso abre la misma pantalla del módulo (Mi empresa, Estaciones, Tanques, Playa, Precios, Usuarios), así que lo que configures aquí queda guardado igual que si lo hicieras desde el menú.

El avance se calcula solo, mirando los datos reales de tu empresa: si ya registraste un tanque desde el menú, el paso de tanques aparece avanzado.

Dónde está

Menú:Configuración›Configuración inicial/asistente

Además, al iniciar sesión el sistema te lleva automáticamente al asistente si todavía no lo completaste (una vez por sesión).

Quién puede

Acción	Permiso
Ver y usar el asistente	Permisoasistente.usar

De fábrica solo lo tiene el rol Administrador. Está disponible en todos los planes. Para completar cada paso también necesitas los permisos del módulo que se abre (por ejemplo, tanques.crear para agregar tanques o usuarios.gestionar_pin para dar PIN a los playeros).

:::info No te redirige cuando…

• Tu rol no tiene asistente.usar.
• Estás en un terminal POS (ingreso con PIN).
• Es una sesión de soporte (impersonación).
• Ya te llevó una vez en esta sesión. :::

Los 7 pasos

A la izquierda verás el listado de pasos con su estado; a la derecha, el contenido del paso activo.

Paso	Qué haces	Cuándo queda completo	¿Obligatorio?
1. Datos de la empresa	Se abre Mi empresa con sus pestañas.	Hay razón social, RUC y dirección fiscal. Nubefact (URL y token) se recomienda pero no bloquea.	Sí (Nubefact: no)
2. Primera estación	Eliges la Estación a configurar y pulsas Usar esta estación. Debajo tienes la lista de estaciones para crear o editar.	La estación elegida existe, está activa y tiene su registro de hidrocarburos.	Sí
3. Tanques y aforo	Agregar tanque, Editar y Tabla de aforo de cada tanque, con su medidor de nivel.	Hay al menos un tanque activo y todos tienen tabla de aforo.	Sí
4. Islas, surtidores y mangueras	Se abre el configurador de la playa de la estación.	Hay al menos una manguera operativa.	Sí
5. Precios	Se abren los precios vigentes con el cambio en lote.	Todos los productos que tienen manguera operativa tienen precio vigente.	Sí
6. Playeros con PIN	Se abre Usuarios.	Hay al menos un usuario activo, con PIN, con la estación entre sus permitidas, con un rol que tenga pos.acceder y vinculado a una ficha de Personal activa cuyo cargo tenga marcado «Es playero» (es decir, asignable a turnos).	Sí
7. Primer turno	Botón Abrir primer turno: te lleva a Turnos.	La estación ya abrió al menos un turno.	No

Los pasos 3 al 6 están deshabilitados hasta que elijas la estación en el paso 2 («Elige primero la estación a configurar en el paso 2.»).

Cada paso muestra una insignia Completo, Pendiente u Opcional y una línea de detalle que te dice qué falta, por ejemplo «Sin tabla de aforo: T02.» o «Sin precio vigente: GLP.».

Paso a paso

Completar el asistente

1. Abre el asistente
   Entra desde Configuración › Configuración inicial o deja que el sistema te lleve al iniciar sesión.
2. Avanza con «Siguiente»
   Completa cada paso en su panel y pulsa Siguiente. Puedes volver con Anterior o hacer clic en cualquier paso habilitado de la lista.
3. Elige la estación en el paso 2
   Si aún no tienes estación, créala con su registro de hidrocarburos en la lista de abajo; luego elígela en Estación a configurar y pulsa Usar esta estación.
4. Revisa el detalle de cada paso
   La lista de la izquierda se actualiza sola cada vez que guardas algo dentro de un paso.
5. Pulsa «Finalizar»
   En el último paso, Finalizar se habilita cuando todos los pasos obligatorios están completos. Verás «Configuración inicial completada.» y un resumen con el mapa de tu playa.
6. Ve al inicio
   Pulsa Ir al inicio.

Dejarlo para después

1. Pulsa «Configurar después»
   Está abajo a la izquierda. Verás «Puedes retomar la configuración desde el inicio.» y pasarás al dashboard.
2. Retómalo cuando quieras
   Mientras falten pasos obligatorios, el dashboard muestra el aviso «Completa la configuración inicial» con la lista de lo que falta y el botón Continuar configuración. También puedes volver desde el menú.

:::tip Empresas que ya tenían todo Si tu empresa ya tenía todos los pasos obligatorios completos (por ejemplo, porque configuraste todo desde el menú), al abrir el asistente se marca como completado automáticamente. :::

Estados del asistente

Pendiente → omitido (configurar después) → Completado

• pendiente: aún no se completa. Te redirige al iniciar sesión.
• omitido: pulsaste Configurar después. Ya no te redirige; el dashboard muestra el aviso. Al volver a abrir el asistente, regresa a pendiente.
• completado: lo finalizaste. El sistema recuerda quién y cuándo.

Mensajes frecuentes

Mensaje	Por qué pasa	Qué hacer
«Elige la estación a configurar.»	Pulsaste Usar esta estación sin elegir.	Selecciona una estación de la lista.
«Elige primero la estación a configurar.»	Intentaste avanzar a un paso que necesita estación.	Completa el paso 2.
«Aún falta: …»	Pulsaste Finalizar con pasos obligatorios pendientes.	Completa los pasos que se listan.
«Falta el registro de hidrocarburos de la estación.»	La estación no tiene ese dato.	Edita la estación y complétalo.
«Crea al menos un playero: usuario con PIN y acceso al POS, asignado a la estación y vinculado a una ficha de Personal cuyo cargo tenga marcado «Es playero».»	Ningún usuario cumple las condiciones del paso 6.	Crea el usuario con rol Playero, márcale la estación, ponle PIN y vincúlalo a su ficha de personal (cargo Playero/Islero).
«N usuario(s) con PIN aún no se pueden asignar a un turno: vincúlalos a una ficha de Personal activa cuyo cargo tenga marcado «Es playero».»	Hay usuarios con PIN, pero sin ficha de playero activa.	En Usuarios, acción Vincular ficha de personal.

Empresa de demostración

Para capacitaciones y pruebas, el proveedor del sistema puede preparar una empresa de demostración ya configurada y con movimientos. No se crea desde esta pantalla: la genera soporte en un ambiente de pruebas (nunca en producción sin autorización expresa). Lo que trae:

• Empresa Grifos MDSYS Demo S.A.C. en plan Full (en prueba), con el asistente ya completado.
• Dos estaciones: E01 · EESS Los Olivos (estación de servicio 24 h) y E02 · Grifo Huacho.
• Tanques con aforo, playa, precios, terminales POS e impresión configurados.
• Usuarios de ejemplo con sus roles: un administrador, jefeplaya (Jefe de Playa), playero1 a playero3 (E01) y playero4 (E02) con PIN, cajero, creditos (Créditos y Cobranzas) y almacen (Almacén).
• Historial operativo: turnos, ventas, comprobantes, cajas, tesorería, créditos, cobranzas, compras, inventario, market, guías, percepciones, fidelización y reportes regulatorios de ejemplo.

Las contraseñas y PIN de la demo los entrega soporte; no están publicados en este manual.

:::warning Datos ficticios Todo en la empresa demo es ficticio (RUC, registros de hidrocarburos y códigos SCOP marcados como DEMO). No la uses para emitir comprobantes reales. :::

Relación con otros módulos

• Mi empresa (paso 1) · Usuarios (paso 6).
• Configuración: estaciones, tanques, aforo, playa y precios (pasos 2 a 5).
• Turnos: abrir el primer turno (paso 7).