Agentes de ventas

Resumen: un Agente de ventas representa al vendedor o comisionista detrás de cada operación. Mosce ERP permite agentes externos (freelancers), usuarios internos (empleados) o clientes que también refieren ventas, cada uno con su tarifa de comisión por defecto.

Tiempo de lectura: ~5 min

Cuándo usar esto

Lee este artículo si necesitas:

• Dar de alta a un vendedor para que aparezca como responsable en órdenes, cotizaciones y facturas.
• Asignarle un porcentaje o monto fijo de comisión por defecto.
• Asignar un agente "por defecto" a un cliente para que el sistema lo preseleccione al facturar.

Antes de empezar

• Necesitas el permiso sales-agents:create o sales-agents:update.
• Decide qué modo de agente usarás: externo, vinculado a un usuario del sistema o vinculado a un cliente.
• Si vas a vincularlo a un usuario interno, ese usuario ya debe estar creado en Administración → Usuarios.

Paso a paso

Crear un agente

1. Entra al módulo. Barra lateral → Operaciones → Agentes de ventas. (captura: lista de agentes)
2. Pulsa "Nuevo agente".
3. Selecciona el modo (pestañas en la parte superior del formulario):
   • Externo - freelancer o vendedor independiente. No tiene ni userId ni clientId.
   • Vinculado a usuario - empleado interno con login en Mosce ERP. Pega el ID del usuario; sus comisiones se calcularán sobre las ventas que él mismo capture.
   • Vinculado a cliente - un cliente registrado que también refiere ventas. Selecciónalo del listado.
4. Datos comunes:
   • Nombre (obligatorio).
   • RNC / Cédula - único por empresa. Útil para emitir reportes de comisiones.
   • Correo electrónico y teléfono.
5. Comisión por defecto.
   • Tipo de comisión: Porcentaje o Monto fijo.
   • Tarifa por defecto:
     • Si elegiste Porcentaje, escribe un número entre 0 y 100 (ej. 5 = 5 %).
     • Si elegiste Monto fijo, escribe el monto en RD$ por venta cerrada.
   • El indicador a la derecha del campo cambia (% o RD$) según el tipo seleccionado.
6. Notas - comentarios internos.
7. Activo - apaga el switch para retirar al agente sin borrarlo. Los agentes inactivos no aparecen en los selectores.
8. Pulsa "Crear".

Las comisiones escalonadas (tarifa por monto vendido o por categoría) no están disponibles en esta versión. La tarifa por defecto se usa como fallback; las reglas avanzadas llegarán en un sprint posterior.

Asignar un agente por defecto a un cliente

1. Entra a Operaciones → Clientes y abre el cliente.
2. Pulsa Editar y ve a la pestaña Crédito.
3. En Agente de ventas por defecto, selecciona el agente.
4. Guarda los cambios.

A partir de ese momento, cuando emitas órdenes, cotizaciones o facturas para ese cliente, el agente aparece preseleccionado (siempre puedes cambiarlo por operación).

Asignar un agente a una operación específica

En el formulario de orden, cotización o factura, hay un selector Agente de ventas. Solo una persona por venta - no se permiten splits multi-agente en esta versión.

Editar y eliminar

• Editar: ícono de lápiz en la lista o detalle del agente → Editar.
• Eliminar: ícono de basura. Es eliminación lógica; las facturas y órdenes pasadas mantienen el agente registrado para integridad histórica.

Ver rendimiento

El detalle del agente muestra sus datos básicos y configuración de comisión, pero no incluye todavía un panel de "ventas cerradas / comisiones devengadas". Para ese análisis usa Reportes y filtra las facturas por agente.

Resultado esperado

• El agente aparece en los selectores de cliente, orden, cotización y factura.
• Cuando un cliente tiene agente por defecto, el sistema lo preselecciona en cada nueva operación.
• La tarifa por defecto queda registrada como referencia; el cálculo final de comisiones se hará en el módulo correspondiente cuando esté disponible.

Errores comunes

Relacionados

• Clientes
• Facturas
• Cotizaciones