Cómo vincular mi cuenta con VTEX
Integra Zipnova con tus cuentas de VTEX de forma rápida y sencilla.
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: 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 info de tracking
- Mapeo de Muelles VTEX con origenes de Zipnova
- Mapeo de Almacenes VTEX con Almacenes de Zipnova para sincronización de stock
Requisitos
- En caso de utilizar la opción Tarifario Plano Único, debes tener habilitado un tarifario plano con cobertura nacional en la cuenta Zipnova.
- 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 el setup
- 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.
Configuración
Paso 1: Crear credenciales
Generar un token de acceso en VTEX para habilitar el acceso por API desde la web de VTEX sección Cuentas. Fijate las instrucciones de VTEX sobre cómo crear las credenciales.
Paso 2: Agregarlas a Zipnova y conectar la tienda
En Zipnova, Ir a Integraciones > Gestionar tiendas > VTEX > Conectar nueva tienda y completar los datos pedidos:
- Nombre de la tienda
- URL del ambiente VTEX
- API Key
- API Token
Paso 3: 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.
Paso 4: Configuración general
En la sección de Tarifas y transportes encontrarás un botón de de Modificar opciones, que abrirá un cuadro con algunas opciones adicionales para tu integración.
Dentro de las opciones disponibles podrás indicar:
- Tipo de tarifario: Tarifario plano único (solo si tu cuenta lo admite) o Tarifario por transporte
- Modo de actualización: Manual o automático
- Plantilla para nombrar el método de envío
- Unidad de medida para el peso: el cual impacta a la hora de interpretar el peso cargado en tus productos, y para las tarifas que se suben a VTEX.
Paso 5: Creación de políticas de envío
Para poder sincronizar las tarifas, se crearán políticas de envío en VTEX.
Si utilizas la opción de tarifario plano único, se creará una sola política.
En caso de utilizar tarifarios de transporte, se creará una política 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. Una vez creado en Zipnova se creará en VTEX
Las políticas de envío de Zipnova no se agregan automáticamente a ninguno de tus muelles por lo que es necesario que las agregues manualmente desde la configuración de VTEX.
Paso 6: Sincronización de tarifas y sucursales
En caso de haber configurado la sincronización automática, la misma ocurrirá sin necesidad de realizar más acciones. Cada vez que haya un cambio en las tarifas se disparará automáticamente una actualización hacia VTEX.
En caso de utilizar la sincronización manual, 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 Generar tarifas.
La generación de tarifas ocurre en segundo plano y puede demorar algunos minutos. Cuando esté completada podrás subirlas a VTEX con la opción Subir tarifas a VTEX, o descargarte el Excel para subirlas manualmente.
Paso 7. Recibir ventas
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.