PROMO 7.3 - Guía Inicial de Integración
Introducción
Visión general
El presente documento tiene como objetivo proporcionar a nuestros clientes una guía inicial de integración de Promo.
Podrán encontrar aquí los diferentes tipos de integraciones que pueden existir entre los distintos puntos de ventas o sistemas externos con Promo.
¿Qué es Promo?
PROMO es una solución que permite separar el manejo de promociones de los distintos puntos de venta que gestione un cliente. Permite definir una amplia gama de promociones y es extensible sin la necesidad de realizar modificaciones en los puntos de venta.
Arquitectura de Integraciones - Promo
Componentes de Promo
Consola de administración central:
Se encarga de la creación y gestión de promociones y mapas, así como también de la administración de los distintos elementos de Fidelidad como ser cupones, tarjetas y clientes. Desde la consola de Promo podrán realizarse las configuraciones necesarias para que estos elementos operen en base a los requerimientos de cada negocio.
Motor de Promo:
Componente encargado de recibir el mapa de Promociones desde la consola de Promo central y evaluar las reglas de negocio a aplicar en base a los requerimientos que le lleguen desde el punto de venta.
Motor de Simulación Promo:
Este componente opera junto con la consola de Promociones y por medio de éste se podrán evaluar promociones y mapas desde la consola de Promo con fines de prueba y así verificar que las reglas de negocio definidas tienen el comportamiento esperado.
Motor de Cache de Promo:
El Motor de caché de Promociones tiene como objetivo generar información para los sitios de E-Commerce donde, para tener una navegación ágil, se desea poseer la información de Promociones asociadas a los diferentes productos.
Para esto Promo posee un proceso que evalúa las promociones y los productos asociados a la publicación en el E-Commerce. Dicha información es generada como mensajes en una cola RabbitMQ de la cual los sitios pueden tomarlos. (Para mas información ver PROMO 7.3 - Manual de Integración - Colas de Mensajes)
En base a este esquema, el E-Commerce podrá descargarse de la cola RabbitMQ los datos posteados por el motor de Promociones para así obtener para todos los ítems las promociones que aplican y mostrarlas al momento de la navegación.
Aspectos Funcionales de Promo
Como vimos en la sección anterior, Promo cuenta con distintos componentes que tienen una finalidad bien definida en base a la función que cumplen, estos son:
Administración centralizada en la Consola de Promociones
Desde la consola de Promo se podrán generar y administrar las distintas reglas de negocio (promociones) así como también gestionar cada componente del producto.
Es una herramienta WEB para la administración de promociones, cupones y tarjetas de fidelidad, así como también alarmas, segmentos. Es el componente encargado de generar el archivo de definición de reglas de negocio (mapa de promociones) que será utilizado por el motor de promociones para la evaluación de éstas. Es el responsable de gestionar la emisión y redención de cupones de manera centralizada, encargándose de la gestión de las tarjetas de fidelidad, pudiendo crearlas, asociarlas a clientes, visualizar su historial y gestionar saldos.
Para mas información ver: PROMO 7.3 - Manual de Usuario y PROMO 7.3- Manual de Instalación
Evaluacion de reglas de negocio en el Motor de Promociones
El motor de PROMO encargado de resolver e informar las promociones participantes en un Ticket según las definiciones (promociones) que se hayan generado a través de la consola. También es el nexo entre los puntos de ventas y la consola de administración central para todo lo referente a la gestión de elementos de Loyalty y transacciones realizadas en los puntos de venta.
Para mas información ver: PROMO 7.3- Manual de Integración - Motor
Comunicación con Sistemas Externos vía Servicios y Colas de mensajes
Promo expone servicios que pueden ser consultados desde sistemas externos con el fin de obtener información presente en la base de datos de Promo o bien agregar, modificar o eliminar datos allí presentes.
Para la consulta de datos a demanda Promo expone sus servicios vía Rest, por medio del cual un sistema externo podrá consultar promociones, transacciones, clientes, cupones, tarjetas entre otros. También vía servicios Rest podrá cargarse en Promo clientes o tarjetas entre otros.
Promo también provee a sus clientes las colas de mensajes (RabbitMQ) por medio de las cuales se podrán postear datos de promociones, estado de limites, movimientos de tarjetas o bien cargar catálogos.
Para mas información ver: PROMO 7.3 - Manual de Integración - Servicios y PROMO 7.3 - Manual de Integración - Colas de Mensajes
Integrarse con Promo
En esta sección detallaremos los distintos tipos de integraciones que podemos implementar entre Promo y las aplicaciones de venta o cualquier otro sistema que quiera comunicarse con Promo para consultar información o enviar datos.
Las aplicaciones de ventas pueden operar en puestos físicos (puestos de ventas en los comercios) o bien en puestos virtuales (E-Comerce o M-Commerce), y serán estos puntos de ventas los que se integraran con Promo para gestionar y aplicar sus reglas de negocio (promociones).
Comunicación con el Motor de Promociones
El motor de promociones es el componente de PROMO encargado de recibir requerimientos desde el punto de venta y luego responderlos. Esta interacción se realizará a través de una serie de mensajes con formato XML que siguen un Protocolo de Comunicación definido. En este sentido el motor de promociones puede funcionar tanto como servidor TCP/IP o bien como servidor REST, dependiendo de las necesidades, preferencias y requerimientos tecnológicos que posea el punto de venta.
Comunicación vía TCP (pustos Físicos - E-Commerce)
Comunicaión vía REST (puestos Físicos - E-Commerce)
Integración con la Mensajería PDV - Motor de Promo
Para la integración de los puntos de ventas tanto físicos como virtuales deberá implementarse la mensajería XML necesaria para la correcta comunicación PDV - MOTOR.
Esta comunicación cuenta con mensajes de "request" que son los enviados desde el punto de venta al motor para evaluar promociones o consultar elementos de Fidelidad y con un "response" que son las respuestas del motor de Promociones al punto de venta con el resultado de la evaluación o consulta solicitada.
El Motor de Promociones es capaz de manejar múltiples sesiones, lo cual le permite atender diversas transacciones paralelamente, para así poder gestionar de forma simultanea múltiples consultas de distintos puntos de venta.
En el Manual de Integración 7.3 - Motor podremos consultar las secciones para el correcto manejo de la mensajería con el motor así como también las estructuras de los "request" y "response".
Integración con Fidelidad Promo
Promo posee la gestión de sus propios elementos de Fidelidad, como ser cupones, tarjetas, clientes, permitiendo a quien se integre con Promo contar con una administración centralizada para sus campañas de fidelización de clientes.
Podrán administrarse cupones de manera centralizada, registrando las transacciones que los emiten o redimen y llevando estadísticas (KPI) de las transacciones registradas y estad de los cupones. Pudiendo tener estos saldos asociados o estar asignados a un cliente.
La administración de tarjetas de fidelidad centralizada permite gestionar los distintos perfiles de tarjeta, como ser Monederos, Gift-Card o Puntos Loyalty, además de facilitar la gestión y visualización de los movimientos y asignaciones de cada una de estas tarjetas desde la consola de Promo.
La gestión de clientes desde Promo permitirá la visualización de los cupones y tarjetas que se tengan asociados a estos, facilitando la gestión y seguimientos de sus movimientos.
Para mas información sobre la integración con el modulo de fidelidad ver el Manual de PROMO 7.3 - Manual de Integración - Motor
Promo provee servicios por los cuales podrán sistemas externos podrán solicitar información de elementos de los fidelidad, así como también gestionarlos, generando nuevas tarjetas de fidelidad consumiendo y cargando saldos, gestionar clientes y sus elementos de fidelidad. Esto podrá realizarse por medio de los Servicios Rets y las Colas de Mensajes.
Para mas información sobre la integración de sistemas externos y automatización de interfaces consultar manual de PROMO 7.3 - Manual de Integración - Servicios y manual de Promo 7.3 - Manual de integración - Colas de mensajes
Comunicación con Sistemas Externos
Servicios Rest
Como mencionamos anteriormente, Promo expone distintos servicios para que sistemas externos puedan consultar o enviar información a Promo.
Para tal fin, quien desee integrarse con los servicios Promo deberá primero realizar un Proceso de autenticación OAuth2.
Podrán consultarse desde sistemas externos datos de clientes, tarjetas, cupones, mapas y promociones, así como también podrán realizarse mantenimiento de datos como ser por ejemplo los utilizados para la carga de Promociones, (marcas, proveedores, códigos SKU, etc.), administración de datos de clientes en Promo, importación de segmentos de clientes, gestión de tarjetas de fidelidad o carga masiva de promociones a la consola de Promo.
Para mas información sobre la integración de sistemas externos vía rest para la gestión de datos en Promo ver PROMO 7.3 - Manual de Integración - Servicios
Colas de mensajes
Las colas de mensajes permiten a diferentes sistemas comunicarse y procesar operaciones de forma asíncrona. Una cola de mensajes ofrece un buffer ligero que almacena temporalmente los mensajes, y puntos de enlace que permiten a los sistemas intervinientes conectarse a la cola para enviar y recibir mensajes.
Promo ha incorporado de forma estándar el uso de las colas mencionadas.
En la siguiente imagen se puede observar un diagrama de arquitectura simple:
Promo como consumidor
Promo posee la posibilidad de recibir datos desde sistemas externos vía Colas Rabbit con el fin de alimentar su base y operar en base a los datos que gestione cada negocio.
Los datos que podrán cargarse por esta vía serán por ejemplo, los datos referentes a la gestión de ítems, como ser por ejemplo marca, categorías, SKU, datos de clientes o datos referentes a la ubicación geográfica de las tiendas (ciudad, país, etc.) o bien los canales desde los cuales se realicen las operaciones (Ejemplo, punto de venta o E-Commerce)
Promo como productor
Promo permite el envío de información mediante colas RabbitMQ (función productor). Por defecto esta información es enviada cada 30 minutos (proceso background) al servidor de colas.
Los datos que podrán ser configurados para el envío a sistemas externos que busquen explotar los datos de Promo en sus sistemas son por ejemplo el historial de movimientos de tarjetas de fidelidad, estado de consola y motores conectados a la consola de Promo, cache de Promociones y estado de limites de las promociones.
Para mas información sobre la integración de sistemas externos vía colas de mensajes para la gestión de datos en Promo ver Promo 7.3 - Manual de integración - Colas de mensajes
Ejemplos de Función de Convivencia Opciones
Desde este apartado podrá ver ejemplos del uso de Funciones de Convivencia
Circuito para uso de Balances
Desde este apartado podrá ver el circuito completo para utilizar Balances.
Circuito para uso de Programas de Objetivos
Desde este apartado podrá ver el circuito completo para utilizar el Programa de Objetivos.
Circuito para uso de Eventos
Desde este apartado podrá ver el circuito completo para utilizar eventos
Circuito para uso de Promociones por Descuentos por Convenios
Desde este apartado podrá ver el circuito para uso de Promociones con descuento por convenios
Ejemplo de Ignorar Pagos con Puntos
Desde este apartado podrá ver un ejemplo de Ignorar Pago con Puntos