Ir al contenido principal

Integración con VTEX

Integración con VTEX

A
Escrito por Axel Candia
Actualizado hace más de una semana

1. Crear un rol con los permisos necesarios

El primer paso es crear un rol con los permisos adecuados para que Moova pueda operar correctamente dentro de VTEX.

  1. Ingresá a Configuración de la cuenta > Roles de usuario.

  2. Creá un nuevo rol y asegurate de incluir los siguientes permisos:

    • OMS:

      • View order

      • Feed v3 and Hook Admin

      • Notify Order

      • View Order

      • Change Order

    • Logistics: permisos completos

    • Order Authorization Admin: permisos completos

2. Obtener tu appKey y appToken de VTEX

Solo el usuario maestro de la tienda tiene permisos para generar estas credenciales.

  1. El usuario maestro es el que figura en la pestaña Contacto, dentro de
    ​Gestión de cuentas > Cuentas.

  2. En la sección de Seguridad, vas a encontrar el botón para generar el
    ​Access Key y Secret.

  3. Una vez generados, guardalos en un lugar seguro. Los vas a necesitar más adelante.

3. Conectar tu cuenta VTEX desde Moova

  1. Ingresá a https://dashboard.moova.io/company/integrations
    o desde el Dashboard seguí la ruta:
    ​Dashboard > Área de empresa > EMPEZAR INTEGRACIÓN

  1. Completá los campos con la siguiente información:

    • VTEX KEY: la appKey obtenida en el paso 2.

    • VTEX TOKEN: la appToken del paso 2.

    • HOST: el dominio de tu tienda, con la estructura <sitio>.myvtex.com.

  2. En el campo SET TO READY, podés decidir en qué estado de VTEX se marcará el envío como Ready (listo para ser retirado).

    • Por defecto, todos los pedidos se crean en Moova en estado DRAFT (recibidos) cuando en VTEX están en estado Listo para preparar.

    • Que un pedido esté en DRAFT no significa que esté listo para retiro.

    • Podés ajustar este comportamiento seleccionando otro estado o cambiándolo manualmente desde el Dashboard.

4. Configurar la estrategia de envío en VTEX

  1. En VTEX, accedé a Estrategias de envío.

  2. Podés crear una nueva o usar una ya existente para integrarla con Moova.

  1. Dentro de la estrategia, copiá el ID del envío. Lo vas a necesitar más adelante para configurarlo en Moova.

  2. Completá el resto de los campos según tus necesidades.
    ​
    ​

Configurar el muelle

  1. Dentro de la misma pestaña, hacé clic en Muelle.

  2. Editá el muelle correspondiente.

  3. Asegurate de que:

    • La política de envío figure dentro del muelle.

    • El campo de dirección esté correctamente completado.

IMPORTANTE: si la dirección no está completa, el envío no podrá ser creado automáticamente en Moova.

5. Configurar tipos de envío en Moova

  1. Volvé al Dashboard de Moova.

  2. En la sección Tipos de envío, agregá uno nuevo.

  3. En el campo ID de VTEX, pegá el ID de la estrategia que copiaste en el paso anterior.

  4. Seleccioná el tipo de envío que querés asociar (por ejemplo, estándar, express, same-day, etc.).

6. Flujo de pedidos

Así funcionará la integración una vez activada:

  1. El cliente verá Moova como opción de envío al finalizar la compra.
    ​

  2. Si elige Moova, el pedido se creará en Moova en estado DRAFT cuando en VTEX esté en Listo para preparar.

  3. Al refrescar la página, VTEX mostrará:

    • Número de seguimiento de Moova.

    • Link a la etiqueta de envío.
      ​
      ​


      ​

  4. Cuando el pedido se facture y termine el flujo de VTEX, Moova lo marcará como READY (listo para ser retirado).

7. Verificación y recomendaciones finales

  • Verificá que el rol de permisos tenga todos los accesos indicados.

  • Confirmá que los campos de dirección estén completos en el muelle.

  • Realizá un pedido de prueba para asegurarte de que el flujo funciona correctamente antes de ponerlo en producción.

  • Si necesitás asistencia, contactá al equipo de soporte de Moova.

¿Ha quedado contestada tu pregunta?