Esta guía proporciona detalles sobre la integración de tiendas físicas con WoowUp utilizando archivos CSV. Esto permite una experiencia de CRM omnicanal, integrando datos de manera diaria y eficiente.

A continuación, se presenta un diagrama que ilustra una conexión típica entre la marca y la plataforma WoowUp:

WoowUp procesará los datos una vez por día en un horario preestablecido o pactado con el cliente. Este procesamiento diario asegura que la información esté siempre actualizada y disponible para su análisis y uso en campañas de marketing.

WoowUp proporcionará los siguientes datos específicos para cada cliente para la conexión al servidor SFTP:

El puerto utilizado para la conexión es el predeterminado de SFTP (22).

De su parte, deberán proporcionar los siguientes datos:

Para autenticarte en el servidor SFTP mediante una clave SSH, sigue estos pasos:

El SFTP de WoowUp está estructurado en cinco carpetas principales, cada una con una función específica en el flujo de datos:

Los datos deben ser proporcionados en archivos CSV, con un archivo por cada entidad (Tiendas, Clientes y Ventas).

Codificación y Formato de Archivos:

Cada archivo CSV debe seguir una convención de nombres específica para asegurar la correcta identificación y procesamiento automático. Los nombres deben estar formados por el tipo de entidad, el nombre de la marca y la fecha de los datos. La estructura es la siguiente:

Donde:

Ejemplo:
​tiendas_tumarca_20240625.csv

clientes_tumarca_20240625.csv

ventas_tumarca_20240625.csv

WoowUp maneja los datos divididos en las siguientes entidades: Tiendas, Clientes y Ventas. Es necesario enviar un archivo para cada entidad. Los nombres de las columnas deben coincidir exactamente con los solicitados en esta documentación.

Cada entidad debe incluir campos obligatorios y opcionales, con la posibilidad de agregar campos adicionales específicos de la marca, conocidos como "atributos extendidos". A continuación se presentan ejemplos y campos necesarios:

Integración de tiendas donde los clientes pueden realizar compras, excluyendo depósitos de mercadería o la tienda eCommerce. Se pueden incluir canales web como MercadoLibre o tiendas de bancos.

Integración de datos completos de los clientes, incluyendo identificadores (document y/o email) y datos adicionales como geográficos, de género y de cumpleaños.

Se envían únicamente los clientes actualizados y creados en las últimas 24 horas.

Integración de datos de ventas, incluyendo identificador del comprador, datos de la venta y productos comprados. Cada línea representa un producto distinto.

Se envían las ventas creadas en las últimas 24 horas.

La entidad de pagos es opcional y resulta útil cuando se requiere integrar un gran número de ventas con más de un medio de pago. Permite asignar a un número de factura específico múltiples medios de pago.

Los archivos deben ser nombrados pagos_#marca_#fecha.csv.

Se envían los pagos de las ventas creadas en las últimas 24 horas.

Para asegurar una integración eficiente y precisa, se deben seguir las siguientes buenas prácticas:

WoowUp realiza un procesamiento de los datos de forma periódica en el horario especificado por el cliente, o a medianoche si no se especifica un horario. Durante este proceso, se procesan los archivos que deben contener datos de las últimas 24 horas. Este enfoque garantiza que los datos de las tiendas físicas, clientes y ventas se mantengan continuamente actualizados en la plataforma WoowUp, permitiendo a las empresas disponer de la información más reciente para sus estrategias de marketing y segmentación de audiencias.

Para integrar datos históricos de hasta dos años, se realizará una carga de estos datos en la carpeta Historical del SFTP. Los archivos requeridos deberán incluir "historical" en sus nombres para diferenciarlos de los datos regulares.

El procesamiento se realizará durante el sprint pactado en la “Reunión Técnica de Tiendas Físicas”. Una vez finalizada, será necesaria una validación de los datos por parte del cliente.

En caso de una demora en la entrega de los datos, se modificará el deadline del proyecto.

En WoowUp, ir a Segmentos y, sin aplicar ningún filtro, hacer clic en el símbolo de “#”. Puede haber más clientes que en su base de datos debido a la creación de clientes a partir de ventas.

Para validar la cantidad de ventas en WoowUp, ir a Analytics > Listado de Facturas. Establecer las fechas y tiendas a analizar, asegurándose de quitar la tienda de eCommerce.

Acceder a la configuración de la cuenta, sección Tiendas en el menú lateral, para visualizar y modificar las tiendas procesadas.

En caso de que encuentres una falta de datos, consulta este artículo: LINK

En caso de no procesar los datos, se enviará una notificación por email. Se recomienda validar los siguientes puntos:

En caso de que se identifique y corrija algún problema, puede volver a subir los archivos a la carpeta pending en el SFTP. Los archivos serán procesados de forma automática en el siguiente ciclo de procesamiento.

Si la falla persiste, contactar a [email protected].

Comenzar con la generación de archivos con columnas que coincidan exactamente con las especificadas en la documentación. Consulta los archivos de ejemplo para despejar dudas.

Se recomienda iniciar el desarrollo por la entidad más sencilla: Tiendas.

Documentar cada paso del proceso de integración para futuras referencias y para asegurar una comprensión clara del flujo de datos.

Implementar un sistema de monitoreo para asegurar que la integración se realice de manera correcta y optimizar el proceso en función de los resultados obtenidos.

Para asegurar una integración exitosa de los datos de las tiendas físicas con la plataforma WoowUp, se ha definido un timeline detallado con fechas aproximadas que guiará el proceso desde el inicio hasta la finalización del setup.