Magento 2 Ultima actualización: 2026-01-28

  • El modulo de envíos de Urbano Express nos permitirá realizar envíos y calcular sus costos.

  • Modulo de envíos versión 2.2
  • Licencia Open Software License (OSL 3.0)
Proceso de Alta (Magento 2 + Urbano):

Este documento detalla los pasos necesarios para integrar un nuevo Cliente a nuestra plataforma logística, utilizando Magento 2 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. Ambiente de Testing y Órdenes de Prueba:
En primera instancia le enviaremos las credenciales de nuestro ambiente de testing dedicado. Este ambiente le permitirá configurar y probar la conexión entre su tienda con Magento 2 y nuestra plataforma antes de pasar a producción. Se podrán generar órdenes de prueba, imprimir etiquetas y ver el seguimiento de sus pedidos sin impacto real en nuestros sistemas. Éste paso es clave para evitar inconsistencias y asegurarnos que todo funcione correctamente con la integración.

Pasos clave:

Configuración inicial: Deberá configurar su integración con nuestro sistema en el ambiente de testing. Esto incluye la instalación y configuración del plugin para Magento 2.

Envío de órdenes de prueba: Una vez configurado, es imprescindible que nos envíe un mínimo de 5 órdenes generadas en su Tienda bajo nuestro ambiente de testing. Estas órdenes deben ser representativas de los tipos de pedidos que gestionará habitualmente (por ejemplo, con diferentes productos, direcciones de envío, etc.).

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 (peso y dimensiones son OBLIGATORIAS en cada producto).

3. Obtención de Credenciales de Producción:

Una vez que hayamos validado las 5 órdenes de prueba enviadas desde su ambiente de testing y confirmado que la integración funciona correctamente, procederemos a enviarle las credenciales de producción.

Proceso:

Confirmación de validación: Recibirá una confirmación por parte de nuestro equipo indicando que las órdenes de testing han sido validadas exitosamente.

Envío de credenciales: Inmediatamente después de la confirmación, le proporcionaremos las credenciales necesarias (End-Point, Numero de Shipper y Contraseña) para configurar la integración en su ambiente de producción.

Configuración en producción: Con estas credenciales, podrá replicar la configuración exitosa del ambiente de testing en su entorno de producción, habilitando la integración real con Urbano Express Argentina.

Consideraciones importantes:
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:

- Instalación del Plugin: Recuerde que para una correcta integración deberá descargar el Plugin de Urbano e instalarlo en su Tienda de Magento 2.

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

Requisitos

El modulo de Urbano tiene algunos requisitos del sistema.

En lo posible se debería contar con las versiones detalladas.

Requerimientos:
  • PHP >=7.2 <= 8.3
  • Mysql >=5.6
  • Magento versión 2.2.x hasta 2.4.x
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.

Copiar modulo

Pasos:
  • Debemos descomprimir el archivo del modulo.
  • Dentro de la carpeta del archivo descomprimido tendremos una carpeta con el nombre "Urbano"
  • Ahora nos dirigiremos a la carpeta principal de magento
  • Si no tiene una carpeta "code" dentro de la carpeta "app" debería crearla.
  • Ahora deberíamos copiar la carpeta "Urbano" y "Urbanoppc" que habiamos descomprimido anteriormente dentro de la carpeta "code".
  • La estructura debería quedar como en la siguiente imagen.

Activación de los modulos

    Debemos abrir la consola de comandos y dirigirnos la carpeta principal de magento y ejecutar las 3 siguiente instrucciones, una por vez

  • php bin/magento module:enable Urbano_Shipping --clear-static-content
  • php bin/magento module:enable Urbanoppc_Shipping --clear-static-content
  • php bin/magento setup:upgrade

  • Debemos borrar la cache.

    Eliminaremos la carpeta view_preprocessed dentro de la carpeta var

  • Ejecutaremos la herramienta de implementación de archivos de vista estática.

    php bin/magento setup:static-content:deploy -f


Configuración de impuesto

    Para comenzar debemos ir a Tiendas > Impuestos > Zona de impuestos y tarifas

  • A continuación nos aparecerá una pantalla similar.
    • Debemos seleccionar el País
    • En la siguiente columna State/Region o Estado federado Region, añadir un estado, en caso que no seria el indicado se tendria que dejar un * que significaría todos
    • En Rate o Tasa ingresar la tasa de porcentaje

  • Configuración de impuesto en el envió
    • Ingresamos a la configuración del método de envió para Urbano
    • Iremos a la opción de porcentaje adicional de envió, por ej: 21 % y le daremos en GUARDAR
    • En caso de no especificar porcentaje volver a dejar en 0 y daremos en GUARDAR

Configuración de valor declarado

    En la configuración del método de envió podremos configurar el valor fijo declarado, dejar en 0 en caso de no especificar ningun valor

  • Para especificar un valor declarado en porcentaje, ingresar solo valor numérico, en caso de que el valor declarado fijo y porcentaje sean mayor a 0 tomara por defecto el valor declarado en porcentaje.

Configuracion del metodo de envio

    Configuracion del metodo de envio para Urbano Express

    Iremos al Menu de la barra lateral izquierda, en STORES > Configuration > Shipping Methods

  • En Configuración buscamos el metodo de Urbano Express Argentina.
    • Debemos activar el método
    • Completamos los campos Endpoint "Accesso al servicio", Shipper y contraseña "Key" para el funcionamiento del metodo de envio
    • Guardaremos los cambios

  • Modo de envío
    • Acá seleccionaremos el tipo de servicio

      WareHousing : Despliegue por productos.

      CrossDocking : Un solo contenedor, igual a 1 bulto.


  • Configuración de los puntos de retiro

    Aclaración: para que se puedan activar los puntos de retiro, deberá estar configurado y activo el método de envió regular de Urbano

    • Ingresamos a la configuración del método de envió para Urbano Pickup Point Express Argentina
    • Si deseamos habilitar los Puntos de retiro debemos elegir "Yes"
    • Guardaremos los cambios

Envío de la orden

Pasos:

    Navegamos hasta el menu, en Sale o Ventas se nos desplegara un sub menú contextual y elegimos ordenes.

  • Seleccionaremos la orden que queremos gestionar.

  • Nos permitirá elegir si queremos mantener el producto "Hold", Retirarlo "UnHold", aplicaremos la opción UnHold para retirarlo de la gestión de envíos y proceder con el mismo.

    Nos mostrara el estado actual "procesando" en la columna Status.

  • Enviar a Urbano Express.

    Ya podemos proceder a realizar el pedido de envió yendo a acciones y elegir Generar pedido Urbano.

    Nos saldrá una ventana emergente preguntando si queremos generar el envió, le decimos que si.

  • En el menú Sale o Ventas podremos ver en el sub menu Envíos, todos los envíos procesados.
  • En la columna de acción podremos ver toda la información y seguimiento del envió.
  • Podremos ver la información de envió y seguimiento.
  • Iremos al enlace de Seguimiento de envío.
  • Nos saldrá una nueva ventana con la información del seguimiento.
    Primero Guardamos.
  • Se nos abrira una nueva ventana de Urbano Express con el proceso y estado actual del producto.
  • Impresión de etiquetas.
    Nos dirigimos al menú y en Ordenes/Orders veremos la opción Envios/Shipments

    Veremos el listado con todos los envíos, seleccionaremos los items y en Acciones/Actions seleccionaremos la opción de "Obtener etiquetas Urbano".
  • Enlace de impresion
  • Visualización de la etiqueta