Shopify Ultima actualización: 2025-07-24

  • La integración de Urbano Express con Shopify nos permitirá gestionar los envíos desde la tienda o desde la plataforma de
    Integrate con dicho operador logístico, imprimir las etiquetas, seguimientos de las ordenes, además de calcular los costos de
    envió en la tienda y otras parametrizaciones explicadas en la siguiente documentación.

Proceso de Alta (Shopify + Urbano):

Este documento detalla los pasos necesarios para integrar un nuevo Cliente a nuestra plataforma logística, utilizando Shopify para la comunicación con Urbano Express Argentina.

1. Inicio del Proceso y Cadena de Mails:
Para comenzar el proceso de integración, las credenciales SOLO PUEDEN SER SOLICITADAS POR EL EJECUTIVO DE CUENTAS (que a partir de ahora lo llamaremos EC).

Si aún no tiene un EC asignado escribir a: Equipo Comercial (equipocomercial@urbano.com.ar)

Su EC será el punto de contacto para iniciar este proceso y proporcionarle toda la documentación necesaria para la gestión comercial. Una vez que su EC haya iniciado dicho proceso se dispondrá de una cadena de mails donde le estaremos indicando el paso a paso correspondiente. Siempre se deberá mantener en la cadena de mails a su EC y a Integraciones (integracionsistemas@urbano.com.ar) para que el proceso fluya de forma natural sin contratiempos.

2. Obtención de Credenciales de Producción (No existe ambiente de Testing):

Importante: Shopify es una plataforma en Línea, y en Urbano no disponemos de un ambiente de pruebas disponible para este canal. La integración deberá configurarse directamente con las credenciales de producción.

Envío de órdenes de prueba en Producción: Una vez configurada e instalada la App de Urbano en su Tienda, es imprescindible que nos envíe un mínimo de 5 órdenes generadas (a modo de Testeo). Estas órdenes deben ser representativas de los tipos de pedidos que gestionará habitualmente (por ejemplo, con diferentes productos, direcciones de envío, etc.). Que luego su EC eliminará de su cuenta por ser órdenes de testeo.

Revisión y validación: Nuestro equipo revisará estas órdenes de prueba para verificar que la información se transmita correctamente y que no existan inconsistencias o errores en los datos recibidos.

Esto incluye la validación de:
- Datos del destinatario (nombre, dirección completa, teléfono, email).
- Detalles de los productos (El peso y dimensiones son OBLIGATORIAS en cada producto para poder tarifar correctamente cada envío).

Le recomendamos que realice pruebas adicionales en producción con un volumen bajo de órdenes al inicio para asegurar un funcionamiento óptimo antes de operar con el volumen completo.

Ante cualquier duda o inconveniente durante el proceso de integración, no dude en escribirnos por medio de la Cadena de Mails anteriormente mencionada (siempre incluyendo a su EC y al Equipo de Integraciones).


Cosas Importantes antes de Integrarse con Urbano:

- Integración: Recuerde que para una correcta integración PRIMERO debe estar logueado en Integrate y luego acceder por medio de esta documentación al botón azul de instalación (Instalar App de Urbano).

(No hacer este proceso directamente desde el buscador de apps de Shopify porque la integración quedará Inconsistente y deberá repetir el proceso de Instalación).

- Tipos de Planes en Shopify:

El Plan Básic de Shopify NO PERMITE EL TARIFADO con Urbano desde el carrito de compras, el resto del proceso se continuará de forma normal pero sin poder mostrarle al cliente de su tienda el monto que pagará por el envío.

El Plan Grow de Shopify NO PERMITE EL TARIFADO Para ésto necesita integrar una solución de envíos externa que requiere el uso de tarifas de envío calculadas por terceros ("Carrier Calculated Shipping"). Por lo que se tienen que contactar con soporte de Shopify y preguntarles si su tienda tiene esta habilitación. Eso puede generar un pago adicional mensual, o pasarse a un plan anual si eso la incluye sin costo adicional. O en su defecto pasarse Plan Advanced o Plus donde esta opción viene incluida por defecto.

Ver Planes de Shopify

- Bultos: El Seteo de bultos o cualquier configuración de una Orden se realiza desde nuestra plataforma Integrate ANTES DE IMPACTARLA.

