Una de las principales causas de devoluciones logísticas en el comercio contraentrega son las direcciones incompletas, mal escritas o inexistentes. Cada paquete devuelto por la transportadora te cuesta el flete de ida (y en muchas ocasiones el flete de retorno). Modal COD Form PRO v5.0 integra la API oficial Google Maps Address Validation para verificar la precisión geográfica de cada pedido y mostrar un panel de diagnóstico directamente dentro de la orden de WooCommerce (compatible al 100% con HPOS).

1. Cómo Configurar Google Maps Address Validation API

1. Ingresa a tu consola de Google Cloud Platform, habilita la API llamada Address Validation API y genera una clave de API (API Key).
2. En tu WordPress, ve a WooCommerce → Ajustes → Modal COD Form → Prevención de Fraude (Fraud Prevention).
3. Pega tu clave en el campo de Google Maps API Key.
4. Elige el modo de operación:
   • Validación Automática (cod_google_maps_auto_validation = 'yes'): Analiza automáticamente la dirección apenas se crea el pedido (en el hook woocommerce_checkout_order_processed).
   • Validación Manual bajo demanda: Deja desactivada la validación automática si prefieres analizar únicamente los pedidos dudosos pulsando el botón Re-analizar con Google Maps dentro de la pantalla de edición del pedido (ahorrando llamadas a la API).

2. Clasificación Inteligente de Componentes para Latinoamérica (Smart Component Classification)

En países de Latinoamérica (como Colombia, México, Perú o Ecuador), Google Maps confirma con exactitud la calle y la nomenclatura del edificio (PREMISE o SUB_PREMISE), pero no indexa el número interno del apartamento, torre o barrio dentro de conjuntos cerrados.

En la versión 5.0, PRCOD_Google_Maps_Validator separa inteligentemente los componentes:

• Componentes Críticos No Confirmados (_cod_google_maps_critical_unconfirmed): Vía principal (route), número de puerta (street_number) o localidad (locality). Si faltan, el metabox muestra una alerta preventiva para que confirmes la dirección por WhatsApp antes de despachar.
• Componentes Internos / Secundarios (_cod_google_maps_minor_unconfirmed): Apartamento/interior (subpremise), código postal (postal_code) o barrio (neighborhood). Cuando la calle y el edificio ya están confirmados por Google, el plugin los muestra en una caja informativa azul como referencia para el mensajero en lugar de marcarlos como falsos errores.

3. Qué Información Muestra el Metabox en el Pedido de WooCommerce

Al abrir cualquier pedido en WooCommerce → Pedidos, verás el metabox lateral de Validación de Dirección Google Maps con:

• Nivel de Precisión (Granularidad): Etiqueta visual indicando si la coincidencia es exacta a nivel de inmueble (SUB_PREMISE / PREMISE), aproximada a la cuadra (BLOCK / ROUTE) o genérica (OTHER).
• Dirección Estandarizada por Google (formattedAddress): Cómo interpreta Google la dirección frente a lo que escribió el cliente.
• Enlace Directo «Ver en Google Maps»: Coordenadas exactas (lat, lng) para abrir la ubicación en 1 clic.

4. Registro Opcional de Consumo, Costo Estimado y Últimas 10 Peticiones

En la pestaña Fraud Prevention puedes activar la casilla opcional Habilitar registro de peticiones (cod_google_maps_enable_log) (desactivada por defecto para no generar escrituras extra en base de datos en producción). Al activarla, podrás ver:

• El contador mensual de consultas realizadas y el costo estimado en dólares ($0.017 USD por consulta, cubierto por los $200 USD mensuales gratuitos que otorga Google Cloud).
• Una tabla desplegable con las últimas 10 peticiones (fecha, enlace al pedido, latencia en milisegundos, código HTTP y respuesta JSON completa).

Siguientes Pasos

• 🛡️ Combina la validación geográfica con el bloqueo de bots y pedidos falsos en Prevención de Fraude en Contraentrega.
• 📖 Lee nuestra guía práctica en el blog: 7 Estrategias para Reducir las Devoluciones en Pago Contra Entrega.