Cómo está organizada Logística
Logística no es una única configuración. El hub trabaja en tres niveles:
- Capacidades: qué problema logístico querés resolver.
- Tipo de servicio: por ejemplo entrega propia o una capacidad de envío.
- Proveedor: el carrier concreto que querés configurar.
La URL conserva esta navegación mediante los parámetros de capacidad, proveedor y, cuando corresponde, dibujo de zona.
Entrega propia
La configuración de entrega propia permite decidir si el comercio ofrece:
- solo retiro;
- solo domicilio;
- ambos.
También puede definir un radio de cobertura y tramos de precio según distancia.
Radio de delivery
El modo por radio utiliza una distancia en kilómetros alrededor de la ubicación del comercio.
Podés definir tramos con:
- distancia mínima;
- distancia máxima opcional;
- precio de envío.
Antes de publicar, comprobá que los límites no se superpongan y que exista una regla para el rango que realmente querés cubrir.
Zonas de delivery
El modo de zonas sirve cuando un radio circular no representa correctamente tu cobertura.
Podés trabajar con zonas definidas geográficamente, incluyendo áreas dibujadas sobre el mapa, además de criterios territoriales disponibles en la configuración.
La pantalla mantiene un modo explícito de zonas. Si seleccionás el proveedor zones, activa la configuración de zonas; si seleccionás radius, vuelve al modo radio.
Después de configurar una zona hay que comprobar dos casos:
- una dirección que debe estar cubierta;
- una dirección que debe quedar fuera.
La prueba debe hacerse en el checkout público, no solamente mirando el mapa del panel.
WhatsApp de entrega
La configuración de entrega también conserva:
- número de WhatsApp;
- plantilla del mensaje;
- zona horaria de la tienda.
La plantilla debe representar el mensaje operativo que querés utilizar cuando el pedido requiere contacto.
Proveedores logísticos
Cada proveedor tiene metadatos que determinan qué puede hacer el comercio con él:
- si el plan da derecho a utilizarlo;
- si está habilitado globalmente;
- si es configurable;
- si está disponible, beta, próximo o deprecado;
- si es un proveedor nativo o un carrier externo.
No confundas Disponible con Activo. Un proveedor disponible todavía puede no tener credenciales configuradas.
Estados del proveedor
La tarjeta puede mostrar:
- Activo;
- Sin credenciales;
- Inactivo;
- Próximamente;
- un estado de salud del carrier.
Los carriers configurados además pueden mostrar una señal de health.
Configurar un carrier
El flujo general es:
- Entrá en Logística.
- Elegí la capacidad.
- Seleccioná el proveedor.
- Completá las credenciales o parámetros requeridos por ese proveedor.
- Guardá.
- Validá la configuración.
- Hacé un envío de prueba cuando el proveedor lo permita.
- Verificá que el pedido genere y actualice el envío correctamente.
La pantalla distingue configuración del tenant y estado operativo del proveedor.
Salud de integración
Para carriers configurables la pantalla puede mostrar un snapshot de salud.
Usalo como diagnóstico rápido, no como sustituto de una prueba real.
Si aparece error:
- revisá credenciales;
- revisá ambiente;
- comprobá que el proveedor esté habilitado para el plan;
- validá nuevamente;
- revisá webhook y estado del envío;
- si persiste, consultá la documentación oficial del proveedor.
Shipnow, Treggo, Andreani, Cabify y Zipnova
Estos proveedores aparecen como opciones de integración según las capacidades y el estado de disponibilidad del comercio.
Cada uno tiene su propio panel de configuración y requisitos. No asumas que las mismas credenciales o el mismo flujo sirven para todos.
La documentación específica de cada proveedor debe explicar credenciales, ambiente, prueba, creación de envío, tracking y resolución de errores.
Guardado
Los cambios de entrega se guardan mediante la configuración del tenant y, después de guardar correctamente, la pantalla vuelve a cargar el estado desde el servidor.
Por eso un mensaje de “guardado” no debe interpretarse solamente como cambio local de UI: la pantalla vuelve a consultar la configuración persistida.
Problemas frecuentes
El proveedor aparece pero no puedo configurarlo
Revisá entitlement del plan y si el proveedor está marcado como configurable.
Dice Sin credenciales
El proveedor está habilitado pero todavía falta completar su configuración.
La zona está configurada pero el checkout no la aplica
Comprobá que la capacidad de zonas esté realmente activada y probá el checkout con una dirección dentro y otra fuera de cobertura.
El envío se crea pero no actualiza
Revisá el mecanismo de sincronización y webhook del proveedor. La creación y el tracking son dos etapas distintas.