Comisiones por Agente

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

AY-004
Menú Ayuda

Enviarle este manual a un usuario

El enlace abre solo este manual, sin el menú del sistema. El usuario no necesita clave ni entrar a FactuPOS: se ve en cualquier navegador y en el celular.

El WhatsApp sale del número de Soporte Real y el correo de info@soportereal.com. Con Compartir desde este teléfono sale de su propio WhatsApp y elige el contacto de su lista, sin escribir el número.

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.

Administrar la lista Permiso 566

La lista no es fija: desde este mismo panel se puede agregar un tipo (botón del encabezado), cambiarle el nombre (el lápiz de cada fila) o eliminarlo.

  • El código es de dos caracteres y no se repite. Al editar, el código no se puede cambiar: queda guardado en los recibos ya aplicados.
  • No se elimina un tipo que ya se usó. Si aparece en movimientos de CxC o CxP, el sistema lo dice y no lo borra, para no dejar recibos sin motivo.
Permiso Se necesita el permiso 566 para agregar, cambiar o eliminar. Sin él el panel se ve completo y la lista sirve igual para filtrar, pero los botones salen en gris: al pasar el mouse dicen qué falta. Lo asigna quien administre los permisos de su empresa en Seguridad → Usuarios SE-001.
Es la misma lista de Configuración Lo que se agregue o cambie acá es exactamente la lista de Tipos de Recibo CF-022, la que sale al aplicar un recibo en CxC y CxP. No es una lista aparte del reporte: un cambio se ve en todo el sistema.

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 que le quita el impuesto al monto del recibo. Contado siempre 1,0000; credito y devolucion 1 + la tasa de impuesto de esa factura (13% da 1,1300; exenta da 1,0000)
VentaMonto sobre el cual se calcula la comision
Com%Porcentaje de comision del agente, tomado del campo Comision de su ficha en Usuarios del Sistema (SE-001)
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: de donde sale 1,0000 y de donde 1,1300 El multiplicador no se digita ni se configura: lo calcula el sistema fila por fila. Solo aplica a las filas de CREDITO y DEVOLUC. En CONTADO siempre es 1,0000 porque la venta ya viene desglosada (sin impuesto) desde la factura. En CREDITO y DEVOLUC lo que se cobra es el monto del recibo, que viene con el impuesto incluido, y hay que quitarselo antes de calcular la comision: por eso se divide entre 1 + la tasa de impuesto de esa misma factura.
FilaImpuesto de la facturaMultiplicadorPor que
CONTADO (factura o tiquete)Cualquiera1,0000La venta ya viene sin impuesto desde la factura, no hay nada que quitar
CREDITO / DEVOLUCIVA 13%1,1300El monto del recibo trae el 13% adentro: se divide entre 1,13
CREDITO / DEVOLUCIVA 4%1,0400Mismo caso con tarifa del 4%
CREDITO / DEVOLUCIVA 1%1,0100Mismo caso con tarifa del 1%
CREDITO / DEVOLUCExenta o sin impuesto1,0000No hay impuesto que quitar, el monto del recibo ya es venta neta
CREDITO / DEVOLUCFactura mezclada (lineas gravadas y exentas)Ej. 1,0850Es la tasa real de esa factura (impuesto entre subtotal), por eso puede no ser un numero redondo
Ejemplo con numeros Factura a credito de 10.000,00 con impuesto de 1.150,44. El subtotal es 8.849,56 y la tasa real es 1.150,44 / 8.849,56 = 13%, entonces el multiplicador es 1,1300. Si el cliente abona los 10.000,00 completos, la Venta que comisiona es 10.000,00 / 1,13 = 8.849,56 y con un 1% de comision el agente gana 88,50. Si abona solo una parte, se divide esa parte: la comision se paga sobre lo que efectivamente se cobro.

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 que tengan email en su ficha de Usuarios del Sistema (SE-001).
  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 su ficha de Usuarios del Sistema (SE-001), 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
566Modificar la lista de tipos de reciboAgregar, cambiar o eliminar tipos desde el panel Tipo Recibo. Sin él la lista se ve y se usa para filtrar, pero los botones salen en gris
El 566 es el mismo de Configuración El permiso 566 no es propio de este reporte: es el de Tipos de Recibo CF-022, porque la lista es la misma en los dos lugares. Quien ya puede administrarla en Configuración también puede hacerlo desde acá, sin pedir nada más.
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 Comisión de su ficha en Usuarios del Sistema (SE-001), 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 el campo Comision en 0% en su ficha de Usuarios del Sistema (SE-001). 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.
"Unas filas tienen multiplicador 1,0000 y otras 1,1300" Es lo correcto y lo decide el sistema, no se configura. Las filas CONTADO siempre van en 1,0000 porque la venta ya viene sin impuesto. Las filas CREDITO y DEVOLUC llevan 1 + la tasa de impuesto de esa factura (13% da 1,1300), porque el monto del recibo trae el impuesto adentro y hay que quitarselo antes de comisionar. Una fila de credito en 1,0000 significa que esa factura era exenta o sin impuesto. Ver Calculo de la comision.
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.

Exportar a Excel: permiso 964

Si el botón Excel aparece gris, no es una falla: exportar este reporte se habilita persona por persona con su propio permiso:

  • Permiso 964 — Ventas · Comisiones por agente VE-023
Cómo se asigna Lo asigna quien administre los permisos de usuario de su empresa, en Seguridad → Usuarios SE-001: elegir a la persona, escribir el número del permiso (o la palabra Excel) en el buscador de permisos y marcar la casilla. Toma efecto recargando la pantalla, sin cerrar sesión.

Al pasar el mouse sobre el botón gris, el sistema dice qué le falta. Que a un compañero sí le funcione no significa que esté habilitado para todos: el permiso es por persona (por ejemplo, el usuario del contador suele ser uno aparte y necesita el suyo). Si el mensaje dice en cambio que la exportación está apagada para la empresa, esa no se abre desde el sistema: la solicita el dueño o la gerencia a Soporte Real. Ver el reporte en pantalla no pide este permiso; solo la descarga a Excel. Más detalles en El Excel de los reportes.