Panel Súper Admin (proveedor)

:::info Esta página es para el proveedor El panel Súper Admin lo usa el equipo que comercializa y da soporte a MDSYS Grifos, no los grifos clientes. Si eres usuario de una empresa, no tienes acceso a este panel; lo que te afecta está en Planes y límites y en Seguridad y acceso. :::

Para qué sirve

Desde este panel el proveedor da de alta las empresas (grifos clientes), les asigna y activa un plan, las suspende o cancela, revisa su consumo, entra a ayudarlas (impersonación), mantiene el catálogo de planes y el catálogo maestro de productos, y monitorea la operación de todos los grifos.

Dónde está

Es un área separada del sistema: se entra por /superadmin/login. Menú lateral:

Ítem	Ruta	Qué es
Empresas	/superadmin	Lista de empresas (pantalla de inicio del panel).
Planes	/superadmin/planes	Catálogo de planes.
Productos maestro	/superadmin/productos-maestro	Catálogo maestro de productos.
Dashboard	/superadmin/dashboard	Métricas del SaaS y de la operación de grifos.
Auditoría	/superadmin/auditoria	Acciones de los superadmins.

Ingreso con verificación en dos pasos

1. Correo y contraseña
   En Súper Admin — «Acceso al panel de la plataforma», escribe Correo y Contraseña.
2. Primer acceso: configura el segundo factor
   La primera vez verás Configura el segundo factor con un código QR. Escanéalo con una app de autenticación (Google Authenticator, Microsoft Authenticator…) y escribe el Código generado.
3. Guarda los códigos de respaldo
   Se muestran 8 Códigos de respaldo una sola vez («Guarda estos códigos de respaldo en un lugar seguro. No volverán a mostrarse.»). Cada uno sirve una sola vez si pierdes el celular.
4. Accesos siguientes
   Tras correo y contraseña verás Verificación en dos pasos: escribe el Código de verificación de 6 dígitos de tu app (o un código de respaldo).

Seguridad: 5 fallos (de contraseña o de código) bloquean el acceso 15 minutos; además, solo 5 intentos de ingreso cada 5 minutos por conexión. El código de la app cambia cada 30 segundos.

Empresas

La lista

• Botón Nueva empresa.
• Filtros: Todas, En prueba, Activas, Suspendidas, Canceladas.
• Buscador «Buscar por razón social, RUC o email».
• Una tarjeta por empresa con logo, nombre, RUC, estado y: Plan, Inicio, Fin, Meses y Monto total de la suscripción.
• Acciones de la tarjeta: Acceder (impersonar), Editar, Uso del plan, Activar (en prueba o suspendida), Suspender y Cancelar (según el estado).

Estados de una empresa

Prueba Activa Suspendida Cancelada

• prueba y activa: los usuarios de la empresa pueden trabajar.
• suspendida: nadie de la empresa puede entrar («Empresa no disponible. Contacta a soporte.»). Se revierte con Activar.
• cancelada: definitivo.

:::danger Cancelar es irreversible «Cancelar una empresa es IRREVERSIBLE: no podrá reactivarse. ¿Continuar?». Para un corte temporal usa Suspender («Suspender bloquea el acceso de la empresa hasta reactivarla. ¿Continuar?»). :::

Suspensión y turnos abiertos

Una suspensión nunca corta un turno abierto. Si la empresa tiene un turno abierto o en cierre:

• La suspensión queda pendiente: la tarjeta muestra la insignia Suspensión pendiente (turno abierto) y el aviso «Suspensión pendiente: se aplicará al cerrarse el turno abierto (máx. 12 h).». Mientras tanto no se ofrece Suspender de nuevo.
• Se aplica sola al cerrarse el turno, o a las 12 horas como máximo.
• La empresa recibe una notificación.

Además, un proceso automático revisa cada hora las facturas del servicio: con una factura vencida hace más de 5 días, solicita la suspensión (con la misma regla de turnos). Si la empresa paga antes, la suspensión pendiente por impago se anula.

Crear una empresa

1. Pulsa «Nueva empresa»
   Se abre el formulario.
2. Datos de la empresa
   Razón social, Nombre comercial (opcional), RUC, Correo de la empresa (opcional), Teléfono (opcional), Dirección (opcional).
3. Plan y logo
   Elige el Plan y, si quieres, sube el Logo (opcional).
4. Administrador inicial
   Nombres, Apellidos (opcional) y Correo del administrador.
5. Guarda
   Pulsa Guardar. Verás «Empresa creada — se envió la bienvenida al administrador.».

Al crear la empresa, en una sola operación (todo o nada) se preparan:

• La empresa en estado prueba, con una suscripción de prueba del plan elegido.
• Los 9 roles base con sus permisos (ver Roles y permisos).
• Los cargos del grifo, el cliente CLIENTES VARIOS, 8 medios de pago base, los productos base copiados del catálogo maestro (solo los que el plan permite) y los ajustes fiscales por defecto.
• El usuario administrador (rol Administrador), pendiente de activar: recibe el correo de bienvenida con un enlace de 72 horas para definir su contraseña.

Si algo falla a mitad, no se crea nada. El RUC no puede repetirse («El RUC ya está registrado en otra empresa.»).

Editar una empresa

