Uruguay
Cómo integrar UES con Tiendli
La integración directa de UES con Tiendli conecta la cuenta logística de cada comercio con el checkout y la gestión de pedidos. Podés ofrecer entrega a domicilio y retiro en agencias UES, crear la guía cuando el paquete está listo, imprimir etiquetas, consultar el seguimiento y, si tu acuerdo lo habilita, pedir el levante de mercadería desde tu depósito.
¿Qué permite hacer?
- Crear guías UES para entregas a domicilio desde un pedido listo para despachar.
- Ofrecer retiro en agencias UES y cargar la lista de puntos habilitados directamente desde la API.
- Guardar el número de tracking y el enlace de seguimiento web del envío.
- Obtener etiquetas en PDF y solicitar formatos 10×10, 10×15 o ZPL desde el pedido.
- Sincronizar los eventos de tracking y registrarlos en el historial logístico de Tiendli.
- Descargar el reporte oficial de guías de UES en CSV para un rango de fechas desde la configuración del operador.
- Solicitar un levante de mercadería al crear la guía, usando una dirección recurrente de UES o la dirección del comercio.
- Registrar la guía de devolución cuando el servicio contratado por la marca genera logística inversa junto con la guía de ida.
- Enviar a UES el email y teléfono del destinatario para que el operador pueda gestionar sus notificaciones de envío.
Antes de empezar
- Alta comercial activa con UES y credenciales para la API: usuario, contraseña, Cliente y Tocken.
- Servicio UES habilitado para entrega a domicilio y/o servicio de pickup, según lo que quieras ofrecer en la tienda.
- Peso mayor a cero cargado en todos los productos físicos que se despacharán por UES.
- Dirección de entrega con calle y número de puerta, además de departamento y localidad.
- Departamento y localidad compatibles con la codiguera oficial de UES; Tiendli consulta esa codiguera antes de crear la guía.
- Email y teléfono del destinatario. El email es especialmente importante cuando UES envía las notificaciones del transporte.
- Costo de envío configurado en Tiendli según el acuerdo comercial vigente del negocio con UES.
Cómo conectar la cuenta
- 1
Ingresá a Panel de Tiendli → Logística → Operadores logísticos y buscá UES.
- 2
Ingresá el usuario y la contraseña de Basic Auth, junto con los campos Cliente y Tocken entregados por UES.
- 3
Guardá la conexión. Tiendli valida las credenciales consultando los servicios habilitados para esa cuenta antes de activarla.
- 4
Dejá el servicio en Automático para que Tiendli use la codiguera de UES según localidad o agencia (recomendado), o elegí un servicio habilitado si UES te indicó expresamente cuál usar. Podés desactivar cualquiera de las dos modalidades.
- 5
Si UES retira la mercadería en tu depósito, activá Solicitar levante. Podés usar el ID de una dirección recurrente de UES o dejar que Tiendli envíe la dirección de tu comercio.
- 6
Entrá luego a Métodos de envío y configurá el precio, zonas o condiciones comerciales que quieras mostrar en el checkout.
- 7
Hacé un pedido de prueba completo antes de publicar la opción a clientes: checkout, guía, etiqueta y tracking.
Durante el checkout
La documentación API entregada por UES no incluye un servicio de cotización de tarifas. Por eso Tiendli no crea guías ficticias para calcular precios: el checkout usa el precio o las reglas que configuraste en Métodos de envío y la integración valida la agencia, la localidad y el servicio al preparar el despacho.
- En Envío a domicilio, el comprador completa su dirección y elige el método UES configurado por el comercio.
- En Retiro en agencia, Tiendli consulta la lista de agencias de UES y el comprador selecciona dónde retirará el paquete.
- La agencia seleccionada se vuelve a consultar del lado del servidor antes de guardar el pedido, evitando aceptar datos manipulados desde el navegador.
- El costo del método se calcula con la configuración de Tiendli. Si tu tarifa comercial de UES cambia, actualizá el método de envío antes de recibir nuevos pedidos.
- El pedido conserva la modalidad UES y, cuando corresponde, la agencia elegida para que el vendedor pueda despacharlo sin volver a pedir esos datos.
Preparar y despachar el pedido
- Cuando el pedido esté listo, abrilo en Ventas → Pedidos y elegí Crear envío UES.
- Tiendli comprueba que el pedido realmente fue comprado con un método UES, que existen las credenciales y que el destinatario tiene los datos obligatorios.
- Tiendli muestra la codiguera oficial de departamentos y localidades de UES en el checkout para evitar errores de escritura. UES exige enviar el texto de la localidad respetando esa lista.
- Tiendli calcula el peso total a partir de los productos del pedido y envía la descripción, valor declarado, destinatario, teléfono, email y datos de entrega.
- Si UES determina que el servicio elegido no corresponde a la localidad o al pickup, puede ajustarlo al servicio válido de esa zona. Tiendli conserva y muestra el aviso que devuelva UES.
- La creación está protegida contra dobles clics y reintentos: si el pedido ya tiene una guía UES, Tiendli reutiliza ese tracking en lugar de crear otro envío.
- Si activaste levante, la misma solicitud puede incluir la colecta de UES en el depósito. El ID y la fecha de levante devueltos quedan asociados al pedido.
Etiquetas
- La respuesta de creación puede devolver la etiqueta de la guía inmediatamente y Tiendli conserva el tracking para reabrirla después.
- Desde el pedido podés solicitar la etiqueta estándar en PDF, PDF 10×15 o ZPL.
- Los enlaces de etiqueta que entrega UES pueden vencer; Tiendli vuelve a pedir un enlace válido cuando abrís la etiqueta.
- Si el servicio contratado genera una guía de devolución junto con la guía de ida, Tiendli conserva el número y habilita también la descarga de su etiqueta desde el pedido.
Seguimiento
- UES expone eventos de tracking por número de guía y Tiendli puede sincronizarlos desde el pedido.
- Los eventos quedan registrados en Shipping Tracker y en el historial del pedido, incluyendo punto de pickup y coordenadas cuando UES las devuelve.
- Los estados compatibles hacen avanzar el pedido a Enviado o Entregado sin retroceder pedidos que ya estén en un estado terminal.
- El comprador también puede utilizar el enlace de seguimiento web de UES asociado a su número de guía.
- UES gestiona las comunicaciones al destinatario con los datos enviados por el comercio. La disponibilidad y el canal concreto de cada notificación dependen del servicio habilitado por UES.
Cancelaciones
- La cancelación de una guía UES no se automatiza desde Tiendli. Aunque la documentación técnica recibida describe campos y respuestas para cancelación, UES indicó para el alcance comercial de esta integración que las cancelaciones no deben ejecutarse automáticamente; por eso Tiendli no muestra un botón que pueda dar una falsa confirmación.
- Si necesitás anular un envío ya creado, gestioná la solicitud directamente con UES de acuerdo con el procedimiento de tu cuenta.
- La logística inversa es independiente de una cancelación: determinados servicios pueden crear automáticamente una guía de devolución junto con la guía de ida si UES habilitó esa modalidad para la marca.
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
¿Qué credenciales necesito para integrar UES con Tiendli?
UES utiliza dos niveles de autenticación: usuario y contraseña HTTP Basic, y los valores Cliente y Tocken dentro de los mensajes de la API. La empresa debe darte los cuatro datos. En Tiendli quedan cifrados.
¿Dónde solicito el usuario de prueba o el alta comercial?
UES gestiona las credenciales después del alta comercial. Solicitá a tu contacto comercial de UES el usuario y contraseña de Basic Authentication, además de Cliente y Tocken para la cuenta del comercio.
¿Tiendli calcula automáticamente la tarifa de UES?
No a partir de esta API, porque la documentación recibida no expone un endpoint de cotización. Configurá en Tiendli el costo o las reglas de precio que correspondan a tu acuerdo comercial. Así no se crea un envío real solamente para averiguar el precio.
¿Puedo ofrecer retiro en agencias UES?
Sí. Al activar Retiro en agencia, Tiendli consulta las agencias habilitadas por UES y las muestra en el checkout para que el comprador elija el punto de retiro.
¿Qué significa “Automático” en el servicio UES?
Es la opción recomendada. Para entregas a domicilio, Tiendli toma el servicio por defecto informado en la codiguera de la localidad. Para pickup, prioriza un servicio de retiro habilitado para esa zona y envía además el ID de la agencia; UES puede ajustar el servicio final de acuerdo con sus reglas de cobertura.
¿UES cubre todo Uruguay con puntos de retiro?
La propuesta comercial de UES informa más de 80 puntos de pickup y drop-off. Tiendli no mantiene una lista fija: consulta la API de agencias para utilizar la información vigente.
¿Las tarifas comerciales de UES quedan fijas en Tiendli?
No. La propuesta comercial es propia de cada cuenta y puede cambiar. Tiendli guarda la configuración de precio que defina el comercio y no publica como tarifa universal los valores de una propuesta particular. Revisá también con UES los impuestos, tasas postales, levantes, seguros y descuentos por volumen que correspondan a tu acuerdo.
¿Qué notificaciones recibe el comprador?
Tiendli envía a UES el teléfono y el email del destinatario. UES informó para esta integración que puede mantener al destinatario actualizado por sus canales habilitados, incluyendo correo electrónico y WhatsApp según la configuración comercial. Los modelos entregados incluyen avisos y recordatorios de retiro en pickup; algunos mensajes de tránsito e ingreso a pickup figuran todavía como funcionalidades en proceso de implementación, por lo que el canal y evento efectivo dependen del servicio habilitado por UES.
¿Puedo pedir a UES que retire los paquetes en mi local?
Sí. La API admite un nodo de levante opcional. Tiendli permite activarlo y seleccionar el tipo Standard, MELI Flex o En el día. Si UES ya te asignó un ID para una dirección recurrente, conviene guardarlo en la configuración.
¿Puedo descargar un reporte de las guías UES?
Sí. Desde la conexión de UES en Tiendli podés elegir un rango de fechas y descargar el CSV generado por la API oficial de reportes de UES. Es útil para conciliación y control operativo.
¿Puedo generar una etiqueta de devolución?
La respuesta de UES contempla una guía de devolución cuando la cuenta utiliza un servicio con promesa de devolución. Si UES lo habilita para tu marca, Tiendli conserva ese número junto a la guía de ida y permite abrir la etiqueta de devolución desde el pedido.
¿Puedo cancelar una guía UES desde Tiendli?
No. UES indicó para esta integración que las cancelaciones no se realizan automáticamente. Tiendli deja la gestión de la anulación en UES para no mostrar una cancelación local que el operador no haya confirmado.
¿Por qué UES puede rechazar una localidad?
Barrio/localidad debe coincidir con la codiguera de UES, incluyendo su nombre oficial. Tiendli consulta esa lista y normaliza la comparación, pero al crear la guía envía el texto canónico que devolvió UES.
¿Qué pasa si hago doble clic en Crear envío?
Tiendli usa un bloqueo corto y guarda la guía en el pedido. Si ya existe un tracking UES, los siguientes intentos recuperan ese envío en lugar de generar una segunda guía.
¿La integración de UES reemplaza Correo Uruguayo o Gestión Post?
No. UES es otro operador independiente. El comercio puede tener varios operadores activos siempre que su plan de Tiendli permita la cantidad de integraciones configuradas.