Menu

Configuración inicial de LocFix AI

Qué hace

Corrige la comuna, distrito o municipio mientras el comprador escribe, autocompleta direcciones reales y muestra un mapa del punto de entrega. Menos pedidos devueltos por direcciones mal escritas.

Qué necesitas
  • Shopify con la pantalla de pago personalizable (en Configuración → Pantalla de pago aparece el botón Editar)
  • Cuenta de Google Cloud con facturación activa (solo para autocompletado y mapa)
Tiempo y países

2 minutos lo obligatorio, 10 con autocompletado y mapa · 🇨🇱 Chile · 🇵🇪 Perú · 🇲🇽 México

1 Instala la app y elige tu plan

Shopify App Store → LocFix AI → Instalar

Al abrir la app verás tu plan. Haz clic en Empezar plan Starter y aprueba el cargo: los primeros días son de prueba gratis y puedes cancelar cuando quieras desde la misma pantalla.

Pantalla de inicio de LocFix AI en el admin de Shopify

2 Agrega la validación de dirección al checkout

Configuración → Pantalla de pago → Editar → Apps (ícono de cuadrados)

  1. En el editor, abre Apps y busca check-direction.
  2. Toca ⊕ en check-direction-extension (LocFix AI) y déjalo bajo Entrega → Dirección de entrega.
  3. Haz clic en Guardar.

Agregar el bloque de validación de LocFix en el editor del checkout

Con esto la validación ya funciona: si el comprador escribe Nunoa, LocFix la corrige a Ñuñoa; si la comuna no existe en la región elegida, le pide revisarla antes de continuar. No necesita API key.

Opcional: personaliza los mensajes. Haz clic en el bloque check-direction-extension y, en Configuración del bloque, cambia cada texto que ve el comprador (carga, dirección válida, comuna inválida, sugerencia, error) o activa «Confirmar dirección ingresada». Si un campo queda vacío, se usa el mensaje por defecto.

Mensajes personalizables del bloque de validación

3 Activa LocFix como autocompletado opcional

Editor de la pantalla de pago → Configuración (⚙) → Formulario de dirección

Solo el paso 2 es obligatorio. Con el bloque de validación, LocFix ya corrige la comuna. El autocompletado (pasos 3 y 4) y el mapa (paso 5) son opcionales y necesitan una key de Google.

Activa Autocompletado de direcciones, elige LocFix AI y guarda. A partir de ahora las sugerencias que ve el comprador vienen de LocFix, ajustadas a cada país (en Chile, por ejemplo, completan la comuna correcta).

Elegir LocFix AI como proveedor de autocompletado

Así se ve en el checkout: el comprador escribe la calle y elige una dirección real con su comuna.

Sugerencias de LocFix en el checkout

4 Crea tu API key de Google (servidor) para autocompletado y mapa

console.cloud.google.com → APIs y servicios

  1. Biblioteca: activa Places API y Geocoding API.
  2. Credenciales → Crear credenciales → Clave de API.
  3. Edita la key:
    • Restricciones de API: Restringir clave → solo Places API y Geocoding API.
    • Restricciones de aplicaciones: Ninguna.
  4. Copia la key. En el editor, en Configuración (⚙) → Formulario de dirección, toca Editar configuración de la app bajo LocFix AI y pégala en Api google Maps. Guarda.

Restringir la key a Places API y Geocoding API

Pegar la key en la configuración del autocompletado

No la restrinjas por sitio web. LocFix usa esta key desde su servidor, nunca en el navegador del comprador. Con una restricción de «referentes HTTP», Google la rechaza y el autocompletado deja de funcionar.

5 Muestra un mapa de la dirección opcional

Editor de la pantalla de pago → Apps → checkout-ui-address-map

El mapa ayuda al comprador a confirmar dónde llega su pedido. Necesita una segunda key, de navegador:

Campo del bloque de mapaQué keyAPIsRestricción
API key de Google Maps (navegador)Una nuevaMaps JavaScript APISitios web: https://tutienda.cl/* y https://tutienda.myshopify.com/*
API key de Google Maps (servidor)La del paso 4Places API + Geocoding APINinguna

Activa Mostrar mapa de la dirección, pega las dos keys y guarda. Puedes ajustar el título, el zoom y el mensaje de ubicación aproximada.

Bloque de mapa con las dos keys

6 Prueba un checkout

Abre tu tienda, agrega un producto y ve al checkout. Escribe una dirección con la comuna mal escrita (Nunoa, Stgo Centro, Penalolen) y comprueba que:

  • ✅ aparecen sugerencias de direcciones reales,
  • ✅ la comuna se corrige sola,
  • ✅ el mapa muestra el punto (si lo activaste).

Checkout con la dirección corregida y el mapa

Problemas frecuentes

SíntomaCausa probableSolución
No aparecen sugerenciasLocFix no está elegido como proveedorPaso 3
No aparecen sugerenciasLa key no tiene Places API o está restringida por sitio webPaso 4: revisa las APIs y deja «Ninguna» en aplicaciones
«The provided API key is expired» o «API key not valid»La key se borró o se regeneró en Google CloudCrea una nueva y pégala otra vez
El mapa no cargaLa key de navegador no tiene Maps JavaScript API o no permite tu dominioPaso 5
La comuna no se corrigeFalta el bloque de validación en el paso InformaciónPaso 2
¿Algo no funciona? Escríbenos a [email protected] con el nombre de tu tienda y te ayudamos a configurarlo.
// OP.04 · Contacto

¿Tienes preguntas? Estamos aquí para ayudarte

Si tienes preguntas sobre nuestras aplicaciones o necesitas soporte, no dudes en contactarnos. Estamos aquí para ayudarte a optimizar tu tienda Shopify.