Manual del Distribuidor
Guía de gestión de tus empresas y usuarios en Revo Analytics.
Introducción
Como Distribuidor eres un partner que gestiona uno o varios negocios (tenants) dentro de la plataforma.
Tu ámbito de visión abarca solo tus propios recursos:
- Los tenants (empresas) asignados a tu distribuidora.
- Los usuarios vinculados a tus tenants.
- Las API Keys de tus tenants.
- El log ETL de carga de datos de tus tenants.
No tienes visibilidad sobre otros distribuidores ni sobre tenants que no te pertenecen.
Acceso al panel
Abre /panel en tu navegador.
Introduce tu email y contraseña (proporcionados por el administrador de la plataforma).
Al iniciar sesión verás tu nombre y el badge distribuidor.
📊 Dashboard
La pantalla principal muestra un resumen de tu cartera:
| KPI | Descripción |
|---|---|
| Tenants | Cuántas empresas tienes asignadas y cuántas están activas. |
| Usuarios | Total de usuarios del panel vinculados a tus tenants. |
| Informes | Informes BI generados por tus empresas. |
Debajo encontrarás las últimas 5 ejecuciones ETL de tus tenants: quién se ejecutó, si fue exitoso o falló, y los datos procesados.
🏪 Mis Tenants
Los tenants son tus clientes / empresas: cada restaurante, cafetería o negocio cuyos datos se cargan desde Revo XEF.
Vista de la tabla
| Columna | Significado |
|---|---|
| Nombre | Nombre del negocio. |
| Activo | Si está activo puede usar el dashboard y se ejecuta el ETL. |
| ETL | 🟢 On: la carga nocturna está habilitada. 🔴 Off: deshabilitada. |
| Hora ETL | Hora programada para la carga automática de datos. |
| Último ETL | Fecha de la última carga exitosa. |
| Tokens | ✅ Tiene tokens de Revo configurados. ❌ No tiene (no podrá ejecutar ETL). |
Crear un nuevo tenant
Haz clic en "+ Nuevo Tenant".
Rellena:
- Nombre: Nombre visible del negocio (ej: "Pizzería Roma").
- Slug: Identificador único sin espacios (ej:
pizzeria-roma). - Empresa ID: El ID numérico de la empresa en Revo XEF.
Guarda. El tenant se asigna automáticamente a tu distribuidora.
Editar un tenant
Haz clic en ✏️ para abrir el modal de edición. Puedes cambiar:
- Nombre — Nombre del negocio.
- Activo — Activar/Desactivar el tenant.
- ETL Habilitado — Habilitar/Deshabilitar la carga nocturna.
- Hora ejecución ETL — A qué hora se ejecuta la carga de datos.
- Tokens OAuth de Revo — Pegar o actualizar los tokens de conexión con Revo XEF.
Ejecutar ETL manual
El botón ⚙️ lanza una carga de datos incremental inmediata para ese tenant. Útil cuando:
- El cliente necesita ver datos actualizados ahora mismo.
- La carga nocturna falló y quieres reintentarla.
- Acabas de configurar los tokens y quieres probar que funciona.
👥 Mis Usuarios
Puedes crear usuarios tenant_admin para que tus clientes accedan al dashboard BI con su propia cuenta.
Crear un usuario para un cliente
Pestaña "Usuarios" → "+ Nuevo Usuario".
Rellena:
- Nombre: Nombre del usuario.
- Email: Email que usará para iniciar sesión.
- Contraseña: Contraseña inicial (el usuario no puede cambiarla él mismo).
- Tenant: La empresa a la que pertenece este usuario.
El rol se asigna automáticamente como tenant_admin.
Resetear la contraseña de un usuario
Edita el usuario con ✏️ y escribe la nueva contraseña en el campo correspondiente. Al guardar, la contraseña se actualiza.
🔑 API Keys
Las API Keys son las claves que entregas a tus clientes para que accedan al dashboard BI web y conecten Power BI.
Crear una API Key
Pestaña "API Keys" → "+ Nueva API Key".
Selecciona el Tenant (solo verás tus tenants) y ponle un nombre (ej: "Clave principal Pizzería").
Al guardar se muestra la clave completa: ra_xxxxxxxxxxxxxxx...
Monitorizar uso
En la tabla de API Keys puedes ver:
- Requests hoy: Cuántas peticiones ha hecho hoy ese cliente.
- Máx/día: Límite diario (10.000 por defecto).
- Último acceso: Cuándo usó la clave por última vez.
Revocar una API Key
Si un cliente deja de operar o sospechas que la clave está comprometida, elimínala con el botón 🗑. El acceso se corta inmediatamente.
⚙️ Log ETL
Registro de cargas de datos de tus tenants. Te permite monitorizar si la carga nocturna funcionó correctamente.
| Columna | Significado |
|---|---|
| Tenant | Qué empresa se procesó. |
| Status | success = OK, error = falló, running = en curso. |
| Duración | Cuánto tardó (en segundos). |
| Órdenes | Pedidos procesados. |
| Error | Mensaje de error si falló (pasa el ratón para leerlo completo). |
¿Qué hacer si un ETL falla?
| Error común | Solución |
|---|---|
| Token expirado / 401 | Edita el tenant → pega nuevos tokens OAuth → ejecuta ETL manual. |
| Empresa no encontrada | Verifica que el Empresa ID del tenant es correcto en Revo XEF. |
| Timeout / conexión | Puede ser un problema temporal de la API de Revo. Espera y reintenta. |
| ETL deshabilitado | Edita el tenant → Activa "ETL Habilitado". |
👁️ Impersonar un tenant
La impersonación te permite "ver como" uno de tus tenants. Es útil para dar soporte a un cliente o verificar que todo funciona.
En la pestaña Tenants, haz clic en 👁️ del tenant que quieres impersonar.
Aparece un banner amarillo pulsante en la parte superior: "Impersonando: Nombre del Tenant".
Toda la información visible se filtra por ese tenant: sus usuarios, sus API keys, su log ETL.
Para salir, haz clic en "✕ Salir de impersonación" en el banner.
🚀 Entregar acceso a un nuevo cliente
Flujo completo cuando un nuevo restaurante contrata el servicio:
Crear el tenant
Pestaña Tenants → + Nuevo Tenant. Introduce el nombre del negocio, un slug y el Empresa ID de Revo XEF.
Configurar tokens OAuth
Edita el tenant → pega los tokens Access y Refresh de Revo en los campos correspondientes.
Configurar hora ETL
En la misma edición, selecciona la hora de ejecución según el horario de cierre del negocio.
Primera carga de datos
Haz clic en el botón ⚙️ para lanzar el primer ETL manual. Verifica en el Log ETL que sale success.
Crear API Key
Pestaña API Keys → + Nueva API Key → selecciona el tenant. Copia la clave que aparece.
Entregar al cliente
Envía al cliente:
- La URL del dashboard (la raíz de la plataforma).
- La API Key que acabas de copiar.
- El Manual de Usuario (
/manual-usuario) para que sepa usar el dashboard. - Si quiere usar Power BI: la URL OData (
/odata/v1/) y las instrucciones de conexión del manual de usuario.
❓ Preguntas frecuentes
¿Puedo cambiar la API Key de un cliente?
No puedes modificar una clave existente. Elimina la actual y crea una nueva. Entrega la nueva clave al cliente (tendrá que introducirla de nuevo en su navegador).
¿Cuántos tenants puedo tener?
Tu distribuidora tiene un límite máximo de tenants configurado por el administrador de la plataforma. Si necesitas más, contacta al soporte.
¿Qué pasa si un tenant tiene el ETL deshabilitado?
No se ejecutará la carga nocturna automática. Los datos del dashboard quedarán congelados en la última carga exitosa. El cliente puede seguir accediendo pero verá datos desactualizados.
¿Puedo ejecutar un ETL de tipo "full"?
Desde el panel solo se puede ejecutar ETL incremental. Si necesitas una recarga completa, contacta al administrador de la plataforma.
¿Qué ve el cliente cuando accede con su API Key?
Ve el dashboard BI completo con 13 páginas de análisis, informes y alertas. Solo ve los datos de su negocio. No puede acceder al panel de administración ni ver datos de otros clientes.
Revo Analytics — Manual Distribuidor v1.0 — Febrero 2026