Portal Cliente Crédito Avanzado — MasVendido desarrollo

Objetivo de producto

Estado de cuenta — saldo, límite, movimientos, antigüedad, CFE Biller.
Sugerencias de compra — según lo que el cliente suele pedir + productos sugeridos para agregar.
Ayuda — FAQ crédito + mesa de ayuda / tickets (misma mesa que /servicio-asistencia).
Pedido web — elige día de retiro + 3% descuento automático.
Con stock — productos habituales disponibles hoy → agregar al pedido.
Sin stock — ETA de llegada + opción de pre-compra con descuento.

Mockups (wireframe)

Mi crédito — Dashboard

$ 84kDisponible

$ 16kUsado

$ 100kLímite

$ 2.4kVencido

Factura F001-1234Pendiente

Pedido SO-8891En curso

Sugerencias — Lo que suele pedir

✓ Con stock hoy

Piso SPC Roble 2m²48 u.

Zócalo PVC blanco120 u.

Cola vinílica 5kg24 u.

⏳ Sin stock — pre-compra

Guarda humid. 2mm~12 días · -5%

Membrana 20m~18 días · -5%

Arquitectura

┌─────────────────────────────────────────────┐ │ UI portal (pf_website / templates Odoo) │ │ /mi-cuenta · sugerencias · estado cuenta │ └────────────────────┬────────────────────────┘ │ JSON /mi-cuenta/api/* ┌────────────────────▼────────────────────────┐ │ pf_portal_credito (Odoo 19 — delgado) │ └────────────────────┬────────────────────────┘ │ pf_sale_credit_control · account.move · sale.order biller_all (CFE) · pf_preorder · EbrouBotv2 (BrouBot :8765)

Flujo pago BROU + BrouBot (P2)

Cliente transfiere a cuenta BROU (indica Nº factura en asunto).
En portal → Informar pago → sube captura del comprobante.
Odoo llama POST /leer_comprobante → extrae op., importe, fecha.
Odoo llama POST /verificar → BrouBot cruza movimientos eBROU.
Si confirmado → account.payment + reconcilia factura → aparece en estado de cuenta.
Si en cola → reintento automático (cron / cola BrouBot).

Descuento pre-compra

Nivel	Config	Default
Global	Ajustes → Ventas → Portal crédito	5%
Por producto	Ficha producto → «Descuento pre-compra portal %»	Vacío = usa global

Extras portal PRO (roadmap)

✓ P2+ Ayuda embebida + 3% web + día retiro + sugeridos agregar

🔲 Alertas facturas por vencer (email / badge)

🔲 Descargar estado de cuenta PDF

🔲 Repetir pedido anterior en 1 clic

🔲 Notificaciones cuando llega stock pre-comprado

→ Ver mockup interactivo Mi cuenta PRO

Reutiliza (ya existe)

Módulo	Uso en portal crédito
`pf_sale_credit_control`	allow_credit_sale, credit_limit, validación tope
`biller_all`	PDF CFE en facturas portal
`pf_preorder`	pf_is_preorder, pf_estimated_days, RFQ automática
`pf_website`	Branding, checkout, estilos portal
`pf_estado_pago`	Badges pago en pedidos/facturas

API implementada

Ruta	Descripción	Estado
`/mi-cuenta`	Página portal (5 tabs)	P2+
`/mi-cuenta/api/ayuda`	FAQ + links mesa ayuda	P2+
`/mi-cuenta/api/sugeridos-agregar`	Cross-sell productos nuevos	P2+
`/shop/cart/retiro`	Día retiro checkout	P2+
`/mi-cuenta/api/resumen`	Crédito + datos BROU + % web	P2+
`/mi-cuenta/api/estado-cuenta`	Facturas + comprobantes pagos	P2
`/mi-cuenta/api/sugerencias`	Stock / sin stock + sugeridos	P2+
`/mi-cuenta/api/pago/informar`	Subir captura → BrouBot → recibo	P2
`/mi-cuenta/api/precompra`	POST crear SO pre-orden	P5

Código: odoo-dev/pf_portal_credito/

Roadmap de fases

Spec + portal desarrollo

Documentación, mockups, módulo vacío en repo.

Hecho

UI «Mi cuenta» + pagos BrouBot

Portal /mi-cuenta, comprobantes, descuento global 5% / por producto.

En repo

Estado de cuenta PRO

Antigüedad, export PDF, alertas vencimiento.

Pendiente

Carrito sugerencias

Agregar al pedido, repetir pedido.

Pendiente

Pre-compra con descuento

Confirmar SO + pf_preorder RFQ + descuento configurable.

Pendiente

Catálogo B2B + tope en vivo

Lista precios partner, carrito con validación crédito.

Pendiente

Reglas de negocio (a definir)

Tema	Propuesta
Descuento pre-compra	5% default (`pf_portal_credito.preorder_discount_pct`)
Historial sugerencias	12 meses (`history_months`)
Acceso portal	Solo `allow_credit_sale = True`
ETA sin stock	`pf_estimated_days`; fase 2: PO entrante

Motor sugerencias (v1)

sale.order.line (12 meses, partner comercial, sale/done)
  → ranking por frecuencia y cantidad
  → cruce free_qty en vivo
  → CON STOCK: free_qty > 0
  → SIN STOCK: pf_is_preorder o free_qty ≤ 0 + ETA + descuento

← Volver al centro de desarrollo · docs/desarrollo/PORTAL_CLIENTE_CREDITO.md