Liquidación de comisiones a promotores
- devintegrations
Sumario
Objetivo
Construir la red de brokers con los criterios definidos por La Agencia de Viajes y con base en esto conocer, liquidar y pagar las comisiones generadas a partir de las ventas de los brokers obtenidas desde NetSuite y/o registradas directamente en Netoffice.
Diseño
Nueva Tabla Tipo
Se creó una nueva tabla tipo “Categoría Promotor” para identificar las diferentes categorías que tendrán los brokers.
La misma tiene un ID alfanumérico de 5 caracteres y una descripción de 100, a su vez incluye una columna adicional que indica el número máximo de promotores dependientes en la red y otra para el nivel de profundidad (cantidad de niveles que comisionan por transacción).
Nota para implementación: Permiso para agregar categorías CATEGORIAPROMOTOR.
Nuevos campos en el maestro de Usuarios
Se agregó un nuevo combo en el maestro de usuarios con el fin de establecer la categoría del promotor. El mismo ofrece las categorías registradas en la nueva tabla tipo del punto 1. Dicho combo se habilita cuando el tipo de usuario es PRO (promotor), de lo contrario se visualiza grisado.
Nota: El broker va a estar identificado como usuario promotor dentro de Netoffice.
Adicionalmente se agregó un campo nuevo “Código Promotor” alfanumérico y admite hasta 10 caracteres para informar el código de cada promotor en la red de StarzInfinite. Por ejemplo SZI0001.
Cuando se selecciona la categoría del promotor NetOffice trae la categoría y la cantidad de promotores dependientes, dejando la opción (por permisos) de modificar dicha cantidad de dependientes de uno en uno hacia arriba.
Por otra parte, se agregó una nueva solapa en el maestro de usuarios con el fin de informar los promotores asociados (red de brokers), siempre y cuando el tipo de usuario es PRO (promotor).
Dicha solapa se llama “Red de Promotores” y tiene:
Frame “Promotores”
Grilla “Seleccionados” para informar los promotores asociados.
Botón “Agregar” para sumar promotores a la grilla. Debe desplegar un pop up con la lista de usuarios promotores y debe permitir la selección masiva de los mismos.
Botón “Borrar” para quitar promotores de la grilla, teniendo en cuenta que no se le hayan liquidado comisiones ni tenga ventas asociadas, de lo contrario, no debe ser posible su eliminación.
Nota: Permiso para asociar brokers BOUSUARIOPROMOTOR. Y permiso para restringir la cantidad de brokers BOUSUARIOEDITACANTIDADPROMOTORESDEPENDIENTES
Configuración de Reglas
Se agregó un nuevo ícono “Liquidación de Comisiones a Promotores” dentro de Administración > Configuración con el fin de establecer las reglas para liquidar comisiones.
La pantalla tiene en la sección superior un frame “Configuración de Reglas” con los campos necesarios para establecer las reglas:
Tipo de Producto → Combo que debe ofrecer todos los productos de NetOffice, inclusive los FEEs.
Subtipo → Solo debe habilitarse cuando el Tipo de Producto sea Vario (VI o VN). Debe listar todos los subtipos de Vario. Si no se informar el subtipo, aplica para todos.
Tipo de Cálculo→ Combo que debe ofrecer todos los tipos de cálculos de los servicios. Si no se informa el tipo, aplica para todos los cálculos.
Clase → Campo de texto para informar la clase del boleto. Se debe habilitar cuando el tipo de producto sea Aéreo Nacional o Internacional. Si no se informa la clase, aplica para todas.
Nivel → Combo que debe ofrecer hasta 6 niveles.
Comisión → Campo de texto para informar el porcentaje o importe de comisión.
% → Radio button para indicar si la comisión es un %.
Importe Fijo → Radio button para indicar si la comisión es un importe fijo.
Aplica sobre Bruto → Radio button para indicar si la comisión aplica sobre la Tarifa Bruta o Neta.
Valor mínimo de Ventas → Campo numérico para informar el monto mínimo que les dará derecho a comisionar sobre las ventas de sus promotores dependientes.
Vigencia → Combo con Fecha Desde y Hasta para especificar la fecha de validez de la regla. Si no se especifica la fecha final quiere decir que puede ser indeterminada.
Al pie, se agregó el botón “Grabar”.
La pantalla a su vez tiene una grilla donde mostrar todas las reglas cargadas y a su vez, permite su edición.
Los campos de la misma son:
Tipo de Producto
Sub Tipo
Tipo de Cálculo
Clase
Nivel
Comisión %
Importe Fijo
Aplica sobre Bruto
Valor mínimo de Ventas
Vigencia
Adicionalmente la grilla tiene a la derecha, el botón Editar para desplegar la información en los campos superiores (frame “Configuración de Reglas”) para ser editados.
Nota para implementación: Permiso para crear reglas REGLASCOMISIONESPROMOTORES
Nueva Pantalla de Reporte para liquidación y pago de comisiones de red
Se agregó un nuevo ícono dentro de menú Reportes > Gestión que se llama “Liquidación de comisiones de red”.
Cuando se selecciona dicho icono se despliega una pantalla con las siguientes características:
Frame “Filtros:”
Último mes → Al elegir este radio button debe seleccionar por default las fechas inicial y final del mes inmediatamente anterior.
Última semana → Al elegir este radio button debe seleccionar por default las fechas inicial y final de la semana inmediatamente anterior de lunes a domingo.
Fecha Desde → Calendario para informar la Fecha de Emisión de forma manual. Por defecto debe mostrar el primer día del mes en curso.
Fecha Hasta → Calendario para informar la Fecha de Emisión de forma manual. Por defecto debe mostrar el último día del mes en curso.
Promotor→ Combo que debe ofrecer todos los promotores del sistema (usuario con tipo PRO). Si no se selecciona, debe mostrar las comisiones de TODOS los promotores.
Servicio → Combo que debe ofrecer todos los servicios y FEEs. Si no se especifica nada, debe traer todos.
Estado → Combo que debe ofrecer Pendientes de Liquidar, Liquidadas, Todas.
Categoría Promotor → Combo que debe ofrecer las categorías registradas en la tabla tipo Categoria_Promotor. NUEVO!!!
Ciudad → Buscador de ciudades para filtrar por la ciudad del promotor (maestro de usuario, campo Ciudad de solapa Info Personal). NUEVO!!!
Ventas Directas → Radio button para indicar que solo se quieren consultar las ventas directas del promotor.
Ventas Indirectas (Red) → Radio button para indicar que solo se quieren consultar las ventas indirectas del promotor (de su red).
Total Ventas (directas e indirectas) → Radio button para indicar que se quieren consultar todas las ventas del promotor (directas e indirectas).
Los últimos 3 radio buttons son excluyentes. Solo uno puede ser seleccionado!
Al pie, se ubica el botón “Filtrar” para desplegar resultados.
Grilla con dos niveles de información:
Registros Principales: Con la información consolidada por promotor, respetando los filtros utilizados. Es decir, que muestra el importe de comisiones a pagar para los promotores en el rango de fechas especificado.
Detalles: Composición de la información consolidada por promotor. Es decir, que muestra el listado de servicios del promotor con toda su información (producto, tarifa, clase, etc).
Registros Principales
Promotor → Nombre del promotor
Moneda → ID Moneda
Comisión → Sumatoria de comisiones del periodo para el promotor
Detalles
Se despliegan con el botón “+”.
Código promotor → Código alfanumérico del usuario promotor (campo nuevo)
Promotor → Nombre del promotor.
Fecha de Reserva → Fecha de reserva del servicio.
Fecha Inicio → Fecha de inicio del servicio.
Fecha Fin → Fecha de fin del servicio. Aplica solo para servicios terrestres (es decir, todos menos los aéreos).
Nro. Vuelo → Nro. de vuelo del boleto. Aplica solo para aéreos.
Origen → Código de la ciudad de Origen.
Destino → Código de la ciudad Destino.
Fecha de Emisión → Fecha de emisión del servicio.
Aerolínea → Número de aerolínea. Aplica solo para aéreos.
Número de Ticket. → Número de ticket. Aplica solo para aéreos.
Coupon → Aplica solo para aéreos.
Clase → Clase del boleto. Aplica solo para aéreos.
FareBasis → Aplica solo para aéreos.
Pasajero → Nombre del pasajero.
Tipo Pasajero → Tipo de pasajero.
PNR → Código de reserva.
Moneda → Código de moneda.
Gross SC →
Tramo → Ruta del segmento. Aplica solo para aéreos.
Tarifa Base de Comisión → Tarifa del segmento en aéreos o Tarifa total para servicios terrestres.
% → Porcentaje de comisión.
Tipo de comisión → Venta Directa o Red.
Comisión a pagar → Importe de comisión.
Reason Code
Referencia Front → Referencia Front.
Id File → Id File.
Tipo de Servicio → aéreo, asistencia, barco, hotel, paquete, rent a car, vario.
Prestador → Nombre del prestador del servicio
Estado → Estado de la comisión. Los posibles estados deben ser “Pendiente de Liquidación” y “Pagado”.
IMPORTANTE: El reporte se abre por servicio cuando se trate de productos terrestres y por tramo cuando son aéreos.
Cálculo de Comisiones
Las comisiones se calculan en función de las reglas configuradas en el punto 3 del presente documento.
Cada vez que se realiza una venta, el promotor queda como nivel primario y los beneficiarios (brokers asociados) son los niveles superiores de acuerdo a la categoría. Si el promotor del último nivel de su categoría depende de un DIAMOND o un FOUNDER, la liquidación se extiende hasta cubrir a estas dos categorías. Por lo tanto NetOffice busca el promotor relacionado en la red de promotores (según el maestro de usuarios del punto 2 del presente documento), es decir, de quien depende para identificarlo como NIVEL 2 y así sucesivamente.
IMPORTANTE: Se debe consultar la tabla tipo “Categoría Promotor” para saber cuantos niveles comisionan por la categoría del broker.
Ejemplo de Red para una Agencia de Viajes:
Si la categoría del promotor es GOLD, las comisiones sólo se aplican hasta el Nivel 4. Es decir, que hasta 4 promotores van a cobrar una comisión. Salvo que en su red, alcance a un promotor con categoría FOUNDER o DIAMOND, en cuyo caso, comisionan 2 niveles más.
Si la categoría del promotor es SILVER, las comisiones sólo se aplican hasta el Nivel 3. Es decir, que hasta 3 promotores van a cobrar una comisión. Salvo que en su red, alcance a un promotor con categoría FOUNDER o DIAMOND, en cuyo caso, comisionan 2 niveles más.
La consulta de reglas se realiza por: producto y sub-producto si es un Vario, nivel, tipo de cálculo (puede estar vacío), clase (si es aéreo), vigencia y valor mínimo de venta. Una vez que se localizan las reglas, se aplica el porcentaje sobre la tarifa bruta/neta o el importe fijo según corresponda.
Nota: El valor mínimo de ventas, se establece sobre todas las comisiones del broker (independientemente del producto). Y solo comisiona en red, si se supera dicho mínimo, de lo contrario solo comisiona por sus ventas directas.
En el caso de los servicios aéreos, el cálculo de la comisión se realiza sobre la Tarifa (con o sin impuestos, depende si la regla aplica sobre neto o bruto) de los segmentos. Para eso se necesita leer el dato en el servicio de NetSuite (nuevo US).
En el caso de los servicios terrestres, el cálculo de la comisión se realiza sobre la Tarifa (con o sin impuestos, depende si la regla aplica sobre neto o bruto) del servicio.
Las comisiones se deben calcular sobre servicios confirmados (facturados y cobrados).
Funcionalidades de la Grilla
Con doble click, debe abrir el File asociado.
Con botón derecho se debe poder exportar a Excel e imprimir.
Botones
Seleccionar Todos: Selecciona todos los registros de la grilla.
Deshacer Todos: Quita la selección de registros de la grilla.
Marcar como Pagado: Botón que cambia el estado de la comisión a “Pagado”.
Nota: Como los brokers envían su factura de comisión, el pago se hará manual en NetOffice y luego se marcarán las comisiones como pagadas.
Nuevo WebService
Se creó un nuevo webservice “SaleCommissionService” que permite ser consultado por un rango de fechas y promotor (vendedor) con el fin de enviarle a NetSuite toda la información de las comisiones.
Las variables para el Get, son:
DateFrom
DateTo
SalesMan (dknumber)
Y la información a enviar:
Código promotor → Código alfanumérico del usuario promotor (campo nuevo)
Promotor → Nombre del promotor.
Fecha de Reserva → Fecha de reserva del servicio.
Fecha Inicio → Fecha de inicio del servicio.
Fecha Fin → Fecha de fin del servicio. Aplica solo para servicios terrestres (es decir, todos menos los aéreos).
Nro. Vuelo → Nro. de vuelo del boleto. Aplica solo para aéreos.
Origen → Código de la ciudad de Origen.
Destino → Código de la ciudad Destino.
Fecha de Emisión → Fecha de emisión del servicio.
Aerolínea → Número de aerolínea. Aplica solo para aéreos.
Número de Ticket. → Número de ticket. Aplica solo para aéreos.
Coupon → Aplica solo para aéreos.
Clase → Clase del boleto. Aplica solo para aéreos.
FareBasis → Aplica solo para aéreos.
Pasajero → Nombre del pasajero.
Tipo Pasajero → Tipo de pasajero.
PNR → Código de reserva.
Moneda → Código de moneda.
Gross SC →
Tramo → Ruta del segmento. Aplica solo para aéreos.
Tarifa Base de Comisión → Tarifa del segmento en aéreos o Tarifa total para servicios terrestres.
% → Porcentaje de comisión.
Tipo de comisión → Venta Directa o Red.
Comisión a pagar → Importe de comisión.
Reason Code
Referencia Front → Referencia Front.
Id File → Id File.
Tipo de Servicio → aéreo, asistencia, barco, hotel, paquete, rent a car, vario.
Prestador → Nombre del prestador del servicio
Estado → Estado de la comisión. Los posibles estados deben ser “Pendiente de Liquidación” y “Pagado”.
Netactica.com