Editar permite cambiar razón social, nombre comercial, RUC, correo, teléfono y dirección. El plan no se cambia aquí (ver Activar).

Activar por N meses

1. Pulsa «Activar»
   Disponible en empresas en prueba o suspendidas. Se abre Activar empresa.
2. Elige plan, inicio y meses
   Plan, Fecha de inicio (por defecto hoy) y Meses. La Fecha de fin se calcula sola.
3. Revisa el detalle
   La tabla muestra cada mes: #, Desde, Hasta, Monto y Acumulado.
4. Guarda
   Pulsa Guardar. Verás «Empresa activada.»: la suscripción queda activa y la empresa en estado activa.

Ejemplo: plan Pro (S/ 349.00 al mes), inicio 01/11/2026, 3 meses → Fecha de fin 01/02/2027; los periodos son 01/11–30/11, 01/12–31/12 y 01/01–31/01, con un acumulado de S/ 1,047.00.

Mensajes: «Plan no válido o inactivo.», «Los meses deben ser un entero mayor o igual a 1.», «La fecha de inicio debe ser una fecha válida (YYYY-MM-DD).».

Uso del plan de una empresa

Uso del plan abre las barras de consumo (transacciones del mes, estaciones, mangueras, usuarios, clientes a crédito, almacenamiento) y el Historial de periodos con Periodo, Transacciones, Galones, Nivel, Excedente y Estado. Ver los niveles en Planes y límites.

Impersonación (Acceder)

Acceder abre la empresa en una pestaña nueva, como si fueras un usuario de ella, para dar soporte.

• El sistema genera un código de un solo uso (válido segundos) que la pestaña nueva canjea por un acceso de 30 minutos. El acceso nunca viaja en la dirección web.
• En la empresa se muestra el aviso Solo lectura operativa y el botón Salir de la empresa.
• Ves todo lo que el plan de la empresa incluye y puedes ayudar con la configuración, pero no puedes vender, operar turnos, cambiar precios, mover inventario ni dinero, emitir o corregir comprobantes ni cambiar credenciales. La lista completa está en Seguridad y acceso.
• Cada impersonación queda en la Auditoría del panel.

Planes

La lista

Buscador «Buscar por nombre» y tabla con Plan, Precio, Límites, Estado y Acción (editar, desactivar).

Crear o editar un plan

Campo	¿Obligatorio?	Descripción
NombreTexto	Sí	Por ejemplo «Pro».
Días de pruebaNúmero	No	Días de prueba de una empresa nueva con este plan.
Descripción (opcional)Texto	No	Texto libre.
Precio mensual (S/)S/	No	Precio por mes.
Precio anual (S/)S/	No	Precio por año.
Estaciones, Mangueras, Transacciones / mes, Usuarios, Clientes a créditoNúmero	No	Límites del plan. Cada uno tiene la casilla Ilimitado.
Almacenamiento (MB)Número	Sí	Espacio de archivos (no admite ilimitado).
Excedente de gracia (%)Número	No	«Transacciones extra permitidas sobre el límite (0–100).» Por defecto 20.
Módulos del planCasillas	No	Agrupados en Básico, Pro y Full. Los botones Preset Básico, Preset Pro y Preset Full marcan el conjunto de cada nivel.

Los módulos Dashboard, Mi empresa, Usuarios, Roles y permisos, Ajustes, Estaciones, POS, Turnos y Ventas se incluyen siempre, aunque no los marques.

Desactivar un plan (con confirmación) lo saca de la lista de planes elegibles; no afecta a las empresas que ya lo tienen.

Productos maestro

Catálogo global de productos (combustibles, GLP, GNV, market, lubricantes, servicios) que se copia a cada empresa nueva. Editar el maestro no cambia los productos de empresas ya creadas.

• Tabla: Código, Nombre, Tipo, Unidad (SUNAT), Color, Módulo requerido y Estado; acciones Editar y Dar de baja.
• Campos: Nombre, Nombre corto (máx. 12, en mayúsculas), Tipo (Combustible líquido, GLP vehicular, GNV, GLP en balón, Market, Lubricante, Servicio), Unidad, Código de producto SUNAT (8 dígitos, opcional), Afectación IGV, Sujeto a percepción, Placa obligatoria en factura, Color (#RRGGBB), Módulo requerido (solo se copia si el plan lo incluye, por ejemplo gnv), Orden y Activo.
• Si creas un producto con el mismo nombre corto que uno dado de baja, se restaura en lugar de duplicarse.

Dashboard

• Tarjetas: Empresas activas, Ingresos del mes y Cobranza pendiente.
• Empresas por estado: Activas, Prueba, Suspendidas y Canceladas.
• Uso vs límite del plan de las empresas.
• Operación de grifos: Galones vendidos, Transacciones, Estaciones activas, Mangueras operativas, ranking de empresas y el indicador Estaciones sin reporte diario de inventario.

Auditoría global

Acciones de superadmins con la casilla Solo impersonaciones. Columnas: Acción, Empresa, Superadmin, Impersonación y Descripción. Aquí quedan las altas, cambios de estado, activaciones, cambios de plan e impersonaciones.

Relación con otros módulos

• Planes y límites · Roles y permisos · Seguridad y acceso · Configuración inicial.