Argentina
Cómo integrar Moova con Tiendli
Conectá tu cuenta B2B de Moova para cotizar y gestionar entregas de última milla directamente desde Tiendli.
¿Qué permite hacer?
- Cotizar envíos con la API B2B v2.
- Crear envíos Regular o Next Day.
- Trabajar en flujo manual (DRAFT) o semi-automático (READY).
- Obtener etiquetas PDF y ZPL.
- Sincronizar estados y tracking.
- Cancelar un envío temprano o solicitar devolución después del retiro.
- Recibir cambios de estado mediante webhook.
Antes de empezar
- Cuenta B2B habilitada en Moova.
- APP ID del ambiente correspondiente.
- APP KEY del ambiente correspondiente.
- Código postal y dirección completa del comercio.
- Peso, ancho, alto y largo de todos los productos físicos.
Cómo conectar la cuenta
- 1
Ingresá a Panel de Tiendli → Logística → Operadores logísticos.
- 2
Buscá Moova y elegí Testing o Producción.
- 3
Ingresá APP ID, APP KEY y el código postal del origen.
- 4
Elegí Regular o Next Day.
- 5
Elegí flujo Manual para crear en DRAFT o Semi-automático para crear en READY.
- 6
Guardá la conexión. Tiendli validará las credenciales y mostrará una URL de webhook.
- 7
Configurá esa URL en el área API/Webhook de Moova para recibir actualizaciones automáticamente.
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.
- Moova necesita dirección completa, ciudad, provincia y código postal para cotizar.
- Tiendli envía peso y dimensiones reales del carrito a /v2/budgets.
- La tarifa vuelve a consultarse en el servidor cuando se confirma la orden.
- Si cambia la dirección o deja de existir una tarifa válida, Tiendli exige volver a elegir el envío.
Preparar y despachar el pedido
- Abrí el pedido y presioná “Crear envío Moova”.
- Tiendli utiliza un internalCode estable por pedido para que un reintento pueda recuperar un envío existente en vez de duplicarlo.
- Con flujo manual el envío queda DRAFT; desde el pedido podés marcarlo READY cuando esté preparado.
- Con flujo semi-automático se crea directamente READY para que Moova pueda continuar la operación.
Etiquetas
- Podés abrir la etiqueta PDF desde el pedido.
- También está disponible ZPL para impresoras térmicas compatibles.
Seguimiento
- El webhook de Moova notifica cambios y Tiendli vuelve a consultar el envío en la API.
- También podés actualizar el estado manualmente desde el pedido.
- READY o CONFIRMED no marcan la venta como enviada; Tiendli espera movimiento físico como PICKEDUP o INTRANSIT.
- DELIVERED puede avanzar el pedido a Entregado.
Cancelaciones
- En estados tempranos podés solicitar CANCELED desde Tiendli.
- Después del retiro, Tiendli utiliza TOBERETURNED para solicitar la devolución cuando corresponde.
- Estas acciones son logísticas: no cancelan ni reembolsan automáticamente el pago de la venta.
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é diferencia hay entre Manual y Semi-automático?
Manual crea el envío en DRAFT y te permite prepararlo antes de marcarlo READY. Semi-automático lo crea directamente READY.
¿Regular y Next Day usan la misma tarifa?
No necesariamente. Tiendli cotiza utilizando el tipo de envío configurado para tu conexión Moova.
¿Por qué Moova no aparece en el checkout?
Revisá que la cuenta esté conectada, que el origen y destino tengan dirección completa y código postal, y que todos los productos tengan peso y dimensiones.
¿Por qué un envío READY no figura como enviado en Tiendli?
READY significa que el paquete está preparado para la operación, no que ya hubo movimiento físico. Tiendli espera un estado como PICKEDUP, PICKUP o INTRANSIT.