Argentina
Cómo integrar Urbano Express con Tiendli
Conectá la cuenta comercial de Urbano Express de tu negocio para consultar tarifas reales desde Tiendli.
¿Qué permite hacer?
- Validar las credenciales de tu cuenta Urbano.
- Consultar tarifas en tiempo real desde el checkout.
- Crear órdenes CROSS directamente desde el pedido.
- Generar etiquetas A4, 10×10, 10×15, 10×6 y ZPL.
- Consultar tracking y sincronizar el estado del pedido.
- Solicitar rescate/devolución de una pieza en tránsito.
- Trabajar con ambiente de testing o producción.
Antes de empezar
- Cuenta comercial de Urbano Express.
- Número de shipper.
- Password asignado por Urbano.
- Productos físicos con peso, ancho, alto y largo.
- Credenciales de producción gestionadas con el ejecutivo de cuentas de Urbano.
Cómo conectar la cuenta
- 1
Ingresá a Panel de Tiendli → Logística → Operadores logísticos.
- 2
Buscá Urbano Express y elegí Testing o Producción.
- 3
Ingresá el número de shipper y el password correspondiente a ese ambiente.
- 4
Guardá la conexión. Tiendli realiza una consulta read-only para validar las credenciales.
Durante el checkout
Tiendli consulta al operador desde el servidor. El importe se vuelve a validar al crear el pedido para evitar que un precio modificado en el navegador sea aceptado.
- El comprador debe indicar un código postal argentino válido de 4 dígitos.
- Tiendli envía a Urbano el peso real y las dimensiones del paquete.
- Urbano puede calcular el peso volumétrico y devuelve la tarifa aplicable.
- La tarifa vuelve a consultarse en el servidor antes de crear el pedido.
Preparar y despachar el pedido
- Abrí el pedido y presioná “Crear envío Urbano”.
- Tiendli genera un código de seguimiento estable para el pedido y crea la orden CROSS en Urbano.
- Si un reintento encuentra ese mismo tracking ya creado, Tiendli lo recupera en lugar de duplicar la pieza.
- Urbano requiere DNI, LE o LC del destinatario para crear el envío.
Etiquetas
- Podés abrir la etiqueta A4 desde el pedido.
- También están disponibles formatos térmicos 10×10, 10×15, 10×6 y ZPL.
Seguimiento
- La actualización de tracking consulta los movimientos informados por Urbano.
- Tiendli puede avanzar conservadoramente el pedido a Enviado o Entregado según los eventos del carrier.
Cancelaciones
- Urbano reemplazó su antigua API de cancelación por el flujo de rescate/devolución.
- Desde Tiendli podés solicitar el rescate de una pieza cuando Urbano todavía lo permite.
- Solicitar un rescate logístico no cancela ni reembolsa automáticamente la venta en Tiendli.
Recomendaciones
Cargá peso, ancho, alto y largo en todos los productos físicos. Los operadores utilizan esos datos para calcular la tarifa y preparar el envío.
Antes de comenzar a vender con un operador nuevo, realizá un pedido de prueba completo: cotización, compra, creación del envío, etiqueta y tracking.
Preguntas frecuentes
¿Dónde obtengo el shipper y password?
Las credenciales productivas las gestiona Urbano Express con el ejecutivo de cuentas asignado al comercio.
¿Puedo probar antes de producción?
Sí. Urbano publica un ambiente de testing separado del productivo. Seleccioná el ambiente correspondiente en Tiendli.
¿Por qué Urbano no devuelve una tarifa?
Revisá el código postal, que los productos tengan peso y dimensiones válidas y que tu cuenta tenga cobertura para el destino.
¿Por qué Tiendli pide DNI, LE o LC?
Urbano exige uno de esos tipos de documento para crear la orden CROSS. El dato queda guardado en el snapshot del pedido.
¿Rescate es lo mismo que cancelar el pedido?
No. El rescate/devolución es una operación logística sobre la pieza en Urbano. La venta y sus pagos se administran por separado en Tiendli.