Integración con Vtex
Cómo conectar una tienda Vtex.
Introducción
Te presentamos la integración con Vtex, una solución que brinda una experiencia sin fricciones al cargar automáticamente los envíos directamente en nuestra plataforma. Esta poderosa funcionalidad simplifica el proceso logístico al permitir la carga automática de envíos desde Vtex a nuestro sistema, eliminando tareas manuales y asegurando una gestión eficiente de los pedidos. Para aprovechar al máximo esta integración, es esencial seguir los pasos detallados en la documentación a continuación.
Conexión de Tienda
La conexión de la tienda se inicia desde la tienda de Vtex, y durante este proceso el vendedor deberá generar las credenciales de acceso para ser utilizadas por Jipink. Al conectar la tienda, se agregará el método de envío de Jipink en el checkout y se cargarán automáticamente los envíos en la plataforma de Jipink cuando corresponda.
El envío se carga automáticamente cuando la orden pasa al estado "Ready for Handling".
1. Credenciales
El primer paso es generar las credenciales de acceso, App Key y App Token, para que Jipink tenga acceso a la tienda. Durante este proceso, asignarás los permisos necesarios a estas credenciales, lo que permitirá a Jipink crear políticas de envío, cargar códigos postales y tarifas aplicables y obtener algunos datos básicos de tu cuenta.
Los permisos necesarios son:
- OMS Full Access
- Logistics Full Access
- License Manager Full Access
¿Cómo generar las credenciales?
Generar credenciales de acceso
Seguir los pasos detallados en el tutorial Claves de aplicación de Vtex.
2. Instalación
Una vez generada las credenciales, el próximo paso implica conectar la tienda. Utilizando el App Key y App Token generados en el paso anterior, Jipink podrá crear las políticas de envío necesarias dentro de tu tienda, como así también cargar las tarifas para que se muestre correctamente el método de envío en el checkout.
¿Cómo conectar la tienda?
Conectar tienda de Vtex
- Ir a la sección Tiendas.
- Hacer clic en el botón Conectar Tienda, en el sector superior-derecho.
- Seleccionar la opción Vtex.
- Ingresar la URL de tu tienda.
- Ingresar el App Key de tus credenciales.
- Ingresar el App Token de tus credenciales.
- Hacer clic en el botón Continuar.
- Esperar unos segundos mientras finaliza el proceso de integración.
¡Listo! Tu tienda ya está conectada.
3. Configuración
Una vez conectada la tienda, deberás agregar a la política de Jipink a un muelle para que esta sea visible en el checkout.
¿Cómo configurar el muelle?
Configurar muelle de carga
Seguir los pasos detallados en el tutorial Gestionar muelle de Vtex.
4. ¡Listo!
Tu tienda ya está conectada y Jipink debería ser visible en el checkout.
Peso y Volumetría
Es fundamental contar con medidas y pesos precisos en tu catálogo de productos. Estos datos son esenciales para garantizar una entrega eficiente y sin contratiempos. Una información precisa permite planificar de manera óptima las rutas y distribución de la carga, evitando demoras y reduciendo los costos adicionales asociados a errores logísticos. Además, al contar con medidas y pesos exactos, se pueden calcular con precisión los costos de envío, ofreciendo transparencia y confianza.
Asegurate que tu catálogo esté correctamente cargado según las reglas de Vtex:
- Peso: debe estar cargado en kilogramos
- Ancho: debe estar cargado en centímetros
- Alto: debe estar cargado en centímetros
- Largo: debe estar cargado en centímetros
Podés encontrar más información en la documentación de Vtex, haciendo click acá.
Política de Envío
Al integrar tu tienda, se generan automáticamente las políticas de envío esenciales para poder operar sin problemas. No obstante, en determinadas situaciones, es posible que desees crear tu propia política de envío, especialmente si deseas configurar un Acuerdo de Nivel de Servicio (SLA) diferente al predeterminado que ofrecemos. En estos casos, es necesario que tu nueva política de envío tenga el prefijo JIPINK_
. Por ejemplo, si planeas crear una política de envío específica para utilizar en otro canal de ventas, como BAPRO (Banco Provincia), el ID de esta nueva política de envío podría ser JIPINK_BAPRO
. De esta manera, todos los envíos creados bajo dicha política se cargarán automáticamente en nuestra plataforma.
Solución de Problemas
¿Por qué no se muestra el método de envío?
Si ya integraste tu tienda de Vtex, y el método de envío de Jipink no se muestra, se puede deber a diversas razones, como por ejemplo, que el método aún no fue agregado al muelle, que los tamaños de tus paquetes están configurados erróneamente, etc.
Utilizá el Simulador de Envío de Vtex para verificar la configuración.
Para identificar la causa, te recomendamos utilizar el simulador de envíos de Vtex, el cual podés cotizar un envío por código postal y visualizar todos los métodos de envío disponibles, tal como lo vería un cliente en tu tienda, como así también, todos los métodos de envíos que no se muestran debido a que no se cumple alguna regla o política de tu configuración. Esto último es súper útil para que puedas encontrar el problema y así poder solucionarlo.