INICIANDO NEXUS...
VENIU NEXUS
Sistema de Comisiones sobre Facturas Pagadas
⚡ Odoo v19
◈ Versión 2.0.0
0
Partners
4
Tiers
15%
Max Rate
🎯 Visión General
NEXUS Partners permite a distribuidores externos comercializar productos Veniu, ganando comisiones automáticas sobre facturas pagadas de sus clientes asignados.
💰 FLUJO DE NEGOCIO
1
Partner refiere cliente
→
2
Cliente contrata
→
3
Cliente paga factura
→
4
Comisión automática
→
5
Pago mensual
🏢 Para Grupo Veniu
- Expansión de mercado sin inversión directa
- Fuerza de ventas externa escalable
- Control centralizado de operaciones
- Pagos automatizados vía OC
🤝 Para Partners
- Ingresos recurrentes garantizados
- Comisiones automáticas por factura
- Portal en tiempo real 24/7
- Sistema de niveles con beneficios
👥 Para Clientes
- Atención personalizada local
- Consultoría especializada
- Soporte cercano y ágil
- Implementación rápida
💰 Flujo Principal de Comisiones
flowchart TD
subgraph SETUP["1️⃣ SETUP INICIAL"]
A1["Crear Partner NEXUS"] --> A2["Asignar Tier"]
A2 --> A3["Aprobar Partner"]
A3 --> A4["Partner Activo ✅"]
end
subgraph ASIGNACION["2️⃣ ASIGNACIÓN DE CLIENTES"]
B1["Cliente nuevo"] --> B2{"¿Tiene upline?"}
B2 -->|No| B3["Asignar Partner"]
B2 -->|Sí| B4["Ya asignado"]
B3 --> B5["Cliente vinculado ✅"]
end
subgraph COMISION["3️⃣ COMISIONES AUTOMÁTICAS"]
C1["Crear Factura"] --> C2["Confirmar"]
C2 --> C3["Registrar Pago"]
C3 --> C4{"¿Cliente tiene Partner?"}
C4 -->|Sí| C5["🔄 AUTO: Generar Comisión"]
C4 -->|No| C6["Sin comisión"]
C5 --> C7["Comisión Pendiente ✅"]
end
subgraph CORTE["4️⃣ CORTE MENSUAL"]
D1["⏰ Día 1 del mes"] --> D2["CRON automático"]
D2 --> D3["Agrupar comisiones"]
D3 --> D4["Crear Payout"]
end
subgraph PAGO["5️⃣ PAGO AL PARTNER"]
E1["Confirmar Payout"] --> E2["Generar OC"]
E2 --> E3["Procesar Pago"]
E3 --> E4["Partner Pagado ✅"]
end
A4 --> B1
B5 --> C1
C7 --> D1
D4 --> E1
🏗️ Arquitectura del Sistema
flowchart TB
subgraph FRONTEND["🖥️ INTERFACES"]
Portal["🌐 Portal Web
/my/nexus"] Backend["⚙️ Backend Odoo
NEXUS Partners"] end subgraph CORE["📦 CORE MODELS"] NP["nexus.partner
Partners"] NC["nexus.commission
Comisiones"] NPY["nexus.payout
Pagos"] NT["nexus.tier
Niveles"] end subgraph ODOO["🏢 ODOO STANDARD"] RP["res.partner
Contactos"] AM["account.move
Facturas"] PO["purchase.order
Compras"] end Portal --> NP Backend --> NP NP --> NC NC --> NPY NPY --> PO NP --> NT RP --> NP AM --> NC
/my/nexus"] Backend["⚙️ Backend Odoo
NEXUS Partners"] end subgraph CORE["📦 CORE MODELS"] NP["nexus.partner
Partners"] NC["nexus.commission
Comisiones"] NPY["nexus.payout
Pagos"] NT["nexus.tier
Niveles"] end subgraph ODOO["🏢 ODOO STANDARD"] RP["res.partner
Contactos"] AM["account.move
Facturas"] PO["purchase.order
Compras"] end Portal --> NP Backend --> NP NP --> NC NC --> NPY NPY --> PO NP --> NT RP --> NP AM --> NC
📊 Diagrama E-R
erDiagram
NEXUS_PARTNER ||--o{ NEXUS_COMMISSION : genera
NEXUS_PARTNER ||--o{ RES_PARTNER : tiene_clientes
NEXUS_PARTNER }o--|| NEXUS_TIER : tiene_nivel
NEXUS_PARTNER }o--|| RES_PARTNER : es_contacto
NEXUS_COMMISSION }o--|| NEXUS_PAYOUT : incluida_en
NEXUS_COMMISSION }o--o| ACCOUNT_MOVE : origen
NEXUS_PAYOUT }o--o| PURCHASE_ORDER : genera
RES_PARTNER }o--o| NEXUS_PARTNER : upline
🏆 Sistema de Tiers
flowchart LR
E["🥉 Explorer
8%"] --> B["🥈 Builder
10%"] B --> A["🥇 Accelerator
12%"] A --> EL["🏆 Elite
15%"]
8%"] --> B["🥈 Builder
10%"] B --> A["🥇 Accelerator
12%"] A --> EL["🏆 Elite
15%"]
🥉
Explorer
8%
$0+ facturación
🥈
Builder
10%
$10,000+ facturación
🥇
Accelerator
12%
$50,000+ facturación
🏆
Elite
15%
$100,000+ facturación
💵 Cálculo de Comisión
┌─────────────────────────────────────────────────────┐
│ EJEMPLO DE CÁLCULO │
├─────────────────────────────────────────────────────┤
│ │
│ Factura del Cliente: $10,000.00 (sin IVA) │
│ Tier del Partner: Builder │
│ Tasa de Comisión: 10% │
│ │
│ ───────────────────────────────────────────────── │
│ │
│ COMISIÓN = Base × Tasa │
│ COMISIÓN = $10,000.00 × 0.10 │
│ COMISIÓN = $1,000.00 │
│ │
└─────────────────────────────────────────────────────┘
🔄 Estados y Transiciones
Estados de Comisión
stateDiagram-v2
[*] --> Pendiente: Factura pagada
Pendiente --> Aprobada: Manager aprueba
Aprobada --> Pagada: Incluida en Payout
Pendiente --> Cancelada: Cancelar
Aprobada --> Cancelada: Cancelar
Estados de Payout
stateDiagram-v2
[*] --> Borrador: CRON día 1
Borrador --> Confirmado: Confirmar
Confirmado --> OC_Generada: Generar OC
OC_Generada --> Pagado: Marcar Pagado
Borrador --> Cancelado: Cancelar
Estados de Partner
stateDiagram-v2
[*] --> Borrador: Crear
Borrador --> Pendiente: Enviar
Pendiente --> Aprobado: Aprobar
Aprobado --> Suspendido: Suspender
Suspendido --> Aprobado: Reactivar
🌐 Portal del Partner
flowchart TB
subgraph PORTAL["Portal NEXUS"]
HOME["📊 Dashboard
/my/nexus"] COMM["💰 Comisiones
/my/nexus/commissions"] CLI["👥 Clientes
/my/nexus/clients"] PAY["💳 Pagos
/my/nexus/payouts"] end HOME --> COMM HOME --> CLI HOME --> PAY
/my/nexus"] COMM["💰 Comisiones
/my/nexus/commissions"] CLI["👥 Clientes
/my/nexus/clients"] PAY["💳 Pagos
/my/nexus/payouts"] end HOME --> COMM HOME --> CLI HOME --> PAY
| Sección | URL | Funcionalidad |
|---|---|---|
| 📊 Dashboard | /my/nexus |
Métricas en tiempo real, comisiones recientes, clientes activos |
| 💰 Comisiones | /my/nexus/commissions |
Lista completa con filtros avanzados y paginación |
| 👥 Clientes | /my/nexus/clients |
Clientes asignados con métricas de facturación |
| 💳 Pagos | /my/nexus/payouts |
Historial de pagos con detalle de OC |
📦 Modelos de Datos
nexus.partner
| Campo | Tipo | Descripción |
|---|---|---|
| reference | Char | Código único (NXP-XXXX) |
| partner_id | Many2one | Contacto asociado (res.partner) |
| tier_id | Many2one | Nivel actual del partner |
| state | Selection | Estado del partner (draft/pending/approved/suspended) |
| client_ids | One2many | Clientes asignados al partner |
| total_revenue | Float | Facturación acumulada de clientes |
nexus.commission
| Campo | Tipo | Descripción |
|---|---|---|
| reference | Char | Código único (NXC-XXXX) |
| nexus_partner_id | Many2one | Partner que recibe la comisión |
| source_invoice_id | Many2one | Factura origen (account.move) |
| base_amount | Float | Monto de la factura (sin IVA) |
| commission_rate | Float | Tasa aplicada (%) |
| total_amount | Float | Monto de comisión calculado |
nexus.payout
| Campo | Tipo | Descripción |
|---|---|---|
| reference | Char | Código único (NXY-XXXX) |
| nexus_partner_id | Many2one | Partner a pagar |
| period_start/end | Date | Período del corte mensual |
| commission_ids | One2many | Comisiones incluidas en el payout |
| purchase_order_id | Many2one | OC generada para el pago |
| total_amount | Float | Total a pagar al partner |
📅 Ciclo Mensual
gantt
title Ciclo Mensual de Comisiones
dateFormat YYYY-MM-DD
section Enero
Facturas y Comisiones :2026-01-01, 31d
section Febrero
Corte Automático :milestone, 2026-02-01, 1d
Revisión Payouts :2026-02-02, 5d
Generar OC :2026-02-07, 3d
Pagar Partners :2026-02-10, 5d
⏰ Día 1: Corte Automático
- CRON ejecuta a las 6:00 AM
- Agrupa comisiones del mes anterior
- Crea Payouts por Partner automáticamente
📋 Días 2-7: Revisión
- Manager revisa Payouts generados
- Verifica comisiones incluidas
- Confirma cada Payout válido
📄 Días 7-10: Generar OC
- Genera Orden de Compra automática
- Partner configurado como proveedor
- Detalle de comisiones en líneas
💰 Días 10-15: Pago
- Tesorería procesa la OC
- Transferencia bancaria al Partner
- Marca Payout como Pagado
INICIANDO NEXUS...
VENIU NEXUS
Sistema de Comisiones sobre Facturas Pagadas
⚡ Odoo v19
◈ Versión 2.0.0
0
Partners
4
Tiers
15%
Max Rate
🎯 Visión General
NEXUS Partners permite a distribuidores externos comercializar productos Veniu, ganando comisiones automáticas sobre facturas pagadas de sus clientes asignados.
💰 FLUJO DE NEGOCIO
1
Partner refiere cliente
→
2
Cliente contrata
→
3
Cliente paga factura
→
4
Comisión automática
→
5
Pago mensual
🏢 Para Grupo Veniu
- Expansión de mercado sin inversión directa
- Fuerza de ventas externa escalable
- Control centralizado de operaciones
- Pagos automatizados vía OC
🤝 Para Partners
- Ingresos recurrentes garantizados
- Comisiones automáticas por factura
- Portal en tiempo real 24/7
- Sistema de niveles con beneficios
👥 Para Clientes
- Atención personalizada local
- Consultoría especializada
- Soporte cercano y ágil
- Implementación rápida
💰 Flujo Principal de Comisiones
flowchart TD
subgraph SETUP["1️⃣ SETUP INICIAL"]
A1["Crear Partner NEXUS"] --> A2["Asignar Tier"]
A2 --> A3["Aprobar Partner"]
A3 --> A4["Partner Activo ✅"]
end
subgraph ASIGNACION["2️⃣ ASIGNACIÓN DE CLIENTES"]
B1["Cliente nuevo"] --> B2{"¿Tiene upline?"}
B2 -->|No| B3["Asignar Partner"]
B2 -->|Sí| B4["Ya asignado"]
B3 --> B5["Cliente vinculado ✅"]
end
subgraph COMISION["3️⃣ COMISIONES AUTOMÁTICAS"]
C1["Crear Factura"] --> C2["Confirmar"]
C2 --> C3["Registrar Pago"]
C3 --> C4{"¿Cliente tiene Partner?"}
C4 -->|Sí| C5["🔄 AUTO: Generar Comisión"]
C4 -->|No| C6["Sin comisión"]
C5 --> C7["Comisión Pendiente ✅"]
end
subgraph CORTE["4️⃣ CORTE MENSUAL"]
D1["⏰ Día 1 del mes"] --> D2["CRON automático"]
D2 --> D3["Agrupar comisiones"]
D3 --> D4["Crear Payout"]
end
subgraph PAGO["5️⃣ PAGO AL PARTNER"]
E1["Confirmar Payout"] --> E2["Generar OC"]
E2 --> E3["Procesar Pago"]
E3 --> E4["Partner Pagado ✅"]
end
A4 --> B1
B5 --> C1
C7 --> D1
D4 --> E1
🏗️ Arquitectura del Sistema
flowchart TB
subgraph FRONTEND["🖥️ INTERFACES"]
Portal["🌐 Portal Web
/my/nexus"] Backend["⚙️ Backend Odoo
NEXUS Partners"] end subgraph CORE["📦 CORE MODELS"] NP["nexus.partner
Partners"] NC["nexus.commission
Comisiones"] NPY["nexus.payout
Pagos"] NT["nexus.tier
Niveles"] end subgraph ODOO["🏢 ODOO STANDARD"] RP["res.partner
Contactos"] AM["account.move
Facturas"] PO["purchase.order
Compras"] end Portal --> NP Backend --> NP NP --> NC NC --> NPY NPY --> PO NP --> NT RP --> NP AM --> NC
/my/nexus"] Backend["⚙️ Backend Odoo
NEXUS Partners"] end subgraph CORE["📦 CORE MODELS"] NP["nexus.partner
Partners"] NC["nexus.commission
Comisiones"] NPY["nexus.payout
Pagos"] NT["nexus.tier
Niveles"] end subgraph ODOO["🏢 ODOO STANDARD"] RP["res.partner
Contactos"] AM["account.move
Facturas"] PO["purchase.order
Compras"] end Portal --> NP Backend --> NP NP --> NC NC --> NPY NPY --> PO NP --> NT RP --> NP AM --> NC
📊 Diagrama E-R
erDiagram
NEXUS_PARTNER ||--o{ NEXUS_COMMISSION : genera
NEXUS_PARTNER ||--o{ RES_PARTNER : tiene_clientes
NEXUS_PARTNER }o--|| NEXUS_TIER : tiene_nivel
NEXUS_PARTNER }o--|| RES_PARTNER : es_contacto
NEXUS_COMMISSION }o--|| NEXUS_PAYOUT : incluida_en
NEXUS_COMMISSION }o--o| ACCOUNT_MOVE : origen
NEXUS_PAYOUT }o--o| PURCHASE_ORDER : genera
RES_PARTNER }o--o| NEXUS_PARTNER : upline
🏆 Sistema de Tiers
flowchart LR
E["🥉 Explorer
8%"] --> B["🥈 Builder
10%"] B --> A["🥇 Accelerator
12%"] A --> EL["🏆 Elite
15%"]
8%"] --> B["🥈 Builder
10%"] B --> A["🥇 Accelerator
12%"] A --> EL["🏆 Elite
15%"]
🥉
Explorer
8%
$0+ facturación
🥈
Builder
10%
$10,000+ facturación
🥇
Accelerator
12%
$50,000+ facturación
🏆
Elite
15%
$100,000+ facturación
💵 Cálculo de Comisión
┌─────────────────────────────────────────────────────┐
│ EJEMPLO DE CÁLCULO │
├─────────────────────────────────────────────────────┤
│ │
│ Factura del Cliente: $10,000.00 (sin IVA) │
│ Tier del Partner: Builder │
│ Tasa de Comisión: 10% │
│ │
│ ───────────────────────────────────────────────── │
│ │
│ COMISIÓN = Base × Tasa │
│ COMISIÓN = $10,000.00 × 0.10 │
│ COMISIÓN = $1,000.00 │
│ │
└─────────────────────────────────────────────────────┘
🔄 Estados y Transiciones
Estados de Comisión
stateDiagram-v2
[*] --> Pendiente: Factura pagada
Pendiente --> Aprobada: Manager aprueba
Aprobada --> Pagada: Incluida en Payout
Pendiente --> Cancelada: Cancelar
Aprobada --> Cancelada: Cancelar
Estados de Payout
stateDiagram-v2
[*] --> Borrador: CRON día 1
Borrador --> Confirmado: Confirmar
Confirmado --> OC_Generada: Generar OC
OC_Generada --> Pagado: Marcar Pagado
Borrador --> Cancelado: Cancelar
Estados de Partner
stateDiagram-v2
[*] --> Borrador: Crear
Borrador --> Pendiente: Enviar
Pendiente --> Aprobado: Aprobar
Aprobado --> Suspendido: Suspender
Suspendido --> Aprobado: Reactivar
🌐 Portal del Partner
flowchart TB
subgraph PORTAL["Portal NEXUS"]
HOME["📊 Dashboard
/my/nexus"] COMM["💰 Comisiones
/my/nexus/commissions"] CLI["👥 Clientes
/my/nexus/clients"] PAY["💳 Pagos
/my/nexus/payouts"] end HOME --> COMM HOME --> CLI HOME --> PAY
/my/nexus"] COMM["💰 Comisiones
/my/nexus/commissions"] CLI["👥 Clientes
/my/nexus/clients"] PAY["💳 Pagos
/my/nexus/payouts"] end HOME --> COMM HOME --> CLI HOME --> PAY
| Sección | URL | Funcionalidad |
|---|---|---|
| 📊 Dashboard | /my/nexus |
Métricas en tiempo real, comisiones recientes, clientes activos |
| 💰 Comisiones | /my/nexus/commissions |
Lista completa con filtros avanzados y paginación |
| 👥 Clientes | /my/nexus/clients |
Clientes asignados con métricas de facturación |
| 💳 Pagos | /my/nexus/payouts |
Historial de pagos con detalle de OC |
📦 Modelos de Datos
nexus.partner
| Campo | Tipo | Descripción |
|---|---|---|
| reference | Char | Código único (NXP-XXXX) |
| partner_id | Many2one | Contacto asociado (res.partner) |
| tier_id | Many2one | Nivel actual del partner |
| state | Selection | Estado del partner (draft/pending/approved/suspended) |
| client_ids | One2many | Clientes asignados al partner |
| total_revenue | Float | Facturación acumulada de clientes |
nexus.commission
| Campo | Tipo | Descripción |
|---|---|---|
| reference | Char | Código único (NXC-XXXX) |
| nexus_partner_id | Many2one | Partner que recibe la comisión |
| source_invoice_id | Many2one | Factura origen (account.move) |
| base_amount | Float | Monto de la factura (sin IVA) |
| commission_rate | Float | Tasa aplicada (%) |
| total_amount | Float | Monto de comisión calculado |
nexus.payout
| Campo | Tipo | Descripción |
|---|---|---|
| reference | Char | Código único (NXY-XXXX) |
| nexus_partner_id | Many2one | Partner a pagar |
| period_start/end | Date | Período del corte mensual |
| commission_ids | One2many | Comisiones incluidas en el payout |
| purchase_order_id | Many2one | OC generada para el pago |
| total_amount | Float | Total a pagar al partner |
📅 Ciclo Mensual
gantt
title Ciclo Mensual de Comisiones
dateFormat YYYY-MM-DD
section Enero
Facturas y Comisiones :2026-01-01, 31d
section Febrero
Corte Automático :milestone, 2026-02-01, 1d
Revisión Payouts :2026-02-02, 5d
Generar OC :2026-02-07, 3d
Pagar Partners :2026-02-10, 5d
⏰ Día 1: Corte Automático
- CRON ejecuta a las 6:00 AM
- Agrupa comisiones del mes anterior
- Crea Payouts por Partner automáticamente
📋 Días 2-7: Revisión
- Manager revisa Payouts generados
- Verifica comisiones incluidas
- Confirma cada Payout válido
📄 Días 7-10: Generar OC
- Genera Orden de Compra automática
- Partner configurado como proveedor
- Detalle de comisiones en líneas
💰 Días 10-15: Pago
- Tesorería procesa la OC
- Transferencia bancaria al Partner
- Marca Payout como Pagado