¿Cómo leer esta guía?
Esta documentación está organizada en tres bloques según a quién le habla cada parte:
🟢 Guía rápida — Los pasos operativos para activar la integración.
🔵 Para el analista de Marketing — Qué datos vas a ver en WoowUp una vez sincronizadas las ventas y con qué filtros usarlos en Segmentos, campañas y automatizaciones.
⚙️ Para el equipo técnico — El mapeo campo por campo entre Tiendastic y WoowUp, con las transformaciones aplicadas.
🟢 Guía rápida
Seguí estos dos pasos para comenzar la integración.
Paso 1: Obtené tu Token de Tiendastic
Para conectar WoowUp con Tiendastic, necesitás un token de acceso. Este token te permitirá a WoowUp extraer automáticamente tus ventas web.
Seguí estos pasos:
Ingresá a tu panel de Tiendastic
Andá a Sistema → Configuración → API/Integraciones
Generá un nuevo token
Copiá el token completo (empezá con 'eyJ...')
Compartilo con el equipo de integraciones de WoowUp ([email protected])
Paso 2: Compartí la información con el equipo de WoowUp
Comunicate con el equipo de integraciones de WoowUp ([email protected]) y compartile la siguiente información:
Información a compartir:
1. Frecuencia de carga
Cada cuánto tiempo quieren que se sincronicen las ventas (recomendado: cada 3 horas)
2. Tiendas a cargar
Cuál es la tienda en WoowUp donde van a llegar las ventas web (ej: 98491 - ecommerce)
✅ Con esta información, el equipo de WoowUp configurará la integración.
Nota Importante: Notas de Crédito del ERP
Las notas de crédito (NC) siguen siendo sincronizadas desde tu ERP (otra fuente de datos).
🔵 Para el analista de Marketing
Esta sección te muestra qué datos vas a tener disponibles en WoowUp una vez que las ventas empiecen a sincronizarse, y con qué filtros del segmentador podés trabajarlos.
💡 Consejo: todos los filtros mencionados están en Segmentos > Nuevo segmento. Podés combinar varios para armar audiencias específicas.
Datos del cliente
Cada vez que llega una venta desde Tiendastic, WoowUp crea o actualiza automáticamente el contacto del cliente con la información que trae la orden. No hace falta enviar los clientes por separado.
Dato del cliente / venta (Filtro en WoowUp) | Para qué te sirve |
Identificar al cliente y enviar campañas de email marketing. | |
Género | Segmentar campañas por género (WoowUp lo infiere del nombre). |
Teléfono | Habilitar comunicaciones por SMS y WhatsApp. |
Documento | Identificar unívocamente al cliente y evitar duplicados. |
Ciudad | Segmentar por ubicación geográfica. |
Estado/Provincia | Segmentar por región. |
Código Postal | Segmentaciones muy granulares por zona. |
Datos de la venta
Cada orden de Tiendastic se registra como una venta en WoowUp con estos datos:
Dato del cliente / venta (Filtro en WoowUp) | Para qué te sirve |
Nro de Factura | Buscar una venta puntual o filtrar por rangos de numeración. |
Fecha de venta / Fecha de última compra | Segmentar por período (ej: compradores de la última semana). |
Tienda / Canal | Todas las ventas Tiendastic caen en la tienda web configurada. Sirve para separar ecommerce de tiendas físicas. |
Canal | Filtrar solo compras ecommerce con Canal = web. |
Monto / Monto total | Segmentar por rango de ticket (ej: compradores con ticket > $50.000). |
Porcentaje de descuento / Uso de descuento | Identificar clientes que compran solo con promoción vs los que pagan precio lleno. |
Uso de envío / Porcentaje de envío | Ver quiénes compran con envío y qué porcentaje del ticket representa. |
Productos comprados
Cada producto de la orden queda asociado al cliente para poder segmentar por lo que compró:
Dato del cliente / venta (Filtro en WoowUp) | Para qué te sirve |
SKU | Segmentar clientes que compraron un producto puntual. |
Producto comprado | Filtrar por nombre cuando no recordás el SKU. |
Cantidad de productos | Segmentar por volumen (ej: compradores de más de 3 unidades). |
Precio promedio por producto | Segmentar por ticket promedio por unidad. |
Marca | Segmentar por marca comprada (ej: clientes de una marca específica del catálogo). |
Medios de pago
Tiendastic informa cómo pagó el cliente, lo que te permite segmentar por medio de pago:
Dato del cliente / venta (Filtro en WoowUp) | Para qué te sirve |
Metodo de pago (crédito, MercadoPago, efectivo, etc.) | Segmentar por comportamiento de pago (ej: solo clientes de MercadoPago para campañas con cashback). |
Cuotas | Identificar quiénes financian sus compras (ej: pagadores en 6+ cuotas). |
⚙️ Para el equipo técnico
Detalle del mapeo entre los campos de la API de Tiendastic y los campos de la API de WoowUp, con las transformaciones aplicadas por la integración.
Sobre el origen de los datos: los datos del cliente viajan embebidos en cada orden (no hay endpoint de clientes por separado). Cada vez que se carga una orden, WoowUp crea o actualiza el cliente. El origen es customer + billing de cada orden.
Clientes
Campo origen Tiendastic | Campo WoowUp | Notas / Transformación |
customer.email | Identificador principal del cliente. | |
customer.name | first_name | Se splitea customer.name por espacio; primera palabra. |
customer.name | last_name | Se splitea customer.name por espacio; resto. |
customer.name | gender | Inferido del nombre. La API de Tiendastic no envía género. |
customer.phone | telephone | Se normaliza (sin espacios ni guiones). |
billing.cuit_cuil (o customer.id si falta) | document | CUIT/DNI. Si la orden no tiene billing, se usa el id interno de Tiendastic como fallback. |
billing.street_name + billing.street_number | street | Se concatenan. Si no hay billing, se toma la primera dirección de customer.addresses. |
billing.city | city | Solo disponible si la orden tiene billing. |
billing.province_name | state | Solo disponible si la orden tiene billing. |
billing.zip_code | postcode | Solo disponible si la orden tiene billing. |
Habilitaciones de comunicación
mailing_enabled = enabled si el cliente tiene email.
sms_enabled = enabled si el cliente tiene teléfono.
whatsapp_enabled = enabled si el cliente tiene teléfono.
Órdenes
Datos generales de la orden
Campo origen Tiendastic | Campo WoowUp | Notas / Transformación |
summary.reference | invoice_number | Número de factura, único por venta. |
summary.created_at | createtime | Fecha y hora de creación de la orden. |
summary.created_at | approvedtime | Se usa el mismo valor que createtime. |
(config) branch_name | branch_name | Fijo, se define durante el setup (ej: 98491). |
(fijo) | channel | Siempre 'web' para ventas Tiendastic. |
billing.cuit_cuil / customer.id | document | Mismo fallback que en Clientes. |
customer.email | Identificador del cliente comprador. | |
payment.total × multiplicador | points | Solo para Farmafull. El multiplicador se configura en el setup. |
Precios
Campo origen Tiendastic | Campo WoowUp | Notas / Transformación |
payment.total | total | Total de la factura. |
payment.sub_total_products | gross | Subtotal sin impuestos, sin envíos ni descuentos. |
payment.total_discounts | discount | Descuento total aplicado. |
payment.total_taxes | tax | Impuestos. |
payment.total_shipping | shipping | Costo de envío. No suma al total. |
Ítems (productos de la orden)
Campo origen Tiendastic | Campo WoowUp | Notas / Transformación |
items[].sku | sku | Debe coincidir con el SKU del ecommerce. |
items[].name | product_name | Nombre del producto. |
items[].quantity | quantity | Cantidad de unidades. |
items[].price | unit_price | Precio unitario. Si es 0 (ítem gratis de promo 2×1), se carga como 0.01. |
items[].brand_name | brand | Marca del producto. |
Pago
Campo origen Tiendastic | Campo WoowUp | Notas / Transformación |
payment.total | total | Total pagado por este medio. |
payment.type_name | payment_type | Ver mapeo abajo. |
payment.payment_source_name | brand | Marca de la tarjeta o proveedor. |
payment.payment_source_installments | installments | Cantidad de cuotas. |
¿Algo no funciona?
No aparecen ventas en WoowUp
Si activaste la integración pero no ves ventas nuevas en WoowUp, revisá en este orden:
Esperá 1 o 2 horas desde que se generó la venta
El ciclo de sincronización corre según la frecuencia configurada durante el setup (por defecto, cada 3 horas). Una venta recién generada puede tardar en aparecer si el próximo ciclo aún no se ejecutó.
Confirmá que la venta esté en Tiendastic
Ingresá al panel de Tiendastic y verificá que la venta efectivamente se generó y quedó registrada en el período esperado. A veces la "falta de datos" es real (caída del ecommerce, día sin ventas, etc.).
Buscá la venta en WoowUp por su número de factura
En WoowUp, andá a Analytics > Listado de Facturas y buscá directamente por el número de factura de la venta que estás intentando ver.
Si aparece: revisá con qué tienda quedó asociada; puede estar cargándose en una tienda distinta a la esperada.
Si no aparece: pasá al punto 4.
Filtrá por la tienda destino esperada
En el mismo listado, filtrá por la tienda web que configuraste para Tiendastic y por el rango de fechas correspondiente. Si no aparecen ventas ahí pero sí las ves en Tiendastic, escribí al equipo de integraciones ([email protected]) con el número de factura de una venta que debería estar y no aparece. Ellos van a revisar el estado de la integración del lado de WoowUp.
Error de sincronización o token
El equipo de WoowUp monitorea la salud de la conexión de forma interna:
Si el token deja de funcionar (por vencimiento, regeneración o rotación de credenciales), el equipo de integraciones te va a contactar por email para pedirte un token nuevo.
Cuando eso pase, generá un nuevo token siguiendo el Paso 1 de esta guía y compartilo con [email protected].
Sigue sin funcionar
Escribinos a [email protected] incluyendo:
Nombre de la cuenta.
Fecha y hora en la que dejó de funcionar.
Descripción de lo que probaste hasta el momento.
Número de factura de alguna venta que debería estar y no aparece.