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).
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.
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.
- 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:
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.
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:
Acceder al panel de administración de Shopify
Ruta: Configuración → Notificaciones → Webhooks
Crear un nuevo webhook con la siguiente configuración:
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ó