Esta guía proporciona detalles sobre la integración de tiendas físicas con WoowUp mediante una conexión directa con su base de datos SQL. 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 base de datos SQL de la marca y la plataforma WoowUp:

WoowUp consultará y 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.

Para establecer la conexión, el cliente debe proveer a WoowUp los siguientes datos:

Por su parte, WoowUp proporcionará al cliente:

WoowUp maneja los datos divididos en entidades. Es necesario desarrollar una vista por entidad. Los nombres de las columnas deben coincidir exactamente con los solicitados en esta documentación.

Antes de construir las vistas, se realiza una instancia de análisis de datos en conjunto entre el equipo de Integraciones de WoowUp y el equipo técnico del cliente. El objetivo es:

Las vistas deben nombrarse con el prefijo woowup_ seguido del nombre de la entidad, en singular y en español:

Todas las vistas deben exponer las columnas createtime y updatetime, que WoowUp utilizará para filtrar los registros nuevos o modificados en cada ciclo:

Ejemplo:

Integración de las tiendas donde los clientes pueden realizar compras. Incluye tiendas físicas, canales web equivalentes (como MercadoLibre) y tiendas de bancos cuando aplique.

Integración de datos de clientes, incluyendo identificadores (document y/o email), datos de contacto, datos geográficos, género, cumpleaños y preferencias de comunicación.

Se filtran los clientes actualizados y creados en las últimas 48 horas.

El campo document admite distintos tipos según el país. Debe enviarse siempre como string (sin puntos, guiones ni espacios, salvo que el formato del país lo requiera):

Integración de datos de ventas, incluyendo identificador del comprador, datos de la factura y productos comprados. Cada fila representa un producto distinto dentro de una misma factura.

Se filtran las ventas creadas en las últimas 24 horas.

createtime y updatetime deben estar siempre en horario UTC. Si la base de origen guarda los timestamps en horario local, la vista debe convertirlos a UTC.

Cuando el origen no dispone de horario (solo fecha), enviar la venta con la hora hardcodeada al último minuto del día (23:59:59). Esto es necesario para que WoowUp pueda asociar correctamente la venta a cualquier campaña o automatización que se haya ejecutado ese día: si se envía con hora 00:00:00, la venta queda antes de la ejecución de la campaña y no se atribuiría.

El invoice_number debe ser único a nivel cuenta. Cuando la numeración del comprobante se repite entre sucursales o tipos de comprobante, se recomienda armarlo concatenando:

{punto_de_venta}-{letra_comprobante}-{numero_comprobante}

Por ejemplo: 0001-A-00000123. La combinación invoice_number + branch_name siempre debe ser única.

El SKU de la vista de Ventas debe coincidir con el SKU del ecommerce, para poder cruzar correctamente la información de producto entre ambos orígenes.

Las notas de crédito se exponen en la misma vista de Ventas, con valores numéricos negativos en los siguientes campos:

El invoice_number de la nota de crédito debe ser distinto al de la venta original, siguiendo la misma regla de unicidad.

El campo discount debe reflejar el descuento total aplicado a la factura, incluyendo tanto descuentos a nivel factura (cupón general) como descuentos a nivel producto (2x1, promo por SKU). Esto es clave para que el Perfil 360 del cliente y las métricas de Analytics reflejen correctamente la rentabilidad real.

La vista de Pagos es opcional y resulta útil cuando una misma venta puede tener más de un medio de pago asociado. Permite vincular a un invoice_number múltiples registros de pago.

Se filtran los pagos de las ventas creadas en las últimas 24 horas.

​

El BIN corresponde a los primeros 6 dígitos del número de tarjeta. Permite identificar marca, banco emisor y tipo de tarjeta sin necesidad de enviar esos campos por separado.

La vista de Productos aplica únicamente cuando la información de catálogo proviene del ERP. Si el catálogo se obtiene desde la integración de ecommerce.

​

La vista de Categorías es fundamental para que WoowUp pueda reconstruir la jerarquía del árbol de categorías. Aplica únicamente si la vista de Productos también se configura.

WoowUp no recibe la jerarquía armada: la construye internamente siguiendo los IDs y sus relaciones:

De esta manera el producto queda asociado a Accesorios > Accesorios Mujer > Billeteras Mujer.
​

