Wincoins
1.- Información:
Se trata de controlar en la aplicación la gestión de puntos que se acumularán por cada venta, y que servirán para aplicar en futuras ventas como descuento de la misma.
Por defecto el nombre de la "moneda" será Wincoins pero cada empresa podrá establecer el nombre que más le interese.
Se puede definir una cuota de aplicación en series de albaranes de venta, OR y facturas de venta. Y como añadido, se podrá tanto en familias como en artículos definir una cuota de aplicación o puntos por unidad
Prevalece lo definido en el artículo, luego lo definido en la familia, y por último lo de la serie. Se podrá por ejemplo solo definir una cuota de aplicación por serie y no definir ni en artículos ni familias. En series es imprescindible definir.
Por otro lado, se podrán compensar puntos, es decir, hacer descuento, solo en las series de albaranes de venta, OR o facturas que marquemos: "descuentos aplicables".
Cada Wincoin acumulado equivale siempre a 1 euro. Si tengo 7 Wincoins acumulados, descontaremos en la venta 7 euros.
Se podrá parametrizar los tipos de entidad a los que se excluye la aplicación de Wincoins. Esta acción solo la podrá realizar Winmotor.
Se podrán excluir líneas de venta puntales de la aplicación de Wincoins. Para ello hay un nuevo check en líneas de documento "excluir Wincoins".
Los abonos de las ventas que generaron Wincoins descontarán saldo en el monedero del cliente.
Los abonos de las ventas que consumieron Wincoins devolverán el saldo consumido al monedero del cliente.
En el ticket o factura, se indicarán los puntos descontados en esa venta, así como el saldo actual del cliente.
Esto está pendiente de que nos indiquen en que parte del informe añadir.
Cada venta que acumule saldo registrará la fecha de la venta y tendrá un periodo de validez definido en parámetros.
Si tenemos definido que el periodo de validez son 365 días, y el cliente ha realizado dos compras, la caducidad quedará así:
Venta 15 enero, 5 Wincoins, caducan el 14 de enero del año siguiente.
Venta 20 mayo, 7 Wincoins, caducan el 19 de mayo del año siguiente.
2.- Configuración a realizar:
Cuota de aplicación en series, familias (opcional) y artículos (opcional)
Marcar en que series se aplica descuentos.
Parámetros a rellenar:
3.- Funcionamiento:
Si por ejemplo hemos rellenado en la serie AV una cuota de aplicación del 2%, por cada línea grabada el programa calculará automáticamente un 2% sobre la base en Wincoins.
Se podrá consultar los Wincoins aplicados en cada línea y totales con el botón situado en la parte inferior "Wincoins"
Se podrá disponer de esos Wincoins en cualquier otra venta de serie donde hayamos marcado "descuentos aplicables". Para ello nos aparecerá un botón "compensar saldo". Al pulsarlo nos aparecerá un botón con la base del documento, los Wincoins disponibles, y el importe a aplicar. Podemos seleccionar como máximo ese importe, pero también podremos aplicar menos. En ese mismo formulario hay un botón para ver en detalle el saldo, así como el histórico (por si queremos ver líneas caducadas, consumidas, etc.). Si aceptamos este formulario con un importe positivo, se creará una nueva línea en el documento con el servicio parametrizado.
En el panel de entidades hay un nuevo botón para sacar listado de clientes con saldo, el detalle del saldo, etc.
4.- API:
OBTENER ID CLIENTE POR TELÉFONO
URL: http://IP_DOMINIO/NOMBRE_INSTANCIA/dat_winmotor_dat/v1/W7_ENT?api_key=XXX&filter[TELEFONOS_TODOS]=666888111
Simplemente habrá que indicar el número de teléfono. IP_DOMINIO es el dominio o IP del servidor y la api_key será la que vendrá especificada en Winmotor en Utilidades.
OBTENER WINCOINS BY ID CLIENTE
URL: http://IP_DOMINIO/NOMBRE_INSTANCIA/dat_winmotor_dat/v1/W7_ENT?api_key=XXX&filter[ID]=2
En la respuesta se informará del saldo de la entidad.
CAMBIAR EMAIL CLIENTE BY ID CLIENTE
ID_CLI es el ID (código) del cliente) y EMA es el email de la entidad.
RESTAR / SUMAR WINCOINS BY ID CLIENTE
URL: http://IP_DOMINIO/NOMBRE_INSTANCIA/dat_winmotor_dat/v1/_process/WCI_ACT_WIN_COI?param[CLI]=1¶m[UDS]=200&api_key=XXX
CLI = obligatorio, código o id del cliente.
UDS = obligatorio, unidades de Wincoins a sumar o restar.
FEC_CAD = es opcional y solo para el caso de sumar. Es la fecha de caducidad que tendrá esas unidades de Wincoins. Si no se pasa este parámetro se calculará según el parámetro definido en la aplicación de nº de días de caducidad de los Wincoins y la fecha de "hoy".
CONSULTAR HISTÓRICO DE WINCOINS DE CLIENTE (ACUMULACIÓN)
URL: http://IP_DOMINIO/NOMBRE_INSTANCIA/dat_winmotor_dat/v1/_query/WCI_BUS_WEB?param[ENT]=6618¶m[FH_DSD]=201020231030¶m[FH_HST]=251020231230&api_key=1234
Se podrá solicitar a winmotor el histórico de movimientos registrados filtrados de un cliente donde han intervenido wincoins (ya sea para añadir saldo o para restar) indicando el ID del cliente del que queremos consultar el histórico y la fecha desde y hasta, incluyendo hora, para filtrar el listado.
Si FH_DSD viene vacía devolveremos registros de hace 1000 días en adelante.
Si FH_HST viene vacía devolveremos registros hasta "hoy".
Winmotor nos devolverá todos los movimientos (acumulaciones) de wincoins realizados con la siguiente información en cada registro:
ID: código único del movimiento
LIN: código único de la línea de documento en la que se aplica wincoins.
CAB: código único del documento en el que se aplica wincoins
ENT: código único de la entidad consultada
FH_ALT: fecha/hora de alta del movimiento
FEC_CAD: fecha de caducidad del saldo
ORI: indica si se ha calculando en base a la serie, la familia o el artículo.
ORI_WXU: wincoins aplicados por unidad
ORI_CUO: cuota de cálculo
WCI_ACU: wincoins acumulados
WCI_CON: wincoins consumidos
WCI_SAL: saldo de wincoins
ACT: si el saldo está activo o no
Habrá que activar la tabla W7_WIN_COI@dat_winmotor en la sección API para poder hacer las consultas y también la búsqueda WCI_BUS_WEB (Búsqueda wincoins - WEB).
CONSULTAR HISTÓRICO DE COMPENSACIONES DE WINCOINS
URL: http://IP_DOMINIO/NOMBRE_INSTANCIA/dat_winmotor_dat/v1/_query/WCI_COM_BUS_WEB?param[ENT]=6618¶m[FH_DSD]=101120231030¶m[FH_HST]=201120231230&api_key=1234
Opción para obtener las compensaciones (descuentos) aplicadas sobre las acumulaciones. Devolverá la siguiente información:
ID: código único de la compensación.
LIN: código único de la línea de documento en la que se aplica wincoins.
CAB: código único del documento en el que se aplica wincoins.
ENT: código único de la entidad consultada.
LIN_WCI: código de la línea de wincoin (acumulación) que estamos compensando.
IMP: importe a compensar.
Habrá que activar la tabla W7_WIN_COI_COM (Compensaciones) en la sección API para poder hacer las consultas y en la pestaña búsquedas activar la búsqueda W7_AP_ENTI/WCI_COM_BUS_WEB (Búsqueda wincoins / compensaciones WEB).
Información extra:
Para activar la API relativa a Wincoins habrá que ir al programa (Utilidades > WEB > API) y activar los siguientes procesos que indicamos a continuación para poder ejecutar esas acciones vía API:
WCI_ACT_WIN_COI@dat_winmotor
MOD_EMA_CLI_X_ID@W7_AP_COMU
Última actualización
