Comisiones por Agente AY-004

Reporte de comisiones individuales (VE-023) y unificado de todos los agentes (VE-024)

Menú Ayuda

Que es el Reporte de Comisiones

El reporte de Comisiones por Agente (VE-023) calcula las comisiones de venta para cada agente basandose en las ventas de contado, los recibos de credito (CxC) y opcionalmente las devoluciones en un periodo de fechas.

Incluye tres tipos de transacciones:

  • CONTADO Facturas de venta pagadas de contado (FormaPago = 01).
  • CREDITO Recibos de CxC aplicados — pagos recibidos sobre facturas a credito.
  • DEVOLUC Notas de credito (tipo 03) — restan comision al agente.
Permiso requerido Se necesita el permiso 523 para acceder a este reporte.

Como acceder

Menu Principal
Ventas
Comisiones por Agente

El reporte se abre en una nueva ventana con filtros a la izquierda y la tabla de datos a la derecha.

Modos de agente

El campo Modo determina como se identifica al agente responsable de cada transaccion:

ModoCampoDescripcion
Agente Cliente Clientes.AgenteVentaCodigo Usa el agente asignado al cliente. Si un cliente tiene agente "001", todas sus facturas se atribuyen a ese agente sin importar quien las creo.
Agente Factura VentaMadre.AgenteCodigo Usa el agente que viene en la factura. Es el modo por defecto y el mas comun.
Usuario Factura VentaMadre.UsuarioCodigo Usa el usuario que creo la factura. Util cuando todos los empleados cobran comision por lo que venden.
Consejo El modo se guarda en localStorage y se restaura automaticamente al reabrir el reporte.

Filtros disponibles

Desde / Hasta

Rango de fechas con hora. Para CONTADO filtra por la fecha de la factura. Para CREDITO filtra por la fecha del recibo CxC.

F. Factura del Recibo

Checkbox que habilita los campos Fac Desde / Fac Hasta. Cuando esta activo, las transacciones de credito se filtran adicionalmente por la fecha de la factura asociada al recibo.

Devoluciones

Checkbox que incluye las notas de credito (tipo 03) como filas DEVOLUC con monto negativo. Si esta desactivado, las NC no aparecen en el reporte.

Panel de Agentes

Lista lateral izquierda con todos los agentes activos. Seleccione un agente para ver su detalle. La opcion "-- Todos --" no muestra datos (debe seleccionar un agente especifico).

Tipos de recibo y signo

El panel Tipo Recibo permite filtrar las transacciones de credito por tipo de movimiento CxC.

Signo + / -

Cada tipo de recibo tiene un badge de signo que se alterna haciendo clic:

  • + (verde) — El monto del recibo suma a la comision. Es el comportamiento normal.
  • - (rojo) — El monto del recibo resta a la comision. Util para tipos como "aplicacion de NC" que reducen la deuda sin ser un pago real.
Persistencia La configuracion de signos se guarda en localStorage y se mantiene entre sesiones. Tambien se transmite al reporte Unificado (VE-024).

Columnas del reporte

ColumnaDescripcion
#Numero de fila consecutivo
FacturaNumero de la factura de venta
ReciboNumero del recibo CxC (vacio para contado)
TipoDocTipo de documento electronico (01-FE, 04-TE, etc.)
FechaFecha de la transaccion (factura o recibo)
F. FacturaFecha de la factura original (relevante en credito)
DiasDiferencia en dias entre Fecha y F. Factura
ClienteNombre del cliente
TipoCONTADO, CREDITO o DEVOLUC
FacturadoTotal de la factura (incluye impuestos)
ImpuestoMonto de IVA
MultiplicadorFactor para extraer la venta neta del monto del recibo
VentaMonto sobre el cual se calcula la comision
Com%Porcentaje de comision del agente (desde tabla Empleados)
ComisionMonto de comision calculado = Venta x Com% / 100

Calculo de la comision

El calculo varia segun el tipo de transaccion:

Contado

// La venta es directa de la factura
Venta = TotalVenta - TotalDescuento
Multiplicador = 1
Comision = Venta x ComPct / 100

Credito

// El recibo CxC incluye IVA, hay que extraer la venta neta
TasaIVA = Impuestos / (Facturado - Impuestos)
Multiplicador = TasaIVA + 1
VentaNeta = MontoRecibo / Multiplicador
Comision = VentaNeta x ComPct / 100

Devoluciones

// Las devoluciones restan (monto negativo)
Venta = -(TotalNC x TipoCambio) / Multiplicador
Comision = Venta x ComPct / 100 // resultado negativo
Multiplicador El multiplicador solo aplica a transacciones de CREDITO y DEVOLUC. Para CONTADO siempre es 1 porque la venta ya viene desglosada desde la factura.

Reporte Unificado (VE-024)

El boton "Unificado" en la barra de titulo de VE-023 abre un segundo reporte que muestra las comisiones de todos los agentes en una sola vista, agrupados por agente y cliente.

Como abrirlo

  1. Configure los filtros deseados en VE-023 (fechas, modo, tipos recibo, devoluciones).
  2. Haga clic en el boton Unificado en la barra de titulo.
  3. Se abre una nueva ventana con el reporte unificado usando los mismos filtros.
