## Visión general

El módulo de Ventas de Conversa Labs tiene **superficies de consumo** (donde lees los números) y una
**superficie en vivo** (el telón/wallboard). Las de consumo son tres:

- **Panel del Vendedor** — la lectura individual: tus monedas, badges, nivel, puntos del mes y el
  progreso de tus metas.
- **Panel del Gestor** — la vista agregada del equipo, armada a partir del ranking (leaderboard), los
  Informes y el telón.
- **Informes de ventas** — el panel analítico de cumplimiento, historial de comisiones (payout) e
  historial de ranking (leaderboard), con exportación en CSV.

Por encima de todo esto, el **telón (wallboard)** muestra el ranking en vivo en un TV de la oficina.
En todas las superficies, **los números derivan de eventos reales** del producto — negocios ganados
en el CRM, pagos confirmados, agendamientos, follow-ups que convierten. No hay carga manual: lo que
lees es lo que la operación realmente produjo.

## Requisitos previos

- Módulo **Ventas y Gamificación** habilitado en la cuenta.
- **Eventos reales fluyendo** por la plataforma (negocios en el CRM, pagos, agendamientos) para que
  haya algo que puntuar e informar.
- **Metas activas** en el período vigente, para que el cumplimiento tenga referencia.
- Para abrir los **Informes de ventas** y las **exportaciones CSV** (incluido el libro de un vendedor
  específico) se necesita el permiso de **gestión de ventas** (`sales_manage`) — o ser administrador.
  El Panel del Vendedor no lo exige.

## Paso a paso

1. **Abre el Panel del Vendedor.** De un vistazo, revisa saldo de monedas, badges, nivel, puntos del
   mes y el progreso de hasta 5 metas activas.
2. **Sigue el ranking.** Mira tu posición en el leaderboard (por métrica, período y alcance) y en el
   telón en vivo.
3. **Gestor: abre los Informes de ventas.** Lee las tres secciones — cumplimiento, historial de
   payout e historial de leaderboard.
4. **Aplica filtros.** Acota por período, vendedor, métrica y alcance para responder una pregunta
   concreta.
5. **Exporta a CSV.** Descarga el extracto de comisiones o el historial de ranking para conciliar o
   analizar fuera de la plataforma.

## Configuración y opciones

### Panel del Vendedor

La lectura individual es siempre de **tu propia** cartera. Los widgets:

| Widget | Qué muestra | De dónde viene |
|---|---|---|
| Saldo de monedas | Monedas disponibles para canjear | Suma del extracto de monedas (créditos menos débitos) |
| Badges conseguidos | Cuántas medallas has ganado | Premios de badge otorgados a ti |
| Nivel actual | Tu nivel y los puntos acumulados que lo sostienen | El mayor nivel cuyo umbral de puntos superaste |
| Puntos del mes | Puntos sumados en el mes corriente | Eventos de puntos del mes vigente |
| Metas activas | Hasta 5 metas (la tuya, la de tu equipo y la de la cuenta) con % de cumplimiento | Metas vigentes más el cumplimiento calculado |

### Panel del Gestor

El gestor consolida al equipo a partir de tres fuentes: el **leaderboard** (ranking por métrica ×
período × alcance), los **Informes de ventas** (cumplimiento, payout e historial de ranking) y el
**telón** en vivo. Aquí es donde **cartera, metas y ranking** se conectan: la cartera define el dueño
de cada negocio, las metas definen el objetivo y el ranking ordena quién está más cerca de cumplir. El
Panel del Vendedor sigue siendo individual incluso para el gestor — la vista de equipo viene del
ranking y de los Informes.

### Informes de ventas

El overview analítico trae tres secciones:

| Sección | Qué trae |
|---|---|
| Cumplimiento (attainment) | % de cumplimiento por meta vigente, con el valor actual y la fecha del cálculo (hasta 50 metas, de mayor a menor) |
| Historial de payout | Totales de comisión por período: acumulado, aprobado y pagado |
| Historial de leaderboard | El ganador (1er lugar) por período y métrica |

Filtros disponibles:

| Filtro | Efecto |
|---|---|
| Período (`period_start`) | Considera registros a partir de la fecha indicada |
| Vendedor (`payee_id`) | Restringe al extracto de un vendedor (libro individual) |
| Métrica (`metric`) | Filtra el historial de ranking por la métrica |
| Alcance (`scope_type`) | Filtra el historial de ranking por tipo de alcance (cuenta/equipo/vendedor) |

### Exportación CSV

La exportación acepta `?kind=commissions` o `?kind=leaderboard` (sin el parámetro, el valor por
defecto es comisiones):

| Exportación | Cuándo usar | Columnas |
|---|---|---|
| Comisiones (`?kind=commissions`) | Conciliar payout y contabilidad | `payee_id`, `period_start`, `period_end`, `status`, `total_accrued`, `total_approved`, `total_paid` |
| Leaderboard (`?kind=leaderboard`) | Analizar el historial del ranking | `rank`, `user_id`, `team_id`, `scope_type`, `period_type`, `period_start`, `metric`, `value`, `trend` |

### Permisos y privacidad

- El **Panel del Vendedor** está aislado por vendedor: cada métrica (monedas, badges, nivel, puntos)
  se filtra por tu usuario. Un vendedor no ve los números de otro.
- El **ranking** (leaderboard/telón) es la vista compartida de la competencia.
- Los **Informes de ventas** y las **exportaciones CSV** exigen el permiso de **gestión de ventas**.
  Traer el **libro de un vendedor específico** (filtro por vendedor) también es una acción de gestión.

## Casos de uso

- El vendedor abre el panel por la mañana y ve, en segundos, qué tan cerca está de la meta del mes.
- El gestor usa los Informes para detectar quién está por encima y por debajo del cumplimiento por
  meta.
- Finanzas exporta el CSV de comisiones para conciliar el payout del período.
- La dirección exporta el historial de leaderboard para analizar cómo evolucionó el ranking a lo largo
  de los períodos.

## Consejos, límites y buenas prácticas

- Trata el Panel del Vendedor como un ritual diario — es la forma más rápida de ver el progreso de la
  meta.
- En los Informes, empieza sin filtros y acota de a poco; filtros demasiado estrictos pueden vaciar el
  resultado.
- El cumplimiento lista las metas vigentes de mayor a menor — úsalo para priorizar a quien necesita
  apoyo.
- La exportación de comisiones refleja el extracto (payout); la de leaderboard refleja los snapshots
  del ranking. Elige la que responde tu pregunta.

## Solución de problemas

- **Panel en cero**: probablemente no hay eventos puntuables en el período (negocios, pagos,
  agendamientos) o no hay metas activas. Confirma el uso de CRM/Pagos/Agenda y la existencia de metas
  vigentes.
- **Informe vacío**: los filtros pueden estar demasiado estrictos o el alcance equivocado. Amplía el
  período, limpia el filtro de vendedor/métrica y revisa el tipo de alcance.
- **Exportación bloqueada**: no tienes el permiso de **gestión de ventas**. Pide a un administrador
  que conceda el perfil adecuado.

## Ver también

- [Visión general de Ventas y Gamificación](/hc/ajuda/articles/sales-gamification-overview-es)
- [Gestión de ventas: cartera, aislamiento por vendedor y metas](/hc/ajuda/articles/sales-gamification-gestao-de-vendas-carteira-metas-es)
- [Gamificación, leaderboard, recompensas y comisiones](/hc/ajuda/articles/sales-gamification-gamificacao-leaderboard-recompensas-comissoes-es)
- [TELÓN (wallboard) en tiempo real](/hc/ajuda/articles/sales-gamification-telao-wallboard-es)