Vtex Ultima actualización: 2024-12-24

  • La integración de Urbano Express con Vtex nos permitirá gestionar los envíos, imprimir las etiquetas, seguimientos de las ordenes, ademas de calcular los costos de envió en la tienda. Los clientes van a poder elegir enviar tus productos con Urbano Express.

Requisitos

Se deberá gestionar lo siguiente.

Requerimientos:
  • Ser cliente de Urbano Express
  • Una cuenta usuario como master en Vtex
  • Configurar en portal clientes
Datos Logísticos:
  • Se requiere que los productos tengan las medidas correspondientes, ademas del peso.
  • Se requiere la dirección y el CPA para los datos logísticos.

Conectar Cuenta

  • Crear el appKEY y appTOKEN

    La integración VTEX necesita autenticarse a través de un appKey y un appToken..

    Para crear las claves, por favor siga estos pasos:

    • Ingrese al módulo de License Manager en ACCOUNT SETTINGS > Account management y haga click en Account


    • Elija su cuenta


    • En la sección de Seguridad, haga click en "Generar access key y secret"


Integracion

Pasos:
  • Instalaremos la aplicacion
    Instalar Vtex en Integrate

    Al no estar logueado en Integrate deberemos ingresar el shipper y passwoord facilitado por Urbano


  • Registrar

    Completar los siguientes campos

    • Nombre de la tienda
    • API AppKey provista por VTEX
    • API AppToken provista por VTEX

  • En las lista de aplicaciones veremos la integracion con Vtex

Aplicación


  • Login de acceso.

    Ingresar a la Url para iniciar sesión https://integrate.urbano.com.ar/platform


  • Órdenes Pendientes:
    En la solapa de ordenes pendientes veremos Todas las ordenes en las que fué seleccionado
    el carrier de Urbano en su Tienda, pero que aún no fueron impactadas en Urbano.

    En resumen: las ordenes pendientes son Ordenes que Urbano puede ver, pero que aún no tenemos en nuestro sistema.


  • Filtro por Rango de Fechas:

    IMPORTANTE: En caso de No encontrar una órden, verificar que el filtro por rango de fechas sea correcto.


    Haciendo Click en las fechas:

    Se desplegará este calendario para poder elegir las fechas Desde y Hasta para filtrar:

  • Impacto de Órdenes:
    Existen 2 formas de impactar las ordenes en Urbano desde Integrate:

    - De forma individual: por medio del boton "Enviar Pedido".


    - De forma masiva: (o en Lote), seleccionando las ordenes a enviar y eligiendo en "Acciones por Lote" la opcion "Enviar Pedidos a Urbano Express Argentina", y luego el botón "Aplicar".


    En resumen: Una vez Impactadas las ordenes en nuestro sistema, se podrán imprimir las etiquetas, ver el seguimiento del pedido y se dará inicio al proceso Logistico.



  • Órdenes Procesadas:
    En la solapa de ordenes procesadas veremos todas las ordenes que ya Impactaron correctamente en nuestro Sistema.


    IMPORTANTE:
    Recuerde que Urbano sólo dejará imprimir las etiquetas cuando el pedido se encuentre en estado PI (Pedido Ingresado),
    una vez que el Pedido fisico llegue a nuestros depósitos y cambie a estado IF (Ingreso Físico) el sistema,
    por un tema de seguridad y para evitar errores, no dejará imprimir las etiquetas mostrandolas en blanco.


  • Impresión de Etiquetas:
    Existen 2 formas de imprimir las etiquetas en Urbano desde Integrate:

    - De forma individual: en la columna "Etiqueta" podrá elegir el formato deseado,
    y enviarla a la impresora por medio del boton:

    - De forma masiva: (o en Lote), seleccionando las ordenes a Imprimir y eligiendo en "Acciones por Lote" la opcion
    "Imprimir Etiquetas", y luego el botón "Aplicar".


  • Filtro por Etiqueta Impresa:
    en la columna "Impresa" podrá ver el estado de Impresion de cada Etiqueta,
    pudiendo así filtrar por Órdenes que han sido Impresas o No.

  • Visualización de Etiqueta

  • Seguimientos

    Acá vemos los enlaces de los seguimientos de cada una de las ordenes generadas.

  • Visualización al abrir un enlace de seguimiento

Configuración de la aplicación

A continuación iremos a configuración desde el acceso de configuración

  • Tipo de servicio:

    WareHousing : Despliegue por productos

    CrossDocking : Un solo contenedor, igual a 1 bulto..


  • Formato de impresión:

    Al seleccionar El formato de impresión nos permitirá imprimir por defecto en las plataformas involucradas


  • Actualizacion de tarifa:

    Actualizaremos el listado de tarifas para el metodo de envio de Urbano


    Ingresaremos como opcional los codigos postales que queremos filtrar, por ejemplo del CP 1000 al CP 2000. O dejar por defecto en el que seria el rango desde 1000 a hasta 9999.

    Segun la opcion habilitar se habilitaran en el listado de CSV que se descargue o se omitiran los codigos postales deshabilitados.

    A continuacion seleccionaremos alguna provincia para seleccionar sus codigos postales

    Aca vemos los codigos postales seleccionados. Cuando terminemos la seleccion daremos en guardar filtrado de localidades.

    Por ultimo daremos en Procesar el filtrado

    Una vez que haya terminado el proceso nos mostrara 2 botones.

    Se podra guardar el listado para ingresarlo a la plataforma de Vtex desde el boton Imprimir CSV.


    Con el boton Actualizar se podra subir el listado del tarifario a la plataforma Vtex

     

  • Selección del método:

    Permitirá obtener desde las ordenes del listado de pendientes todas las ordenes con el método de Urbano o traer todas las ordenes de cualquier método de envió


  • Puntos de retiro

    Los puntos de retiro le permitira dar la opcion en el checkout para el retiro en la sucursal elegida

    En la sección de puntos de retiro nos permitira ingresar o actualizar todas las sucursales en la plataforma de Vtex


    Una vez accionado el boton de actualizar se nos preguntara si estamos de acuerdo de ingresar o actualizar nuevamente


    Al momento de actualizar, tenga paciencia, este procedimiento tardara aproximadamente 60 segundos.


    Por ultimo se podra guardar el listado para ingresarlo a la plataforma de Vtex desde el boton Imprimir CSV.

  • Unidad de peso

    Unidad (Elija la configuración de la unidad de peso para los productos que se configuro en la plataforma de Vtex)

    En el caso que los productos estén en gramos se debería elegir la opción de gramos. En caso contrario si esta en kilogramos no hace falta cambiar la opción


    Una vez elegido el tipo de unidad guarde la configuración


  • Activacion desde Vtex:

    Para la activacion desde Vtex del enlace compartido, es ACCESS

    https://developers.vtex.com/docs/guides/orders-feed#hook


  • Activacion tracking:

    Nos Permitira enviar las ordenes automaticamente una vez que ingrese el pago en Vtex.

    Ir a configuracion activar y guardar:

Tienda checkout

  • Ingreso a la tienda

    Asignación de un producto al checkout


    Pedido confirmado

    En este ejemplo el pedido ya esta pago