Sin filtros propios VE-024 no tiene filtros propios. Recibe todos los parametros desde VE-023 via la URL. Para cambiar filtros, regrese a VE-023, ajuste y vuelva a abrir el Unificado.

Barra informativa

En lugar de controles de filtro, VE-024 muestra una barra con la informacion de los filtros aplicados: periodo, modo, tipos de recibo, tipos negativos y si incluye devoluciones.

Estructura de grupos (VE-024)

El reporte unificado organiza los datos en una jerarquia de tres niveles:

1. Agente (fila azul oscuro)

Encabezado con el codigo, nombre y porcentaje de comision del agente. Ejemplo: AGENTE: 001 - Juan Perez (Com: 5.00%)

2. Cliente (fila gris)

Dentro de cada agente, las transacciones se sub-agrupan por cliente. Cada cliente tiene su encabezado.

3. Detalle

Las mismas 15 columnas que VE-023 con el detalle de cada transaccion.

Subtotales

  • Subtotal por cliente — Suma de Facturado, Venta y Comision de todas las transacciones de ese cliente.
  • Subtotal por agente — Suma de todos los clientes del agente (fila azul con borde doble).
  • Gran Total — Suma de todos los agentes (fila con fondo accent al final).

Exportar a Excel

Desde VE-023

Haga clic en Excel. Exporta las transacciones del agente seleccionado con encabezado de empresa, nombre del reporte y periodo.

Desde VE-024

Haga clic en Excel. Exporta todos los agentes con filas de grupo intercaladas:

  • Fila de encabezado por agente
  • Filas de detalle con columna "Agente" adicional
  • Filas de subtotal por cliente y por agente
  • Fila de Gran Total al final

Enviar por email

El boton Enviar en VE-023 genera un PDF individual para cada agente y lo envia a su email registrado.

  1. Haga clic en Enviar y confirme la accion.
  2. El sistema recorre todos los agentes con email en Empleados.Email.
  3. Para cada agente con datos, genera un PDF y lo envia.
  4. Al finalizar muestra un resumen: enviados, sin email y sin datos.
Email del agente Si un agente no tiene email registrado en la tabla Empleados, se omite del envio. El resumen indica cuantos quedaron "Sin email".

Atajos de teclado

TeclaAccionAplica en
EscapeCerrar ventanaVE-023 y VE-024
Flecha izquierdaPagina anteriorVE-023 y VE-024
Flecha derechaPagina siguienteVE-023 y VE-024
Consejo Las flechas solo funcionan cuando el foco no esta en un campo de texto. Si esta escribiendo en un filtro, las flechas mueven el cursor normalmente.

Permisos

Los permisos controlan el acceso a los reportes de comisiones. Se asignan al grupo de usuarios desde el módulo de Seguridad (SE-001).

PermisoDescripciónAfecta
523Acceso al reporte Comisiones por Agente (VE-023)Ver y filtrar comisiones por agente individual
524Acceso al reporte Comisiones por Artículo (VE-024)Ver desglose de comisión por cada artículo vendido
522Acceso al reporte Comisiones IntermediariosVer el reporte de comisiones de intermediarios/distribuidores
Acceso unificado (VE-024) El reporte unificado de todos los agentes (VE-024) se abre desde VE-023. Requiere el mismo permiso 523 y hereda los filtros seleccionados.

Parámetros de empresa

Los parámetros configuran el comportamiento del reporte y los datos en las exportaciones.

ParámetroDescripciónUso en comisiones
62Nombre de la empresaEncabezado del Excel y del PDF de impresión
54Nombre comercial / razón socialFallback si el parámetro 62 está vacío
66Cédula jurídica de la empresaIncluida en el encabezado del PDF de impresión
73Teléfono de la empresaIncluido en el encabezado del PDF de impresión
106Email de la empresaIncluido en el encabezado del PDF de impresión
130Dirección de la empresaIncluida en el encabezado del PDF de impresión
Porcentaje de comisión El porcentaje de comisión de cada agente se configura en el campo Empleados.Comision (tabla de empleados), no en los parámetros de empresa.

Problemas comunes

"No se encontraron registros" Verifique que el agente seleccionado tenga ventas en el periodo. Tambien confirme que el modo sea el correcto (un agente puede tener ventas en modo "Agente Factura" pero no en "Agente Cliente").
Comision aparece en 0.00 El agente tiene porcentaje de comision 0% en la tabla Empleados.Comision. Contacte al administrador para configurar el porcentaje correcto.
El unificado se abre vacio VE-024 necesita filtros en la URL. Si se accede directamente sin pasar por VE-023, no tendra parametros y mostrara el mensaje indicando que debe abrirse desde VE-023.
Totales no coinciden con otro reporte Este reporte tiene logica especifica de multiplicador y tipo de transaccion. Las ventas de contado usan el desglose de la factura, mientras que los recibos de credito usan el monto del recibo dividido por el multiplicador de IVA. Es normal que los totales difieran de un reporte de ventas puro.