Recuerde que una vez impactada dicha Orden no se podrá modificar ninguna órden, quedando como unica opcion darla de baja y volverla a cargar por medio del Portal Clientes mediante un archivo .XLS.


- Tracking Automático: Por defecto se impactarán automáticamente en Urbano todas las Ordenes que hayan recibido el Pago. Para modificar este funcionamiento y hacerlo de forma manual, en caso de que se requiera, se puede des-habilitar esta opción de tracking-automático desde la configuración de su cuenta en la plataforma Integrate.

Integración Urbano-Shopify

Para lograr una correcta Integración entre Shopify y Urbano, PRIMERO deberemos acceder a la plataforma Integrate con las credenciales entregadas por su Ejecutivo de Cuentas, para luego instalar la App de Urbano desde el siguiente botón, y NO desde el buscador de Apps de Shopify (Si lo hace desde el buscador de Shopify directamente, la integración quedará inconsistente y deberá repetir el proceso correctamente).

  • Instalación

    Seleccionamos la opción "Instalar", en la parte superior derecha de la pantalla. O en el siguiente botón:


    Instalar App de Urbano

  • La acción anterior nos lleva hasta Shopify donde instalaremos la aplicación

    Seleccionamos "Instalar"



  • Ingresar las credenciales

    Luego de instalar correctamente, en el siguiente paso se solicitará el idShipper y la contraseña.

    Nro de Shipper: **** (númerico de 4 dígitos)

    Contraseña: ********

    Las siguiente credenciales en el caso de no tenerlas deberán ser solicitadas a Urbano Express desde el botón solicitar
  • Configuración

  • Callback y WebHook de Integración:

    Crearemos el carrier url callback, para poder calcular las tarifas de envío, y el webhooks url para poder procesar las ordenes desde Shopify.

    Tipo de Plan en Shopify: Como se explicó aquí, tener en cuenta el tipo de plan para que se pueda tarifar dinámicamente usando el Carrier de Urbano. Esto influye también en el impacto de ordenes en Urbano, puesto que las ordenes que no cuenten con el Carrier de Urbano, no impactarán directamente en nuestros sistemas.


  • Notificación que se ha logrado con éxito la creación manualmente del carrier y webhooks

    Una vez realizado todo el proceso, dentro del panel de administración de su tienda de Shopify, ir a:

    Configuración-> General


  • Procesamiento de Pedidos:

    En la opción "Procesamiento de pedidos", tendremos, "Preparar autómaticamente las líneas de artículos del pedido". Esto para que una vez ingresada la orden, y capturado el pago, se envíe a Urbano automáticamente. Y acto seguido se entrega a su tienda el tracking info de la orden, dígase codigo de seguimiento y enlace para acceder al mismo.



    En la opción "Pagos", se selecciona la manera de capturar el pago, dígase manual o en forma automática.


  • Integrate


  • Ó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:

    Usando filtro personalizado por orden. En caso de ser más de una, separarlas por coma:
  • Seteo de Bultos de una Orden:

    IMPORTANTE: El seteo de Bultos es una Opcion que NO existe en su tienda de Shopify, por eso mismo el Unico lugar para establecer la cantidad de bultos de una Orden En particular es desde la solapa de PENDIENTES de nuestra plataforma Integrate ANTES DE ENVIAR DICHA ORDEN.

    RECUERDE que una vez IMPACTADA una orden en nuestra plataforma, ésta no podrá modificarse. Quedando como unica opcion dar de baja dicha órden para volver a subirla manualmente por medio un archivo XLS desde nuestro Portal Clientes.


    1) Primero deberá establecer la cantidad de bultos que tendrá una Órden.
    2) Luego deberá Enviar Dicha Orden para que se Impacte en nuestro sistema.
    Tal cual se muestra en la imagen:


  • 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 Impresión de cada Etiqueta,
    pudiendo asi filtrar por Órdenes que han 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 Integrate

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

    • Valores de envío:
    • Seleccionar monto adicional a la tarifa de envío (%), nos permitirá agregar el importe adicional del porcentaje que ingresemos

      Valor fijo de envío nos permitirá ingresar un valor de envió para todos los código postales


    • Valor mínimo para envío gratis:
    • Esta opción nos permitirá habilitar el envió gratis si no es menor al importe ingresado



    • Tipo de servicio: (Seteo de Bultos por defecto)

    • WareHousing: Despliegue por productos

      CrossDocking: Un solo contenedor, igual a 1 bulto.

      Bultos: El Seteo de bultos o cualquier configuración de una Orden se realiza desde nuestra plataforma Integrate ANTES DE IMPACTARLA.

      Recuerde que una vez impactada dicha Orden no se podrá modificar.
      Quedando como unica opcion darla de baja y cargar dicha orden nuevamente por medio del Portal Clientes.



    • Carrier:
    • Cuando se realiza la integración correctamente, y se cuenta con el plan establecido, como se describió previamente, se crea el carrier personalizado de Urbano, automáticamente, para tarifar dinámicamente. En caso de que no se pueda, por el tipo de plan de su tienda, al hacer las gestiones pertinentes para habilitar el tarifado, en esta sección, se puede crear el carrier si corresponde.



    • Configuración de la Etiqueta - (Descripción del Producto/SKU en la Etiqueta)

    • En "Descripcion del Producto/SKU en la Etiqueta" podremos elegir si se desea mostrar:

      - La descripción de cada producto del envio + su cantidad.
      - El SKU de cada producto del envio + su cantidad.
      - Ninguna.

      Esta descripción aparecerá en el campo "Obs:"

    • Valor Declarado:
    • Seleccionar valor fijo o por ciento del valor de compra

      El valor declarado servirá para asignar el valor fijo o porcentaje del seguro



    • Contrareembolso (COD):
    • Seleccionando esta opción, se indica que el servicio que está usando, es de Contrareembolso (COD)



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



    • Tracking Automático:
    • Nos permitirá enviar las ordenes automáticamente una vez que ingrese el pago en Shopify.

      Se deberá configurar en la plataforma previamente si es que se desea activarlos automáticamente o manualmente Guia de configuracion de preparado para shopify



      Si está usando en su tienda, Contrareembolso (Cash on Delivery - COD), o Mercado Pago (MP), o cualquier otro método de pago gratis que no se registre el pago en Shopify, el mismo, no procesará la orden y se marcará con el estado de pago "Pago Pendiente" y no se procesarán de manera autómatica a Urbano, incluso con haber seleccionado la opción previa de "Tracking Automático". Seleccione está opción, además de la mencionada, para procesar las ordenes con este estado de pago de manera automática, bajo su responsabilidad.




    • Configuración de Fulfillment para Órdenes No Preparadas y Pago Pendiente
    • Para órdenes con estado de pago "Pendiente" y marcadas como "No Preparadas" (sin líneas de pedido para procesar), es necesario configurar el fulfillment para poder asignar el seguimiento y la información de tracking. Esto permitirá que el código de seguimiento y su enlace de consulta se reflejen automáticamente en la orden.

      Pasos para la configuración:
      1. Acceder al panel de administración de Shopify
        Ruta: Configuración → Notificaciones → Webhooks
      2. Crear un nuevo webhook con la siguiente configuración:
        • Evento: Creación de proceso de envío
        • Formato: JSON
        • URL: https://integrate.urbano.com.ar/shopy/action/[nombre_de_la_tienda]/updateTrackingManually
        • Versión de la API del webhook: 2024-10
      Configuración de Fulfillment en Shopify
      Configuración del webhook para fulfillment

      Luego de esta configuración, en el listado de pedidos, ir a la orden deseada y al seleccionar la orden, clickear marcar como preparado y listo, se le refleja el seguimiento agregado.

    • Titulo y descripción:
    • El titulo y la descripción se vera al momento de la selección del metodo de envio para Urbano

    • Rango de días de envío:
    • Los rangos de dias aparecerá para todos los envios de forma predeterminada. Si selecciona la opción "Deshabilitar",
      los mismos, no se mostrarán en la tienda a la hora de cotizar el envío.

    • Puntos de Retiro:
    • Los puntos de retiro le permitirá dar la opción en el checkout para el retiro en la sucursal elegida

      Debemos activar los puntos de retiro y guardaremos la opción

      Nos saldrá una advertencia si estamos seguro de guardar los cambios

    • Deshabilitar servicio por localidades:

      El servicio por localidades permitirá agregar todos los códigos postales que no queramos que aparezcan en el metodo de envió

      Seleccionar la provincia

      Seleccionar la localidad

      Se elegira las localidades a agregar o quitar

      Guardar