Estrategia Modular Retail
Vista General de la Estrategia
Ecosistema completo para operaciones retail: desde punto de venta hasta la experiencia omnicanal del cliente, potenciado por módulos custom de Grupo Veniu sobre Odoo v19.
Punto de Venta
PdV omnicanal con tienda física, restaurante, e-commerce integrado y self-service kiosks.
Cadena de Suministro
Control end-to-end: compras, inventario multi-almacén, manufactura y calidad.
Finanzas
Contabilidad, facturación electrónica MX, gastos, presupuestos y BI integrado.
Ventas & CRM
Pipeline comercial, cotizaciones, suscripciones y gestión de clientes con IA.
Marketing Omnicanal
Campañas automatizadas por email, SMS, redes sociales y WhatsApp con segmentación IA.
Presencia Digital
Sitio web, tienda online, blog, chat en vivo, eLearning y foro de comunidad.
Recursos Humanos
Gestión completa de talento: reclutamiento, nómina, vacaciones, evaluaciones y flotilla.
Servicios & Productividad
Proyectos, soporte al cliente, aprobaciones, citas y comunicación interna.
Mapa Modular Completo
Desglose de todos los módulos Odoo v19 aplicables a retail, clasificados por área funcional con sus módulos custom de Grupo Veniu correspondientes.
💰 Finanzas
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Contabilidad | Core | Plan contable MX, pólizas automáticas, conciliación bancaria, DIOT | Multi-empresa, multi-moneda, localización MX |
| Facturación | Core | CFDI 4.0, notas de crédito, complemento de pago, addendas | Timbrado PAC integrado, carta porte |
| Gastos | Core | Control de gastos por sucursal, viáticos, caja chica | Aprobaciones por nivel, reportes por centro de costo |
| Hoja de Cálculo BI | Core | Dashboards financieros dinámicos, análisis de rentabilidad por tienda | Pivots, gráficos, KPIs en tiempo real |
| Documentos | Core | DMS para contratos, pólizas, archivos fiscales | Flujos de aprobación, tags automáticos |
| Firma Electrónica | Core | Firma digital de contratos con proveedores y empleados | Validez legal, audit trail |
| GV Finance Dashboard | Custom GV | Dashboard financiero consolidado multi-sucursal con alertas | Widgets custom, thresholds configurables |
🎯 Ventas & CRM
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| CRM | Core | Pipeline de oportunidades B2B/B2C, seguimiento de leads | Etapas configurables, scoring, actividades |
| Ventas | Core | Cotizaciones, órdenes, listas de precios por canal | Multi lista de precios, descuentos por volumen |
| PdV Tiendas | Core | Terminal de venta para sucursales, pagos mixtos, loyalty | Modo offline, multi-sesión, cierre de caja |
| PdV Restaurantes | Core | Gestión de mesas, kitchen display, propinas | Aplica si retail incluye food court o cafetería |
| Suscripciones | Core | Membresías, planes recurrentes, loyalty premium | Facturación recurrente, upselling automático |
| Alquiler | Core | Renta de espacios, equipment, pop-up stores | Calendario, disponibilidad, pricing dinámico |
| GV Lead Scoring IA | Custom GV | Clasificación automática de leads por probabilidad de compra | Integración Claude API, scoring predictivo |
| GV Omnichannel Sales | Custom GV | Unificación de ventas PdV + eCommerce + WhatsApp | Vista 360° del cliente, historial cross-channel |
| Botpress CRM Bridge | Integración | Chatbot → Lead automático en CRM con contexto conversacional | Webhook bidireccional, tags automáticos |
🌐 Sitios Web & Presencia Digital
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Creador de Sitios Web | Core | Landing pages, catálogo digital, páginas de sucursales | Drag & drop, SEO, responsive |
| Comercio Electrónico | Core | Tienda online completa con carrito, checkout, payments | Pasarelas MX (Conekta, Stripe, PayPal), envíos |
| Blog | Core | Content marketing, guías de producto, recetas/tutoriales | SEO automático, categorización |
| Foro | Core | Comunidad de clientes, Q&A de productos, gamificación | Karma system, badges, moderación |
| Chat en Vivo | Core | Atención inmediata en sitio web con routing a agentes | Reglas automáticas, integración con helpdesk |
| eLearning | Core | Capacitación de staff, onboarding de franquicias | Cursos, certificaciones, gamificación |
| GV Portal 360 | Custom GV | Portal unificado del cliente: pedidos, puntos, historial, soporte | Single sign-on, dashboard personalizado |
| GV Chatbot Orchestrator | Custom GV | Hub & Spoke: WhatsApp + Web + Messenger centralizados | Botpress + Claude API + HITL |
📦 Cadena de Suministro
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Inventario | Core | Multi-almacén, rutas de reabastecimiento, trazabilidad por lote/serie | Barcode, multi-ubicación, reglas push/pull |
| Manufactura | Core | Producción propia (marca blanca, empaque, kits) | BoM, órdenes de producción, work centers |
| PLM | Core | Gestión de ciclo de vida de productos, versiones | ECOs, aprobaciones de cambio |
| Compras | Core | RFQs, órdenes de compra, evaluación de proveedores | Acuerdos de compra, dropshipping |
| Mantenimiento | Core | Mantenimiento de equipos de tienda (refrigeradores, PdV, etc.) | Preventivo y correctivo, calendario |
| Calidad | Core | Control de calidad en recepción de mercancía | Puntos de control, alertas, acciones correctivas |
| GV Smart Reorder | Custom GV | Reabastecimiento predictivo basado en ventas históricas + estacionalidad | Claude API para predicción, alertas automáticas |
👥 Recursos Humanos
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Empleados | Core | Directorio, departamentos por sucursal, organigramas | Skills, documentos, contratos |
| Reclutamiento | Core | Pipeline de contratación para alta rotación retail | Publicación en job boards, etapas configurables |
| Vacaciones | Core | Gestión de ausencias, permisos, incapacidades | Políticas por tipo de empleado |
| Evaluaciones | Core | 360°, KPIs por sucursal, métricas de desempeño | Templates, goals, feedback continuo |
| Referencias | Core | Programa de referidos para reclutamiento | Incentivos, tracking, gamificación |
| Flotilla | Core | Vehículos de reparto, rutas de distribución | Costos, mantenimiento, asignación |
📣 Marketing
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Redes Sociales | Core | Publicación programada, monitoreo de interacciones | Facebook, Instagram, Twitter, LinkedIn |
| Marketing por Correo | Core | Newsletters, promos estacionales, welcome series | Templates, A/B testing, métricas |
| Marketing por SMS | Core | Alertas de promo, confirmaciones de pedido, reminders | Segmentación, scheduling |
| Eventos | Core | Lanzamientos de producto, pop-ups, workshops en tienda | Registro, tickets, seguimiento |
| Automatización Mktg | Core | Workflows automáticos: carrito abandonado, recompra, cumpleaños | Triggers por comportamiento, multi-step |
| Encuestas | Core | NPS post-compra, satisfacción de servicio, product research | Templates, scoring, certificaciones |
| GV Segmentos IA | Custom GV | Micro-segmentación con IA: RFM analysis, churn prediction | Claude API + datos transaccionales |
| GV WhatsApp Campaigns | Custom GV | Campañas masivas por WhatsApp con plantillas aprobadas | HSM templates, métricas de delivery/read |
🛎️ Servicios & Productividad
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Proyectos | Core | Gestión de aperturas de tienda, remodelaciones, campañas | Kanban, Gantt, tareas, milestones |
| Registro de Horas | Core | Control de horas por proyecto/sucursal | Timesheet, aprobaciones, reportes |
| Servicio Externo | Core | Instalaciones, entregas especiales, servicio técnico | Asignación, rutas, GPS |
| Soporte al Cliente | Core | Helpdesk para devoluciones, garantías, quejas | SLA, escalamiento, knowledge base |
| Planeación | Core | Scheduling de turnos de tienda, roles por horario | Shift planning, conflictos, publicación |
| Citas | Core | Reserva de servicios: personal shopper, fitting, asesoría | Website booking, confirmaciones automáticas |
| Aprobaciones | Core | Flujos de aprobación: descuentos, devoluciones, gastos | Multi-nivel, delegación, notificaciones |
| Conversaciones | Core | Comunicación interna entre sucursales y HQ | Canales, grupos, integración con Discuss |
| GV Ticket Bot | Custom GV | Creación automática de tickets desde chatbot WhatsApp | Clasificación IA, priorización, routing |
| GV Approval Workflows | Custom GV | Flujos de aprobación avanzados con escalamiento y SLA custom | Reglas dinámicas por monto/tipo/sucursal |
Portales & Interfaces Personalizadas
Estrategia de portales customizados que simplifican la operación tanto para clientes finales como para operadores internos, creando experiencias diferenciadas por rol.
- Dashboard de pedidos en tiempo real con tracking
- Historial de compras con recompra rápida (1-click)
- Puntos de lealtad: saldo, historial, canje online
- Facturas y CFDI descargables
- Devoluciones y garantías self-service
- Wishlist y listas de compras recurrentes
- Chat con bot IA + escalamiento a agente
- Perfil de preferencias y notificaciones
- Vista de órdenes de compra pendientes y confirmadas
- Confirmación de entregas y upload de facturas
- Estado de pagos y antigüedad de saldos
- Catálogo de productos con precios negociados
- RFQ automáticos para reabastecimiento
- Documentos compartidos (contratos, specs)
- Evaluación de desempeño (lead time, calidad)
- Comunicación directa vía portal
- KPIs en tiempo real: ventas, ticket promedio, conversión
- Niveles de inventario con alertas de stock bajo
- Turnos de personal y cobertura del día
- Tickets de soporte de la sucursal
- Aprobaciones pendientes (descuentos, gastos)
- Comparativo vs otras sucursales
- Calendario de eventos y promociones
- Checklist diario de apertura/cierre
- Catálogo interactivo con búsqueda por voz/texto
- Consulta de stock en tiempo real por sucursal
- Creación de pedidos conversacionales
- Tracking de envíos con notificaciones proactivas
- FAQ automático con knowledge base de productos
- Escalamiento a agente humano (HITL)
- Campañas de recompra personalizadas
- Encuestas NPS post-interacción
- Dashboard de ventas online vs offline
- Carritos abandonados con acciones de recuperación
- Gestión de catálogo, categorías y SEO
- Métricas de conversión por fuente de tráfico
- Gestión de promociones y cupones
- Reviews de producto y moderación
- Integración con marketplaces (Amazon, MercadoLibre)
- Control de envíos y logística last-mile
- Vista consolidada de todas sus sucursales
- Pedidos centralizados al corporativo
- Royalties y estados de cuenta
- Compliance: checklists de estándares de marca
- Acceso a materiales de marketing
- Training y certificaciones (eLearning)
- Reportes de desempeño vs benchmark
- Canal de comunicación con HQ
Arquitectura Técnica
Stack tecnológico completo siguiendo la estrategia modular de Grupo Veniu: Modelo → Controlador → Vista → Automatización → Tags → Cron → Reportes.
📐 Estructura de Módulos Custom GV para v19
Siguiendo la estrategia de 6 capas: Modelo → Controlador → Vista → Tags/Contacto → Cron → Reportes
1️⃣ Modelo Funcional (models/)
Define el propósito del módulo. Herencia de modelos base Odoo con campos computed, constraints y métodos de negocio.
-
_inheritpara extensión de modelos existentes - Campos computed con
@api.depends - Constraints con
@api.constrains - Métodos CRUD override con
super()
2️⃣ Controlador (controllers/)
Rutas HTTP para inputs/outputs de la comunicación. Endpoints REST para integraciones con Botpress, WhatsApp, etc.
-
@http.routecon auth='public' o 'user' - JSON responses para APIs externas
- CSRF token management para webhooks
- Rate limiting y validación de payload
3️⃣ Vistas Funcionales (views/)
Interfaces de gestión interna. CRÍTICO v19: usar list en lugar de tree, search estrictos.
-
(NUNCAen v19) -
con notebook/page para organización -
para vistas visuales -
con filter y group_by estrictos
4️⃣ Tags & Contacto Bidireccional
Automatización de tarjetas hacia contactos: tags del contacto como base de lectura para funcionalidades de comunicación con Botpress.
- Tags automáticos en
res.partnerdesde acciones - Lectura bidireccional: vista funcional ↔ contacto
- Botpress lee tags vía API para personalizar flujos
- Server actions para sync de categorías
5️⃣ Crons de Automatización (data/)
Tareas programadas para procesos recurrentes: reabastecimiento, seguimiento, limpieza de datos.
-
ir.croncon intervalos configurables - Métodos
_cron_*en modelos - Logging con
_loggerpara monitoreo - Try/except para resiliencia en ejecución
6️⃣ Reportes Funcionales (reports/)
QWeb reports para PDF, dashboards internos y exports configurables.
- QWeb templates para PDF/HTML
-
ir.actions.reportregistrados - Datos agregados con
read_group - Filtros por fecha, sucursal, categoría
⚠️ Checklist de Compatibilidad Odoo v19
Puntos críticos que deben validarse en CADA módulo custom para evitar errores de instalación.
| Punto de Verificación | Regla v19 | Error Común |
|---|---|---|
| __manifest__.py | Todos los campos obligatorios, 'version' como '19.0.1.0.0', 'license' requerido | Manifest con version incorrecta o sin license |
| __init__.py | Imports correctos de cada carpeta (models, controllers, etc.) | Faltan imports de nuevos archivos |
| Vistas: list vs tree | Usar — está DEPRECADO | Vista con no renderiza |
| Search views | Sintaxis estricta: debe tener name, string y domain | Filtros sin atributos requeridos |
| Security (ir.model.access.csv) | Cada modelo DEBE tener al menos un registro de acceso | Modelo sin ACL → error 403 |
| Line endings | SIEMPRE LF (Unix) — NUNCA CRLF (Windows) | CRLF causa errores de parsing silenciosos |
| Data XML | noupdate="1" correcto, IDs únicos con prefijo de módulo | IDs duplicados o conflicto con noupdate |
| Dependencias | Todas las dependencias declaradas en 'depends' del manifest | Import de modelo no declarado en depends |
Flujos Operativos Clave
Procesos end-to-end que cruzan múltiples módulos, desde la adquisición del cliente hasta el servicio post-venta.
🛍️ Customer Journey Omnicanal
Redes + SEO + WhatsApp
Botpress + Claude
Auto-scoring
PdV / eCommerce / WA
Inventario + Envío
NPS + Soporte
Automatización Mktg
Puntos + Membresía
Programa de referencia
📦 Flujo de Cadena de Suministro
GV Smart Reorder
Compras
GV Approval
QC + Inventario
Multi-almacén
🛎️ Flujo de Soporte al Cliente
WhatsApp / Web / Tel
GV Ticket Bot
Helpdesk + SLA
Agente Asignado
+ NPS automático
💰 Flujo Financiero
PdV / eComm / B2B
Timbrado automático
Complemento de pago
Bancaria automática
GV Finance
Fases de Implementación
Ruta de implementación progresiva optimizada para reducir riesgo y maximizar ROI desde el día 1.
Cimientos Operativos
- Configuración multi-empresa y multi-sucursal en Odoo.sh
- Contabilidad MX: plan contable, CFDI 4.0, complementos de pago
- Inventario: almacenes, ubicaciones, rutas de reabastecimiento
- PdV Tiendas: configuración de sesiones, productos, listas de precios
- Compras: proveedores, acuerdos, flujo RFQ → PO → Recepción
- RRHH base: empleados, departamentos por sucursal
- Seguridad: roles y permisos por sucursal/departamento
- Migración de datos maestros: productos, contactos, inventario inicial
Motor Comercial
- CRM: pipeline B2B y B2C, etapas, scoring básico
- Ventas: cotizaciones, listas de precios por canal, descuentos
- eCommerce: tienda online, checkout, pasarelas MX
- Website: landing pages, blog, catálogo digital
- Portal Cliente: pedidos, facturas, tracking
- Portal Proveedor: órdenes, facturas, pagos
- Helpdesk: tickets de soporte, SLA, knowledge base
- Programa de lealtad y suscripciones
Inteligencia & Automatización
- GV Chatbot Orchestrator: WhatsApp + Web + Messenger
- Botpress flows: catálogo, pedidos, FAQ, soporte
- Claude API: razonamiento avanzado, recomendaciones
- HITL: escalamiento a agente humano con contexto
- GV Lead Scoring IA: clasificación predictiva
- GV Segmentos IA: micro-segmentación RFM
- GV Ticket Bot: triage automático desde WhatsApp
- Marketing automation: carrito abandonado, recompra, cumpleaños
Escala & Optimización
- GV Smart Reorder: predicción de demanda con IA
- GV Finance Dashboard: consolidado multi-sucursal
- Dashboard Gerente: KPIs operativos por sucursal
- Portal Franquiciatario (si aplica): vista corporativa
- eLearning: capacitación de staff y onboarding
- Calidad y Mantenimiento: controles preventivos
- Reportes avanzados: BI, pivots, análisis de rentabilidad
- Optimización de crons, performance tuning, documentación
GVR & ECO — Dimensionamiento del Proyecto
Metodología propietaria de Grupo Veniu para dimensionar complejidad (GVR) y costos operativos (ECO) de cada componente de la implementación retail.
| Componente | GVR (1-10) | Horas Est. | ECO Mensual | Dependencias |
|---|---|---|---|---|
| Contabilidad + CFDI MX | 4.0 | 80-120h | Licencia Odoo + PAC | Localización MX |
| PdV Multi-sucursal | 6.0 | 60-100h | Hardware PdV + Red | Inventario, Contabilidad |
| Inventario Multi-almacén | 6.5 | 80-120h | Barcode scanners | Compras, PdV |
| eCommerce + Website | 7.0 | 100-160h | Hosting + Pasarelas | Inventario, Ventas |
| CRM + Ventas | 5.0 | 60-80h | — | Contactos |
| GV Portal 360 | 7.5 | 120-180h | Odoo.sh compute | Website, CRM, Ventas, Helpdesk |
| GV Chatbot Orchestrator | 9.0 | 160-240h | Botpress Pro + Claude API + WABA | CRM, Inventario, Helpdesk |
| GV Lead Scoring IA | 6.5 | 60-100h | Claude API tokens | CRM |
| GV Segmentos IA | 7.0 | 80-120h | Claude API tokens | Marketing, CRM, Ventas |
| GV Smart Reorder | 8.0 | 120-160h | Claude API tokens | Inventario, Compras, Ventas |
| GV Finance Dashboard | 6.0 | 60-100h | — | Contabilidad, PdV, Ventas |
| Marketing Automation Completo | 6.0 | 80-120h | Email + SMS providers | CRM, Contactos |
| RRHH Completo | 5.0 | 60-100h | — | Empleados base |
| Portal Franquiciatario | 9.5 | 200-280h | Multi-company Odoo.sh | Todos los módulos previos |
| 📊 TOTAL ESTIMADO | GVR 7.2 promedio | 1,160 - 1,780h | Variable por componente | — |
📊 Distribución ECO por Categoría
💻 Infraestructura
- Odoo.sh (producción + staging)
- Dominio + SSL + CDN
- Hardware PdV por sucursal
- Barcode scanners
🤖 Servicios IA
- Botpress Pro (por bot)
- Claude API tokens (por uso)
- WhatsApp Business API (WABA)
- PAC para timbrado CFDI
👥 Soporte Continuo
- Soporte técnico GV (bolsa de horas)
- Actualizaciones de módulos custom
- Monitoreo de integraciones
- Capacitación continua
Automatizaciones & Crons
Todas las tareas programadas y acciones automáticas que mantienen el ecosistema retail funcionando 24/7 sin intervención manual.
| Cron / Automatización | Módulo | Frecuencia | Acción |
|---|---|---|---|
| Sync de Stock PdV ↔ eCommerce | Inventario + eComm | Cada 15 min | Actualiza stock disponible en tienda online desde cada sucursal |
| Smart Reorder Check | GV Smart Reorder | Diario 6:00 AM | Analiza stock vs forecast, genera RFQ automáticos si bajo mínimo |
| Lead Scoring Batch | GV Lead Scoring IA | Cada 4 horas | Recalcula score de leads nuevos/actualizados con Claude API |
| Segmentación RFM | GV Segmentos IA | Semanal (Lunes) | Recalcula segmentos de clientes por Recencia-Frecuencia-Monto |
| Carrito Abandonado | Marketing Auto | Cada 2 horas | Envía email/WhatsApp a carritos >1h sin completar |
| NPS Post-Compra | Encuestas + GV | Diario 10:00 AM | Envía encuesta NPS a compras de hace 48h |
| Tag Sync Contactos ↔ Botpress | GV Chatbot | Cada 30 min | Sincroniza tags de contacto para personalización de flujos |
| Cierre de Caja Automático | PdV | Diario 23:00 | Fuerza cierre de sesiones PdV abiertas, genera reporte |
| Conciliación Bancaria | Contabilidad | Diario 7:00 AM | Importa movimientos bancarios, sugiere conciliaciones |
| Alertas de Inventario | Inventario + GV | Cada 2 horas | Notifica a gerentes cuando stock < punto de reorden |
| SLA Monitor Tickets | Helpdesk + GV | Cada 30 min | Escala tickets que están por vencer SLA |
| Reporte Diario Gerente | GV Finance Dashboard | Diario 8:00 AM | Email con KPIs del día anterior por sucursal |
| Limpieza de Leads Fríos | CRM | Mensual | Archiva leads sin actividad >90 días, notifica responsable |
| Campaña de Recompra | Marketing + GV Segmentos | Semanal (Miércoles) | Envía promociones personalizadas a segmento "en riesgo" |
| Backup & Health Check | Sistema | Diario 2:00 AM | Verifica integraciones activas, reporta errores |
🔗 Mapa de Webhooks & APIs
📥 Webhooks Entrantes (Odoo recibe)
-
/gv/webhook/botpress— Eventos de conversación -
/gv/webhook/whatsapp— Mensajes entrantes WABA -
/gv/webhook/payment— Confirmaciones de pago -
/gv/webhook/shipping— Updates de envío -
/gv/webhook/marketplace— Órdenes externas
📤 APIs Salientes (Odoo envía)
- Botpress API — Trigger de flujos, variables de usuario
- Claude API — Requests de razonamiento/scoring
- WABA — Envío de HSM templates
- PAC — Timbrado CFDI
- Pasarelas de pago — Cargo/verificación
Estrategia Modular Retail
Vista General de la Estrategia
Ecosistema completo para operaciones retail: desde punto de venta hasta la experiencia omnicanal del cliente, potenciado por módulos custom de Grupo Veniu sobre Odoo v19.
Punto de Venta
PdV omnicanal con tienda física, restaurante, e-commerce integrado y self-service kiosks.
Cadena de Suministro
Control end-to-end: compras, inventario multi-almacén, manufactura y calidad.
Finanzas
Contabilidad, facturación electrónica MX, gastos, presupuestos y BI integrado.
Ventas & CRM
Pipeline comercial, cotizaciones, suscripciones y gestión de clientes con IA.
Marketing Omnicanal
Campañas automatizadas por email, SMS, redes sociales y WhatsApp con segmentación IA.
Presencia Digital
Sitio web, tienda online, blog, chat en vivo, eLearning y foro de comunidad.
Recursos Humanos
Gestión completa de talento: reclutamiento, nómina, vacaciones, evaluaciones y flotilla.
Servicios & Productividad
Proyectos, soporte al cliente, aprobaciones, citas y comunicación interna.
Mapa Modular Completo
Desglose de todos los módulos Odoo v19 aplicables a retail, clasificados por área funcional con sus módulos custom de Grupo Veniu correspondientes.
💰 Finanzas
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Contabilidad | Core | Plan contable MX, pólizas automáticas, conciliación bancaria, DIOT | Multi-empresa, multi-moneda, localización MX |
| Facturación | Core | CFDI 4.0, notas de crédito, complemento de pago, addendas | Timbrado PAC integrado, carta porte |
| Gastos | Core | Control de gastos por sucursal, viáticos, caja chica | Aprobaciones por nivel, reportes por centro de costo |
| Hoja de Cálculo BI | Core | Dashboards financieros dinámicos, análisis de rentabilidad por tienda | Pivots, gráficos, KPIs en tiempo real |
| Documentos | Core | DMS para contratos, pólizas, archivos fiscales | Flujos de aprobación, tags automáticos |
| Firma Electrónica | Core | Firma digital de contratos con proveedores y empleados | Validez legal, audit trail |
| GV Finance Dashboard | Custom GV | Dashboard financiero consolidado multi-sucursal con alertas | Widgets custom, thresholds configurables |
🎯 Ventas & CRM
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| CRM | Core | Pipeline de oportunidades B2B/B2C, seguimiento de leads | Etapas configurables, scoring, actividades |
| Ventas | Core | Cotizaciones, órdenes, listas de precios por canal | Multi lista de precios, descuentos por volumen |
| PdV Tiendas | Core | Terminal de venta para sucursales, pagos mixtos, loyalty | Modo offline, multi-sesión, cierre de caja |
| PdV Restaurantes | Core | Gestión de mesas, kitchen display, propinas | Aplica si retail incluye food court o cafetería |
| Suscripciones | Core | Membresías, planes recurrentes, loyalty premium | Facturación recurrente, upselling automático |
| Alquiler | Core | Renta de espacios, equipment, pop-up stores | Calendario, disponibilidad, pricing dinámico |
| GV Lead Scoring IA | Custom GV | Clasificación automática de leads por probabilidad de compra | Integración Claude API, scoring predictivo |
| GV Omnichannel Sales | Custom GV | Unificación de ventas PdV + eCommerce + WhatsApp | Vista 360° del cliente, historial cross-channel |
| Botpress CRM Bridge | Integración | Chatbot → Lead automático en CRM con contexto conversacional | Webhook bidireccional, tags automáticos |
🌐 Sitios Web & Presencia Digital
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Creador de Sitios Web | Core | Landing pages, catálogo digital, páginas de sucursales | Drag & drop, SEO, responsive |
| Comercio Electrónico | Core | Tienda online completa con carrito, checkout, payments | Pasarelas MX (Conekta, Stripe, PayPal), envíos |
| Blog | Core | Content marketing, guías de producto, recetas/tutoriales | SEO automático, categorización |
| Foro | Core | Comunidad de clientes, Q&A de productos, gamificación | Karma system, badges, moderación |
| Chat en Vivo | Core | Atención inmediata en sitio web con routing a agentes | Reglas automáticas, integración con helpdesk |
| eLearning | Core | Capacitación de staff, onboarding de franquicias | Cursos, certificaciones, gamificación |
| GV Portal 360 | Custom GV | Portal unificado del cliente: pedidos, puntos, historial, soporte | Single sign-on, dashboard personalizado |
| GV Chatbot Orchestrator | Custom GV | Hub & Spoke: WhatsApp + Web + Messenger centralizados | Botpress + Claude API + HITL |
📦 Cadena de Suministro
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Inventario | Core | Multi-almacén, rutas de reabastecimiento, trazabilidad por lote/serie | Barcode, multi-ubicación, reglas push/pull |
| Manufactura | Core | Producción propia (marca blanca, empaque, kits) | BoM, órdenes de producción, work centers |
| PLM | Core | Gestión de ciclo de vida de productos, versiones | ECOs, aprobaciones de cambio |
| Compras | Core | RFQs, órdenes de compra, evaluación de proveedores | Acuerdos de compra, dropshipping |
| Mantenimiento | Core | Mantenimiento de equipos de tienda (refrigeradores, PdV, etc.) | Preventivo y correctivo, calendario |
| Calidad | Core | Control de calidad en recepción de mercancía | Puntos de control, alertas, acciones correctivas |
| GV Smart Reorder | Custom GV | Reabastecimiento predictivo basado en ventas históricas + estacionalidad | Claude API para predicción, alertas automáticas |
👥 Recursos Humanos
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Empleados | Core | Directorio, departamentos por sucursal, organigramas | Skills, documentos, contratos |
| Reclutamiento | Core | Pipeline de contratación para alta rotación retail | Publicación en job boards, etapas configurables |
| Vacaciones | Core | Gestión de ausencias, permisos, incapacidades | Políticas por tipo de empleado |
| Evaluaciones | Core | 360°, KPIs por sucursal, métricas de desempeño | Templates, goals, feedback continuo |
| Referencias | Core | Programa de referidos para reclutamiento | Incentivos, tracking, gamificación |
| Flotilla | Core | Vehículos de reparto, rutas de distribución | Costos, mantenimiento, asignación |
📣 Marketing
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Redes Sociales | Core | Publicación programada, monitoreo de interacciones | Facebook, Instagram, Twitter, LinkedIn |
| Marketing por Correo | Core | Newsletters, promos estacionales, welcome series | Templates, A/B testing, métricas |
| Marketing por SMS | Core | Alertas de promo, confirmaciones de pedido, reminders | Segmentación, scheduling |
| Eventos | Core | Lanzamientos de producto, pop-ups, workshops en tienda | Registro, tickets, seguimiento |
| Automatización Mktg | Core | Workflows automáticos: carrito abandonado, recompra, cumpleaños | Triggers por comportamiento, multi-step |
| Encuestas | Core | NPS post-compra, satisfacción de servicio, product research | Templates, scoring, certificaciones |
| GV Segmentos IA | Custom GV | Micro-segmentación con IA: RFM analysis, churn prediction | Claude API + datos transaccionales |
| GV WhatsApp Campaigns | Custom GV | Campañas masivas por WhatsApp con plantillas aprobadas | HSM templates, métricas de delivery/read |
🛎️ Servicios & Productividad
| Módulo | Tipo | Función en Retail | Alcance |
|---|---|---|---|
| Proyectos | Core | Gestión de aperturas de tienda, remodelaciones, campañas | Kanban, Gantt, tareas, milestones |
| Registro de Horas | Core | Control de horas por proyecto/sucursal | Timesheet, aprobaciones, reportes |
| Servicio Externo | Core | Instalaciones, entregas especiales, servicio técnico | Asignación, rutas, GPS |
| Soporte al Cliente | Core | Helpdesk para devoluciones, garantías, quejas | SLA, escalamiento, knowledge base |
| Planeación | Core | Scheduling de turnos de tienda, roles por horario | Shift planning, conflictos, publicación |
| Citas | Core | Reserva de servicios: personal shopper, fitting, asesoría | Website booking, confirmaciones automáticas |
| Aprobaciones | Core | Flujos de aprobación: descuentos, devoluciones, gastos | Multi-nivel, delegación, notificaciones |
| Conversaciones | Core | Comunicación interna entre sucursales y HQ | Canales, grupos, integración con Discuss |
| GV Ticket Bot | Custom GV | Creación automática de tickets desde chatbot WhatsApp | Clasificación IA, priorización, routing |
| GV Approval Workflows | Custom GV | Flujos de aprobación avanzados con escalamiento y SLA custom | Reglas dinámicas por monto/tipo/sucursal |
Portales & Interfaces Personalizadas
Estrategia de portales customizados que simplifican la operación tanto para clientes finales como para operadores internos, creando experiencias diferenciadas por rol.
- Dashboard de pedidos en tiempo real con tracking
- Historial de compras con recompra rápida (1-click)
- Puntos de lealtad: saldo, historial, canje online
- Facturas y CFDI descargables
- Devoluciones y garantías self-service
- Wishlist y listas de compras recurrentes
- Chat con bot IA + escalamiento a agente
- Perfil de preferencias y notificaciones
- Vista de órdenes de compra pendientes y confirmadas
- Confirmación de entregas y upload de facturas
- Estado de pagos y antigüedad de saldos
- Catálogo de productos con precios negociados
- RFQ automáticos para reabastecimiento
- Documentos compartidos (contratos, specs)
- Evaluación de desempeño (lead time, calidad)
- Comunicación directa vía portal
- KPIs en tiempo real: ventas, ticket promedio, conversión
- Niveles de inventario con alertas de stock bajo
- Turnos de personal y cobertura del día
- Tickets de soporte de la sucursal
- Aprobaciones pendientes (descuentos, gastos)
- Comparativo vs otras sucursales
- Calendario de eventos y promociones
- Checklist diario de apertura/cierre
- Catálogo interactivo con búsqueda por voz/texto
- Consulta de stock en tiempo real por sucursal
- Creación de pedidos conversacionales
- Tracking de envíos con notificaciones proactivas
- FAQ automático con knowledge base de productos
- Escalamiento a agente humano (HITL)
- Campañas de recompra personalizadas
- Encuestas NPS post-interacción
- Dashboard de ventas online vs offline
- Carritos abandonados con acciones de recuperación
- Gestión de catálogo, categorías y SEO
- Métricas de conversión por fuente de tráfico
- Gestión de promociones y cupones
- Reviews de producto y moderación
- Integración con marketplaces (Amazon, MercadoLibre)
- Control de envíos y logística last-mile
- Vista consolidada de todas sus sucursales
- Pedidos centralizados al corporativo
- Royalties y estados de cuenta
- Compliance: checklists de estándares de marca
- Acceso a materiales de marketing
- Training y certificaciones (eLearning)
- Reportes de desempeño vs benchmark
- Canal de comunicación con HQ
Arquitectura Técnica
Stack tecnológico completo siguiendo la estrategia modular de Grupo Veniu: Modelo → Controlador → Vista → Automatización → Tags → Cron → Reportes.
📐 Estructura de Módulos Custom GV para v19
Siguiendo la estrategia de 6 capas: Modelo → Controlador → Vista → Tags/Contacto → Cron → Reportes
1️⃣ Modelo Funcional (models/)
Define el propósito del módulo. Herencia de modelos base Odoo con campos computed, constraints y métodos de negocio.
-
_inheritpara extensión de modelos existentes - Campos computed con
@api.depends - Constraints con
@api.constrains - Métodos CRUD override con
super()
2️⃣ Controlador (controllers/)
Rutas HTTP para inputs/outputs de la comunicación. Endpoints REST para integraciones con Botpress, WhatsApp, etc.
-
@http.routecon auth='public' o 'user' - JSON responses para APIs externas
- CSRF token management para webhooks
- Rate limiting y validación de payload
3️⃣ Vistas Funcionales (views/)
Interfaces de gestión interna. CRÍTICO v19: usar list en lugar de tree, search estrictos.
-
<list>(NUNCA<tree>en v19) -
<form>con notebook/page para organización -
<kanban>para vistas visuales -
<search>con filter y group_by estrictos
4️⃣ Tags & Contacto Bidireccional
Automatización de tarjetas hacia contactos: tags del contacto como base de lectura para funcionalidades de comunicación con Botpress.
- Tags automáticos en
res.partnerdesde acciones - Lectura bidireccional: vista funcional ↔ contacto
- Botpress lee tags vía API para personalizar flujos
- Server actions para sync de categorías
5️⃣ Crons de Automatización (data/)
Tareas programadas para procesos recurrentes: reabastecimiento, seguimiento, limpieza de datos.
-
ir.croncon intervalos configurables - Métodos
_cron_*en modelos - Logging con
_loggerpara monitoreo - Try/except para resiliencia en ejecución
6️⃣ Reportes Funcionales (reports/)
QWeb reports para PDF, dashboards internos y exports configurables.
- QWeb templates para PDF/HTML
-
ir.actions.reportregistrados - Datos agregados con
read_group - Filtros por fecha, sucursal, categoría
⚠️ Checklist de Compatibilidad Odoo v19
Puntos críticos que deben validarse en CADA módulo custom para evitar errores de instalación.
| Punto de Verificación | Regla v19 | Error Común |
|---|---|---|
| __manifest__.py | Todos los campos obligatorios, 'version' como '19.0.1.0.0', 'license' requerido | Manifest con version incorrecta o sin license |
| __init__.py | Imports correctos de cada carpeta (models, controllers, etc.) | Faltan imports de nuevos archivos |
| Vistas: list vs tree | Usar <list> — <tree> está DEPRECADO | Vista con <tree> no renderiza |
| Search views | Sintaxis estricta: <filter> debe tener name, string y domain | Filtros sin atributos requeridos |
| Security (ir.model.access.csv) | Cada modelo DEBE tener al menos un registro de acceso | Modelo sin ACL → error 403 |
| Line endings | SIEMPRE LF (Unix) — NUNCA CRLF (Windows) | CRLF causa errores de parsing silenciosos |
| Data XML | noupdate="1" correcto, IDs únicos con prefijo de módulo | IDs duplicados o conflicto con noupdate |
| Dependencias | Todas las dependencias declaradas en 'depends' del manifest | Import de modelo no declarado en depends |
Flujos Operativos Clave
Procesos end-to-end que cruzan múltiples módulos, desde la adquisición del cliente hasta el servicio post-venta.
🛍️ Customer Journey Omnicanal
Redes + SEO + WhatsApp
Botpress + Claude
Auto-scoring
PdV / eCommerce / WA
Inventario + Envío
NPS + Soporte
Automatización Mktg
Puntos + Membresía
Programa de referencia
📦 Flujo de Cadena de Suministro
GV Smart Reorder
Compras
GV Approval
QC + Inventario
Multi-almacén
🛎️ Flujo de Soporte al Cliente
WhatsApp / Web / Tel
GV Ticket Bot
Helpdesk + SLA
Agente Asignado
+ NPS automático
💰 Flujo Financiero
PdV / eComm / B2B
Timbrado automático
Complemento de pago
Bancaria automática
GV Finance
Fases de Implementación
Ruta de implementación progresiva optimizada para reducir riesgo y maximizar ROI desde el día 1.
Cimientos Operativos
- Configuración multi-empresa y multi-sucursal en Odoo.sh
- Contabilidad MX: plan contable, CFDI 4.0, complementos de pago
- Inventario: almacenes, ubicaciones, rutas de reabastecimiento
- PdV Tiendas: configuración de sesiones, productos, listas de precios
- Compras: proveedores, acuerdos, flujo RFQ → PO → Recepción
- RRHH base: empleados, departamentos por sucursal
- Seguridad: roles y permisos por sucursal/departamento
- Migración de datos maestros: productos, contactos, inventario inicial
Motor Comercial
- CRM: pipeline B2B y B2C, etapas, scoring básico
- Ventas: cotizaciones, listas de precios por canal, descuentos
- eCommerce: tienda online, checkout, pasarelas MX
- Website: landing pages, blog, catálogo digital
- Portal Cliente: pedidos, facturas, tracking
- Portal Proveedor: órdenes, facturas, pagos
- Helpdesk: tickets de soporte, SLA, knowledge base
- Programa de lealtad y suscripciones
Inteligencia & Automatización
- GV Chatbot Orchestrator: WhatsApp + Web + Messenger
- Botpress flows: catálogo, pedidos, FAQ, soporte
- Claude API: razonamiento avanzado, recomendaciones
- HITL: escalamiento a agente humano con contexto
- GV Lead Scoring IA: clasificación predictiva
- GV Segmentos IA: micro-segmentación RFM
- GV Ticket Bot: triage automático desde WhatsApp
- Marketing automation: carrito abandonado, recompra, cumpleaños
Escala & Optimización
- GV Smart Reorder: predicción de demanda con IA
- GV Finance Dashboard: consolidado multi-sucursal
- Dashboard Gerente: KPIs operativos por sucursal
- Portal Franquiciatario (si aplica): vista corporativa
- eLearning: capacitación de staff y onboarding
- Calidad y Mantenimiento: controles preventivos
- Reportes avanzados: BI, pivots, análisis de rentabilidad
- Optimización de crons, performance tuning, documentación
GVR & ECO — Dimensionamiento del Proyecto
Metodología propietaria de Grupo Veniu para dimensionar complejidad (GVR) y costos operativos (ECO) de cada componente de la implementación retail.
| Componente | GVR (1-10) | Horas Est. | ECO Mensual | Dependencias |
|---|---|---|---|---|
| Contabilidad + CFDI MX | 4.0 | 80-120h | Licencia Odoo + PAC | Localización MX |
| PdV Multi-sucursal | 6.0 | 60-100h | Hardware PdV + Red | Inventario, Contabilidad |
| Inventario Multi-almacén | 6.5 | 80-120h | Barcode scanners | Compras, PdV |
| eCommerce + Website | 7.0 | 100-160h | Hosting + Pasarelas | Inventario, Ventas |
| CRM + Ventas | 5.0 | 60-80h | — | Contactos |
| GV Portal 360 | 7.5 | 120-180h | Odoo.sh compute | Website, CRM, Ventas, Helpdesk |
| GV Chatbot Orchestrator | 9.0 | 160-240h | Botpress Pro + Claude API + WABA | CRM, Inventario, Helpdesk |
| GV Lead Scoring IA | 6.5 | 60-100h | Claude API tokens | CRM |
| GV Segmentos IA | 7.0 | 80-120h | Claude API tokens | Marketing, CRM, Ventas |
| GV Smart Reorder | 8.0 | 120-160h | Claude API tokens | Inventario, Compras, Ventas |
| GV Finance Dashboard | 6.0 | 60-100h | — | Contabilidad, PdV, Ventas |
| Marketing Automation Completo | 6.0 | 80-120h | Email + SMS providers | CRM, Contactos |
| RRHH Completo | 5.0 | 60-100h | — | Empleados base |
| Portal Franquiciatario | 9.5 | 200-280h | Multi-company Odoo.sh | Todos los módulos previos |
| 📊 TOTAL ESTIMADO | GVR 7.2 promedio | 1,160 - 1,780h | Variable por componente | — |
📊 Distribución ECO por Categoría
💻 Infraestructura
- Odoo.sh (producción + staging)
- Dominio + SSL + CDN
- Hardware PdV por sucursal
- Barcode scanners
🤖 Servicios IA
- Botpress Pro (por bot)
- Claude API tokens (por uso)
- WhatsApp Business API (WABA)
- PAC para timbrado CFDI
👥 Soporte Continuo
- Soporte técnico GV (bolsa de horas)
- Actualizaciones de módulos custom
- Monitoreo de integraciones
- Capacitación continua
Automatizaciones & Crons
Todas las tareas programadas y acciones automáticas que mantienen el ecosistema retail funcionando 24/7 sin intervención manual.
| Cron / Automatización | Módulo | Frecuencia | Acción |
|---|---|---|---|
| Sync de Stock PdV ↔ eCommerce | Inventario + eComm | Cada 15 min | Actualiza stock disponible en tienda online desde cada sucursal |
| Smart Reorder Check | GV Smart Reorder | Diario 6:00 AM | Analiza stock vs forecast, genera RFQ automáticos si bajo mínimo |
| Lead Scoring Batch | GV Lead Scoring IA | Cada 4 horas | Recalcula score de leads nuevos/actualizados con Claude API |
| Segmentación RFM | GV Segmentos IA | Semanal (Lunes) | Recalcula segmentos de clientes por Recencia-Frecuencia-Monto |
| Carrito Abandonado | Marketing Auto | Cada 2 horas | Envía email/WhatsApp a carritos >1h sin completar |
| NPS Post-Compra | Encuestas + GV | Diario 10:00 AM | Envía encuesta NPS a compras de hace 48h |
| Tag Sync Contactos ↔ Botpress | GV Chatbot | Cada 30 min | Sincroniza tags de contacto para personalización de flujos |
| Cierre de Caja Automático | PdV | Diario 23:00 | Fuerza cierre de sesiones PdV abiertas, genera reporte |
| Conciliación Bancaria | Contabilidad | Diario 7:00 AM | Importa movimientos bancarios, sugiere conciliaciones |
| Alertas de Inventario | Inventario + GV | Cada 2 horas | Notifica a gerentes cuando stock < punto de reorden |
| SLA Monitor Tickets | Helpdesk + GV | Cada 30 min | Escala tickets que están por vencer SLA |
| Reporte Diario Gerente | GV Finance Dashboard | Diario 8:00 AM | Email con KPIs del día anterior por sucursal |
| Limpieza de Leads Fríos | CRM | Mensual | Archiva leads sin actividad >90 días, notifica responsable |
| Campaña de Recompra | Marketing + GV Segmentos | Semanal (Miércoles) | Envía promociones personalizadas a segmento "en riesgo" |
| Backup & Health Check | Sistema | Diario 2:00 AM | Verifica integraciones activas, reporta errores |
🔗 Mapa de Webhooks & APIs
📥 Webhooks Entrantes (Odoo recibe)
-
/gv/webhook/botpress— Eventos de conversación -
/gv/webhook/whatsapp— Mensajes entrantes WABA -
/gv/webhook/payment— Confirmaciones de pago -
/gv/webhook/shipping— Updates de envío -
/gv/webhook/marketplace— Órdenes externas
📤 APIs Salientes (Odoo envía)
- Botpress API — Trigger de flujos, variables de usuario
- Claude API — Requests de razonamiento/scoring
- WABA — Envío de HSM templates
- PAC — Timbrado CFDI
- Pasarelas de pago — Cargo/verificación