Qué permite esta integración:
-
Setup y sincronización manual o via API de tarifarios, con dos opciones:
Opción Tarifario Plano Único: Se utiliza un único tarifario plano en VTEX en una única política de envíos.
Opción Tarifario por transporte (Recomendado): Se crea una política de envíos por cada transporte que desees habilitar en VTEX.
Sincronización de órdenes con envíos Zipnova desde VTEX via Webhook.
Sincronización de estados VTEX ⇔ Zipnova en lo referente al envío. Subida de información de seguimiento.
Mapeo de Almacenes VTEX con Almacenes de Zipnova para sincronización de stock.
Requisitos:
La opción de tarifario plano único requiere que la cuenta de Zipnova tenga un acuerdo comercial específico de tarifas o estará deshabilitada por defecto.
Tener un ambiente VTEX y la autorización para generar tokens de acceso.
Los productos deben tener completos sus datos de peso y dimensiones en VTEX. En la configuración de la integración podrás definir la unidad de medida para el peso (gramos o kilogramos), ya que VTEX no se expresa en ninguna unidad específica.
Estar suscripto al plan Enterprise en Zipnova.
Opcional:
Tener un ambiente de testing VTEX para probar la configuración.
Configurar productos y SKUs en Zipnova para reducir posibilidades de inconvenientes por medidas/pesos incorrectos.
Si vendes colchones, deberás configurar los Modales de entrega de tus sku (Ver en la ayuda de Vtex) en VTEX para ponerles el Modal “Colchon”. Habilitar el modal, previamente en Inventario y envío > Configuración > Permitir categorías de productos.
Paso a paso para configurar la integración:
-
Generar credenciales.
Si el ambiente VTEX pertenece a un marketplace, solicita al marketplace las credenciales de integración de VTEX (detalladas más abajo).
Si la cuenta de VTEX no pertenece a un marketplace, deberás generar un token de acceso en VTEX para habilitar el acceso por API desde la web de VTEX sección Cuentas. Podrás seguir este artículo de ayuda de VTEX sobre cómo crear las credenciales.
-
Agregar las credenciales a Zipnova y conectar la tienda.
En Zipnova, Ir a Integraciones > Gestionar tiendas > Conectar nueva tienda (en el sector de VTEX) y completar los siguientes datos solicitados:
Nombre de la tienda
URL del ambiente VTEX
API Key
API Token
-
Configura tus mapeos de origenes y almacenes.
En la sección Origenes y Almacenes, define con qué origenes deben vincularse tus muelles de VTEX y los almacenes.
Cuando ingrese una venta de VTEX se creará el envío utilizando el origen vinculado al muelle de los productos de la orden.
Importante: Si tu venta tiene productos de distintos muelles/almacenes, se creará un único envío teniendo en cuenta solo uno de los muelles de la orden.
-
Creación de políticas de envío.
Accede a Configuración > Integraciones > Configurar junto a la tienda VTEX.
Para poder sincronizar las tarifas, se crearán políticas de envío en VTEX por cada transporte que desees habilitar.
Para habilitar un transporte y sincronizarlo a VTEX, haz clic en el botón de Crear nueva política de envío y selecciona todos los transportes que quieras habilitar.
Por cada transporte seleccionado, genera las tarifas desde el menú de tres puntos. Luego de este proceso, se enviarán a VTEX de forma directa.
Desde esta sección, también podrás descargar las tarifas para obtener una copia, eliminar la política de envío de VTEX, y establecer un modificador de precios.
Las políticas de envío de Zipnova no se agregan automáticamente a ninguno de tus muelles por lo que es necesario que asocies las políticas de envío manualmente desde la configuración de VTEX, yendo a Envío > Estrategia de envío > pestaña Muelles.

-
Sincronización de tarifas y sucursales
Por defecto, los tarifarios de transporte se actualizarán de forma automática y se enviarán continuamente a VTEX.
En caso de utilizar la sincronización manual de tarifas desde la configuración, deberás regenerar periódicamente las tarifas y actualizarlas en VTEX.
Para ello haz clic en el botón de opciones de cada transporte, y selecciona la opción Regenerar tarifas.
Configuración finalizada

Una vez que tu política de envío esté sincronizada y activa, se empezará a ofrecer a tus compradores. Cuando la elijan a la hora de comprar, se importará automáticamente la venta a Zipnova y se creará un envío para que lo puedas despachar.