Descargar Plugin de Urbano

Prestashop Ultima actualización: 2026-04-23

  • El modulo de envíos nos permitirá comunicarnos con el web service, con los parámetros de la api key y el end point del servicio web.

  • Iniciar como administrador en el backoffice de Prestashop, en la url agregar "/administracion", una vez hayamos ingresado dirigirse al menú principal lateral de la izquierda. en la sección de personalizar desplegar la opción Módulos y se visualizara el acceso a Module Manager.

  • El modulo nos permitirá realizar envíos, calcular sus costos, imprimir etiquetas en diferentes formatos y realizar el seguimiento del pedido.

Proceso de Alta (Prestashop + Urbano):

Este documento detalla los pasos necesarios para integrar un nuevo Cliente a nuestra plataforma logística, utilizando Prestashop 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 Prestashop 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 Prestashop.

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 Prestashop.

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 8.3
  • Mysql >=5.6
  • Prestashop 9.0.3
  • Extensión SOAP PHP
  • JSON PHP Extension
  • Mbstring PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension
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.

Instalación del modulo

Pasos:
  • Iniciar como administrador en el backoffice de Prestashop, una vez hayamos ingresado dirigirse al menú principal lateral de la izquierda. en la sección de personalizar desplegar la opción Módulos y se visualizara el acceso a Gestor de Módulos.
  • Hacer click en el botón Subir modulo como se aprecia en la siguiente imagen
  • Nos dará la opción de subir el modulo manualmente con un solo click o arrastrándola hacia la ventana activa.

    El módulo lo podras descargar desde el Siguiente botón:

    Descargar Plugin de Urbano.

  • Comprobamos que se ha tenido éxito en la subida del modulo.

    • Luego de subir el modulo, continuaremos con la configuracion del mismo

Configuración del modulo


  • Debemos ingresar los siguientes parámetros

  • 1) Número del Shipper: Deberá setear el Nro de Shipper asignado por Urbano.
    • En caso de usar el ambiente de Testing se podrá setear el shipper de pruebas "671"
  • 2) Contraseña: Deberá setear el password asignado por Urbano.
    • En caso de usar el ambiente de Testing se podrá setear la pass: MPzQG6%jfN%-#tsb=CUj
  • 3) EndPoint WebService: Deberá elegir uno de los 2 End-Points disponibles
    • Testing: https://testing-apis.urbano.com.ar
    • Producción: https://apis.urbano.com.ar
  • 4) Coeficiente Aforo: Deberá setear el aforo acordado con Urbano al momento del alta.
  • 5) Opcion: Deberá elegir el modo de configuracion de su cuenta
    • Ware: Warehousing
    • Cross: Crossdocking
  • 6) Importe de Envío:
    • Este valor se mostrará para TODOS los envios, caso contrario dejarlo en cero.
  • Comprobamos que se han guardado los parámetros correctamente.

    • Transportistas / Carriers:

  • En el menu principal, en Transporte iremos a Transportistas para configurar los parametros de los envíos.

    • 2) Estado: Siempre checkear que el Estado sea activo".
    3) Por medio del boton de Edición se ingresará a configurar los parametros del Modulo de Envíos de Urbano.

  • General: Se podran configurar varios parametros del Carrier de Urbano.

  • Localización de destino y gastos de Envío: Asegurarse de que en las Zonas habilitadas esté "South America" o "America del Sur".
  • Dimensiones del Producto: Dentro de "Catálogo" -> "Productos" iremos a la solapa de "Transporte".

    Allí deberemos setear las dimensiones de TODOS los Producto a enviar por medio de Urbano.

    IMPORTANTE: Las Dimensiones son de caracter OBLIGATORIO para poder tarifar los envíos y procesar cada órden.

  • Seteo del Carrier en el Producto:
    En la seccion de Transportistas habilitados para enviar dicho Producto, se deberá habilitar alguna de las siguientes opciones :

    1) O Todos los Transportistas.
    2) O Urbano.

  • Formato del Código Postal:

    En el caso que al hacer una compra salga código postal incorrecto debemos cambiar el formato del mismo.

    Debemos ir al menú y acceder a Internacional y se nos abrirá un menú contextual en el cual elegiremos Locations o Ubicación.

  • Vamos a Country o Países y elegiremos Argentina.
  • En Zip/postal cambiaremos el formato de numero a NNNN que serian 4 dígitos numericos

Tienda

  • Crear una Órden:

    • Deberá comprobar el correcto funcionamiento del modulo de envíos registrándose o ingresando con otros usuario que no sea el administrador.

    • Abra una pestaña en incógnito o cierre sesión.

    • Procederemos a agregar el producto al carrito de compra.
    • Ingreso de la dirección:

      El cliente debería ingresar correctamente la dirección de entrega, asegurándose que el código postal es correcto.

    • Método de envío:

      Una vez completados los datos de dirección correctamente nos saldrá el método de envío de Urbano.

    • Ingresamos el pago:

      Ingresamos el pago según como tengamos configurado en nuestro Prestashop.

    Gestión de una Órden

    • Estado del pago

      • Ingresaremos al menú de Pedidos y cambiaremos el estado del pago.

    • Iremos al menú y en las ultimas opciones encontraremos Gestionar envíos.
    • Pedidos Enviados

      1) Tendremos el botón de Etiqueta en cada una de las ordenes para poder imprimir las Etiquetas.

      2) Tendremos el botón de Seguimiento en cada una de las ordenes para ver el estado.


    • Información

      Vemos el producto, estado del pedido y la fecha de estado


    • Detalles

      Vemos la información del cliente por producto


    • Etiqueta de la orden de envío..