Antes de construir las vistas se realiza una reunión técnica entre el equipo del cliente y el de Integraciones de WoowUp:

WoowUp ejecuta diariamente las consultas a las vistas configuradas, en el horario pactado con el cliente (por defecto, medianoche). En cada ciclo:

Durante el onboarding se realiza una carga inicial de hasta 2 años de datos históricos, para poblar la base de WoowUp con el comportamiento histórico de los clientes.

El procesamiento histórico se realiza durante el sprint pactado en la "Reunión Técnica de Tiendas Físicas". Una vez finalizado, será necesaria una validación de los datos por parte del cliente.
​

En WoowUp, ir a Segmentos y, sin aplicar filtros, hacer clic en el símbolo #. Puede haber más clientes en WoowUp que en la base original, porque WoowUp crea automáticamente un cliente cuando detecta una venta con un document/email no presente en la vista de Clientes.

Ir a Analytics > Listado de Facturas. Filtrar por fechas y tiendas, asegurándose de excluir la tienda de ecommerce para comparar contra los datos del ERP/POS.

Acceder a Configuración > Tiendas (menú lateral) para ver las tiendas procesadas y editarlas si fuese necesario.

Esta sección describe cómo detectar y resolver problemas en el procesamiento diario de los datos vía SQL.

Hay dos vías por las que podés enterarte de un problema en la integración. Lo ideal es tener las tres activas para no depender de una sola.

WoowUp puede avisarte por email cuando deja de recibir datos. Para activarlas, ir a Configuración > Notificaciones y configurar al menos las siguientes alertas:

Estas reglas disparan un email cuando WoowUp detecta que dejaron de llegar datos, lo cual suele ser el primer síntoma de que la conexión a la base se rompió o las vistas dejaron de devolver registros.

WoowUp solo puede avisarte de lo que recibe. Si la base del cliente queda inaccesible o las vistas devuelven datos incompletos, WoowUp se entera tarde (cuando ya pasaron varios días sin información). Por eso recomendamos que el cliente configure sus propias alertas para:

Cuando WoowUp deja de procesar datos, la causa casi siempre cae en una de estas cinco categorías. Recorrelas en este orden:

Conectarse a la base con el mismo usuario configurado para WoowUp y ejecutar una consulta simple (por ejemplo, SELECT 1). Si la base no responde o el usuario fue bloqueado, el problema está antes de las vistas.

Si la base responde pero WoowUp no logra conectarse, validar:

Conectarse con el usuario de WoowUp y ejecutar SELECT * FROM woowup_tiendas LIMIT 1 (y lo mismo para clientes, ventas y las opcionales que apliquen). Si alguna vista no existe o el usuario no tiene permisos de SELECT sobre ella, el ciclo va a fallar. Esto suele pasar después de migraciones, refactors o cambios de esquema del lado del cliente.

Ejecutar la misma consulta filtrada por las últimas 24 horas:

Si el COUNT da 0, hay dos opciones posibles: realmente no hubo movimiento (feriado, caída del POS) o el filtro de createtime/updatetime quedó mal y no está devolviendo lo que debería. Validar contra el ERP del cliente si efectivamente hubo ventas ese día.

Ejecutar las consultas manualmente y medir cuánto tardan. Si alguna vista tarda más del tiempo de respuesta esperado, WoowUp aborta la consulta por timeout y el ciclo se marca como fallido. Las causas más frecuentes:

Si la falla se extendió más allá de las 24 horas, contactar a soporte para coordinar una resincronización manual del período afectado.

Si después de recorrer los cinco puntos anteriores el problema sigue, escribir a [email protected] incluyendo:

Si la base del cliente no está disponible cuando WoowUp ejecuta el ciclo:

createtime y updatetime deben estar en UTC en todas las vistas. Cuando la fuente no tiene hora (solo fecha), enviar 23:59:59 UTC en el último minuto del día, para que la venta quede correctamente asociada a campañas que se hayan ejecutado en el día.

Si el cliente modifica las columnas de una vista (renombra, agrega o elimina campos), debe avisar al equipo de Integraciones de WoowUp antes de aplicar el cambio en producción. Cambios no coordinados pueden romper el ciclo de sincronización.

​