Qué es CHABI
CHABI es el portal interno de Octopus Energy Spain donde centralizamos herramientas que facilitan el día a día del equipo.
CHABI — *Your 6 other arms* — reúne utilidades operativas en un solo sitio: descarga de facturas, gestión de campañas Kraken, solicitudes de CUPS, seguimiento de KMTs, calendario de comunicaciones y herramientas de oficina. Tras iniciar sesión, el hub en `/home/` muestra las herramientas a las que tienes acceso.
¿Para qué sirve?
- Automatizar tareas repetitivas con Kraken y otros sistemas
- Coordinar comunicaciones y campañas con el resto del equipo
- Gestionar solicitudes operativas (CUPS, KMTs, facturas)
- Organizar la vida de oficina: reservas, material, eventos y más
Cada herramienta tiene su propio permiso. Solo verás en el hub las tarjetas para las que tu cuenta está autorizada. Puedes acceder desde el navegador en https://oees-chabi.com.
Primer acceso
Para usar CHABI necesitas una cuenta corporativa aprobada por el equipo de Tech.
Regístrate
Ve a https://oees-chabi.com/accounts/signup/ y crea tu cuenta con tu correo corporativo (@octopusenergy.es, @octoenergy.com, @octo.es, @octoes.es, @octopusenergy.services o @octopusenergylct.es).
Espera la aprobación
Tu cuenta queda pendiente hasta que un superusuario la apruebe y te asigne los roles necesarios. Contacta con [email protected] si tarda más de lo esperado.
Inicia sesión
Una vez aprobado, entra en https://oees-chabi.com/accounts/login/ con tu correo y contraseña. Serás redirigido al hub en `/home/`.
Recupera tu contraseña si hace falta
Desde la pantalla de login puedes usar "Forgot password?" para recibir un enlace de restablecimiento por email.
Roles y permisos
Cada herramienta de CHABI está protegida por un grupo Django. Solo verás las tarjetas y rutas para las que tienes permiso.
Los superusuarios ven todo y pueden gestionar cuentas pendientes en `/accounts/pending-users/`. El resto de usuarios recibe permisos al aprobar su cuenta o al editar sus roles desde esa misma pantalla.
Grupos y herramientas
| Grupo / Group | Herramienta / Tool |
|---|---|
| Invoices | Download Invoices |
| CUPS Manager | CUPS Manager |
| Campaign Manager | Campaign Manager |
| KMTs | KMTs in progress |
| Communications Calendar (Viewer) | Communications Calendar — ver eventos |
| Communications Calendar (Creator) | Communications Calendar — crear eventos |
| Communications Calendar (Admin) | Communications Calendar — editar y borrar |
| Office Managers | Office — funciones de administración |
Excepciones
- Office aparece en el hub para todos los usuarios autenticados; funciones básicas (Family Dinner, Going, Octo-Love) solo requieren login.
- Timlili es visible en el hub sin grupo dedicado; está en desarrollo.
- Si accedes a una URL sin permiso, recibirás un error 403 aunque conozcas la ruta.
Download Invoices
Descarga masiva de facturas desde Kraken por portfolio y rango de fechas.
Esta herramienta genera un ZIP con facturas organizadas por carpeta de cuenta. El proceso es asíncrono: puedes esperar en la web o recibir un email cuando el archivo esté listo.
Cómo usarla
Abre Download Invoices
Desde el hub en `/home/`, entra en la tarjeta Download Invoices (`/invoices/`).
Configura la descarga
Selecciona el portfolio, la fecha de inicio y la fecha de fin del periodo que necesitas.
Inicia el job
Pulsa descargar. CHABI crea un job en segundo plano y muestra el progreso. Cuando termine, podrás descargar el ZIP desde la misma pantalla.
Alternativa por email
Si eliges entrega por email, recibirás un enlace cuando el archivo esté disponible.
Qué obtienes
- ZIP con facturas agrupadas por cuenta
- Consulta de estado del job en tiempo real (polling)
- Jobs programados para facturas en papel (operaciones internas)
Campaign Manager
Sincroniza campañas de cuentas Kraken mediante CSV y consulta campañas existentes.
Campaign Manager vive en `/campaigns/` y agrupa cuatro flujos relacionados. Los slugs de campaña permitidos se configuran en el Django admin; si no hay ninguno, la herramienta muestra un aviso.
Sub-herramientas
- Template — Descarga la plantilla CSV con las columnas correctas para preparar tu archivo.
- Sync CSV files — Sube un CSV, revisa el preview y lanza la sincronización async. Modos: full, add_only y remove_only.
- Quick lookup — Consulta las campañas activas de una cuenta concreta (solo lectura).
- Reverse lookup — Busca cuentas que tengan determinadas campañas (vía Cube.js) y exporta el resultado a CSV.
Modos de sincronización
- full — reemplaza las campañas de las cuentas del CSV
- add_only — añade campañas sin eliminar las existentes
- remove_only — elimina solo las campañas indicadas en el CSV
CUPS Manager
Gestiona solicitudes de cambio de CUPS (código viejo → código nuevo) con validación contra Kraken.
CUPS Manager en `/cups/` permite registrar cambios de suministro eléctrico o de gas. Las solicitudes pasan por estados pending y sent; puedes revisar las tuyas en "Mis CUPS".
Cómo crear una solicitud
Abre CUPS Manager
Desde el hub, entra en la tarjeta CUPS Manager (`/cups/`).
Rellena el formulario
Indica el CUPS antiguo, el CUPS nuevo, el tipo de suministro (electricidad o gas) y los datos requeridos.
Validación automática
CHABI valida el formato del CUPS y consulta Kraken. Se rechazan CUPS que estén ON_SUPPLY.
Consulta tus pendientes
En `/cups/my-cups/` ves tus solicitudes pendientes y puedes editarlas o eliminarlas.
Reglas importantes
- El CUPS nuevo no puede estar ya en suministro (ON_SUPPLY) en Kraken
- Los viernes a las 9:00 se genera un informe CSV de pendientes (operaciones internas)
- Estados: pending (pendiente de envío) y sent (enviada)
KMTs in progress
Registra y consulta cuentas y CUPS en proyectos KMT activos.
KMTs in progress en `/kmts/` permite registrar entradas por categoría de proyecto, consultar un dashboard agrupado y exportar CSV por categoría.
Cómo usarla
Registra una entrada
En el formulario principal indica la categoría KMT, el tipo de suministro, la cuenta y, opcionalmente, el CUPS.
Consulta el dashboard
En `/kmts/dashboard/` ves las entradas agrupadas por categoría con un resumen de cuentas y CUPS registrados.
Exporta CSV
Desde cada categoría puedes descargar un CSV con las entradas (`/kmts/category/<id>/csv/`).
Para qué sirve
- Seguimiento centralizado de cuentas en proyectos KMT
- Categorías configurables desde Django admin
- Exportación CSV para reporting externo
Communications Calendar
Calendario compartido de comunicaciones a clientes: emails, campañas y avisos planificados.
Communications Calendar en `/communications/` muestra un calendario mensual con eventos de comunicación. La ventana visible empieza en enero de 2026 y cubre seis meses móviles.
Roles
- Viewer — ver eventos en el calendario
- Creator — crear nuevos eventos
- Admin — editar y eliminar eventos de cualquier usuario
Campos de un evento
- Nombre de campaña y asunto del email
- Fecha y hora de envío
- Audiencia, tipo (marketing, billing, incident) y estado (sent, draft, scheduled)
- Frecuencia, enlace de preview y notas
Office
Herramientas para la vida de oficina: eventos, reservas, material y peticiones Octo-Love.
Office vive en `/office/` con un sub-hub propio (tema azul "ocean"). Todos los usuarios autenticados pueden acceder; algunas funciones requieren el grupo Office Managers.
Sub-herramientas
Family Dinner
Cenas de equipo: confirma o cancela tu asistencia. Crear eventos requiere Office Managers.
Acceso / Access: Login
Going to the office
Calendario mensual para reservar días en oficina, individualmente o en equipo.
Acceso / Access: Login
Material
Consulta el inventario de material de oficina. Gestionar stock requiere Office Managers.
Acceso / Access: Login / Office Managers
Octo-Love
Solicita peticiones Octo-Love; se crea una nota en Kraken. Marcar como enviado requiere Office Managers.
Acceso / Access: Login / Office Managers
Manage offices
Administra oficinas, capacidad (personas, perros, bebés) y configuración.
Acceso / Access: Office Managers
Timlili
Planificador de equipos — actualmente en desarrollo.
Timlili en `/timlili/` es la próxima herramienta de CHABI para gestionar equipos y planificación. Por ahora muestra un placeholder mientras se desarrolla la funcionalidad completa.
Estado actual
- Visible en el hub para todos los usuarios autenticados
- Modelos Team y TeamMember gestionables desde Django admin
- Interfaz de usuario aún no implementada (placeholder)
- Puede no estar desplegada en todos los entornos
Soporte y FAQ
Respuestas rápidas a las dudas más habituales sobre CHABI.
Preguntas frecuentes
- Me registré pero no puedo iniciar sesión
- Tu cuenta está pendiente de aprobación. Contacta con [email protected] o con un superusuario del equipo.
- No veo una herramienta en el hub
- Necesitas el grupo Django correspondiente. Pide a un superusuario que revise tus roles en Pending Users.
- Campaign Manager muestra un aviso de slugs
- Un administrador debe configurar los slugs de campaña permitidos en Django admin antes de usar la herramienta.
- ¿Puedo acceder desde el móvil?
- Sí, CHABI es una web responsive. Funciona desde el navegador de tu móvil u ordenador.
Contacto
Para soporte técnico: [email protected]
Repositorio
Código fuente y documentación de desarrollo: https://github.com/octopus-energy/chabi