Todas las colecciones
API
Cómo funciona la API Check Address
Cómo funciona la API Check Address

Descubre cómo verificar y corregir tus direcciones de envío con una llamada API

Actualizado hace más de una semana

Con la API CheckAddress de ShippyPro puedes comprobar y validar automáticamente las direcciones de envío de más de 240 países con una sola llamada para todos tus Transportistas.

💡Comprobar las direcciones de envío te permite reducir:

  • Errores durante el proceso de envío y ahorrar tiempo de operaciones.

  • Excepciones en los envíos y ofrecer a tus clientes la mejor experiencia de envío

  • Coste de stock de envíos del transportista, en caso de direcciones con entrega difícil.

En este artículo aprenderás cómo funciona la API CheckAddress, cómo interpreta las respuestas y verás algunos ejemplos.

Índice

1. Antes de empezar

Si es la primera vez que implementas la API de ShippyPro, consulta la sección de introducción de los documentos de la API de ShippyPro. Primero necesitas generar una clave API para autenticarte con la API de ShippyPro.

Para usar la API CheckAddress, necesitas al menos un Transportista conectado a tu cuenta ShippyPro para enviar los parámetros ShippyPro requeridos como CarrierID y CarrierName. Si necesitas obtener el nombre e ID de tu transportista los puedes ver al final de la página Claves API en tu cuenta de ShippyPro.

2. Cómo funciona la validación

La API CheckAddress proporciona validaciones de direcciones del lado del transportista y mediante geocodificación. Si el transportista lo permite, la validación se realiza a través de la del transportista, de lo contrario, la validación de la dirección se realizará a través de la geocodificación.

Los transportistas que por el momento permiten la validación de direcciones a través de su servicio web son UPS (Estados Unidos y Puerto Rico), MyDHL, TNT y GLS. En ambos casos, también se facilita un campo para verificar la precisión de la dirección introducida ("Accuracy").

Esta API es capaz de reconstruir una dirección intentando adivinar fragmentos de una dirección errónea. Por ejemplo, si la respuesta devuelve una precisión del 95%, se refiere a las pistas devueltas y procede de la API de Google (o de la API del transportista; consulta la lista anterior). La respuesta nunca puede ser del 100% porque el sistema nunca puede estar completamente seguro de si la nueva información correcta es la que quería el usuario. Cuanto más insegura esté la API, menor será el porcentaje de exactitud de la nueva dirección.

Omitir la validación del lado del transportista

Puedes omitir la validación de la dirección del transportista configurando los parámetros genéricos como parámetros del transportista. Echa un vistazo aquí si necesitas ayuda para configurar la opción de transportista genérico de ShippyPro.

Validación de direcciones internacionales

La API Check Address admite direcciones internacionales, incluidas direcciones asiáticas y rusas. Ten en cuenta que el formato de las direcciones puede variar de un país a otro y que pueden aplicarse normas específicas a las direcciones y a los parámetros de dirección que deben rellenarse. Verifica y prueba los resultados de la validación de direcciones antes de iniciar el envío.

3. Referencias de API CheckAddress

Visita nuestra Documentación de API para ver un ejemplo de solicitud y respuesta de la API Check Address. Por cada dirección validada puedes obtener los siguientes elementos en la respuesta:

Mensajes de validación de direcciones: pueden devolverse (si están presentes) de la respuesta de la API de transportistas, así como de geocodificación.

Sugerencias de dirección: sólo pueden devolverse (si están presentes) desde la respuesta de la API de transportistas, no desde geocodificación.

Nueva dirección: se compone sustituyendo los campos indicados como incorrectos en la dirección inicial por los nuevos valores sugeridos.

Precisión: es un campo calculado a partir de la API CheckAddress que se basa en la geocodificación. Representa la precisión de la dirección.

¡Habla con nuestros expertos para obtener más información sobre nuestras API y lleva tu negocio al siguiente nivel! 💪

¿Ha quedado contestada tu pregunta?