La API de validación de la dirección es una solución inteligente para resolver detalles de contacto inexactos y permite una entrega más rápida y precisa de paquetes. La API da el formato adecuado a la información ingresada sobre la dirección del destinatario y que parece una dirección válida y arroja una dirección del mundo real que probablemente es la prevista.

La API también proporciona anotaciones sobre deficiencias en la dirección ingresada o cambios realizados a esa información para dar como resultado esa dirección del mundo real. Puede usar esta API para validar y resolver la información de la dirección del destinatario antes de que envíe un paquete.

Nota: No uses esta API para determinar la posibilidad de entrega de una dirección. FedEx no ofrece servicio de entrega para cada dirección válida. FedEx no hace envíos a apartados postales excepto a través de FedEx Ground® Economy (antes conocido como FedEx SmartPost®).

Esta API permite validar y corregir la información de la dirección del destinatario antes de enviar un paquete. Las direcciones precisas en la etiqueta de envío ayudarán a eliminar retrasos en las entregas y cargos adicionales por corrección de dirección (debido a direcciones mal formadas).

Nota:

• Los resultados de la resolución de la dirección varían de acuerdo al país o territorio.
• La dirección ingresada en la solicitud se compara con los datos de referencia en la base de datos de FedEx y se arroja la dirección que coincide.

Funcionalidades de la API de validación de la dirección

• Proporciona coincidencias con una dirección a nivel de calle.
• Recibe actualizaciones mensuales en su base de datos de direcciones.
• Distingue entre direcciones comerciales y residenciales si encuentra una coincidencia exacta.
• Actualmente no verifica los números de suite o departamento.

Capacidades de la API de validación de la dirección

• Completa las direcciones del destinatario incompletas. En algunos casos, la API de validación de la dirección agrega información faltante, dependiendo de la verificación de la información brindada frente a los datos de referencia. La API de validación de dirección no puede agregar información secundaria faltante (por ejemplo, departamento o suite) en este momento.
• Recibe actualizaciones mensuales en su base de datos de direcciones.
• Corrije una dirección del destinatario no válida. Por ejemplo, la corrección de un código postal incorrecto para que coincida con el resto de la entrada.
• Determinar si una dirección es comercial o residencial para aumentar la exactitud de la tarifa estimada de cortesía. Se aplica solamente a direcciones de Estados Unidos y Canadá.
• Confirma la validez e integridad de las direcciones en varios países en estas regiones: Estados Unidos, Canadá, América Latina, Europa y Oriente Medio y Asia Pacífico. Ahora puede validar información sobre la dirección nacional e internacional antes de enviar un paquete, eliminando demoras innecesarias en la entrega y cargos adicionales por servicio.
• Proporciona coincidencias a nivel de calle.
• Se pueden revisar hasta 100 direcciones en una solicitud de API.

Países o territorios que admiten la API de validación de dirección

Puede usar la API de validación de dirección en los siguientes países para validar y corregir las direcciones del destinatario para entregas más eficientes.

Nota:la información arrojada por la solicitud de validación de la dirección es para uso sugerido solamente.

Aviso legal: La información brindada aquí es confidencial y propiedad de FedEx, proporcionada como una cortesía a su solicitud. No se podrá distribuir o divulgar a terceros ninguna parte de esta información sin el consentimiento por escrito de FedEx. Esta información refleja la clasificación actual de la dirección como comercial o residencial, en la base de datos de entrega de FedEx y está sujeta a cambios. Al facilitar esta información, FedEx no garantiza su exactitud presente o futura y no garantiza que los paquetes enviados a esas direcciones serán facturados de acuerdo con la clasificación comercial o residencial proporcionada aquí. Proporcionar esta información no será considerado como una alteración de los términos de la relación entre las partes. Consulte la Guía de servicios de FedEx y el acuerdo de precios de cuentas vigente para ver los términos y condiciones que rigen para los envíos y los cargos de FedEx.

Validar dirección

Use este extremo para validar y resolver direcciones de entrada; arroja direcciones del mundo real. Los detalles de la dirección se proporcionan y validan para resolver una dirección. Una dirección se considera resuelta cuando la dirección de entrada coincide con la información conocida de referencia.

La información que debe ingresarse en relación con esta solicitud es:

• Líneas de calle
• Ciudad (opcional)
• Código de estado o provincia (opcional)
• Código postal (opcional)
• Código de país

Nota: El código de estado o el nombre de la ciudad son suficientes cuando el cliente hace un envío a un país que no cuenta con código postal.

La API de validación de la dirección arroja una dirección del mundo real al realizar las siguientes operaciones en la dirección de entrada:

• En el primer paso, la API intenta normalizar la dirección de entrada. Esto puede incluir reemplazar identificadores viales comunes tales como calle y autopista con sus abreviaciones estándar, tales como C. y AU., así como reordenar componentes de la dirección. Si una dirección de entrada no se puede normalizar, la dirección resuelta arrojada será la dirección de entrada. Los valores no relacionados con la dirección se descartan.
• En el segundo paso, la API intenta estandarizar la dirección normalizada, encontrando una dirección real o posible que probablemente se trate de la prevista por el usuario. Si esa estandarización falla, la dirección resuelta arrojada será la forma normalizada de la dirección de entrada. Consulte los elementos arrojados para ayudar a determinar los problemas con la dirección presentada.
• Ciertos elementos de esa dirección normalizada también se arrojarán. Si la estandarización es exitosa, la dirección resuelta arrojada será la dirección del mundo real. En este caso, se arrojarán varios elementos adicionales de la dirección estandarizada y la información sobre cómo se derivó de la dirección normalizada.

Valores de devolución de la API de validación de la dirección

Si la dirección arrojada incluye los siguientes valores para los atributos a continuación, entonces la dirección es válida:

• Estado de la dirección es Estandarizado
• Atributos de direcciones resueltas son Verdaderos
• Punto de entrega válido (DPV) es Verdadero
• Dirección interpolada es Falsa

Si no están enlistados, use los atributos adicionales para determinar los posibles problemas con los valores de la dirección.

Para obtener más información sobre los atributos de dirección, consulte Atributos de dirección.

Si el de mensaje de salida para el cliente arrojado como resultado es INTERPOLATED.STREET.ADDRESS, existe la posibilidad de que la dirección no sea válida. Para obtener más información sobre el código de mensaje del cliente, consulte la descripción de elementos del mensaje para el cliente.

Urbanización (solo Puerto Rico): esta palabra descriptiva, utilizada generalmente en áreas urbanas de Puerto Rico, es una parte importante del formato de la dirección, ya que describe la ubicación de una calle específica. En Puerto Rico, se pueden encontrar nombres de calles y rangos de numeración de calles repetidos dentro del mismo código postal. Estas calles pueden tener los mismos rangos de los números de las casas. En estos casos, se necesita el nombre de la urbanización para identificar correctamente la ubicación de una dirección en particular.

Por ejemplo: Sr Pedro Rivera Urb Hermosillo 123 Calle 1 Bayamon, PR 00961-1212.

Anotaciones

La API de validación de la dirección arroja como resultados anotaciones con cada dirección validada y arrojada. Las anotaciones le proporcionan información sobre las deficiencias, si existen, y los cambios realizados a la dirección ingresada para llegar a una dirección del mundo real.

La API de validación de dirección usa datos de referencia para determinar la clasificación de una dirección dada. La clasificación para una dirección funcional se calcula independientemente del proceso de validación de dirección y se basa en los comentarios del personal operativo con fuentes de datos comerciales utilizadas solo para confirmación.

La API de validación de la dirección tiene solo cuatro clasificaciones posibles para direcciones: desconocida, comercial, residencial y combinada. Todas las direcciones comienzan con la clasificación 'desconocida' y permanecen así hasta que las reglas comerciales de validación de dirección determinen que su clasificación debe cambiar. Una ubicación solo consigue una clasificación 'mixta' si es una dirección con múltiples inquilinos y contiene unidades comerciales y residenciales.

Nota: el servicio de FedEx Express proporciona una línea de dirección adicional (línea 3 de dirección) para las direcciones de los destinatarios. Esta información de dirección adicional proporciona detalles de ubicación más completos y precisos, lo que mejora su probabilidad de obtener una dirección precisa.

Las direcciones del mundo real se clasifican como sigue:

Dirección comercial

Una dirección comercial es una dirección que se usa para designar su lugar principal de negocios. Es donde se supone que opera su negocio, pero es posible que no siempre sea el caso.

Una dirección comercial es la ubicación oficial de las instalaciones de una compañía. Puede ser desde la dirección de la casa de una persona hasta una instalación multimillonaria, como las que las grandes compañías tecnológicas prefieren, y más.

Dirección residencial

Se aplicará una tarifa de entrega residencial para los envíos dentro de los EE. UU. a hogares o residencias privadas, incluidos los lugares donde se opere una empresa desde el hogar. Use FedEx Home Delivery para entregas residenciales mediante FedEx Ground en 1 día hábil, según la distancia al destino.

Ejemplo:

• Rectoría
• Convento
• Casa parroquiaa
• Residentes de viviendas de unidades múltiples, como las siguientes:
  • Edificios de apartamentos
  • Condominios
  • Residencias estudiantiles

• Una residencia donde se venden o distribuyen productos

A continuación se muestran algunos consejos útiles para usar la API de validación de la dirección:

• Use el espaciado correcto: asegúrese de que los espacios estén colocados correctamente y evite los espacios innecesarios.
• Use la ortografía correcta: evite errores de ortografía y tipográficos. Además, asegúrese de usar correctamente el número cero (0) y la letra O.
• Evite los caracteres especiales: Absténgase de utilizar caracteres especiales no requeridos para la dirección, tales como los puntos después de las abreviaturas (utilice Ave en lugar de Ave.).
• Proporcione información adicional de la dirección y la calle: Al proporcionar información adicional de la dirección, puede aumentar la exactitud de los resultados de la dirección.
  • Número del edificio o de la casa: 1, 1A, 1½, Uno
  • Nombre de la calle: Main, George Washington, 42^nd
  • Sufijo de la calle: ruta, avenida, R, Av.
• Ingrese la ciudad, estado/provincia y código postal: Proporcionar los tres aumentará la exactitud de los resultados de la dirección.
• Ingresa la calle y la dirección en orden: los elementos de las direcciones por lo general siguen un formato que comienza con el número de edificio o casa seguido de un elemento predireccional, el nombre de la calle, tipo o sufijo de la calle, un elemento posdireccional, designación del departamento, número del departamento o designación y número del buzón privado.
• Use las abreviaciones correctas: el servicio postal de EE. UU. y de Canadá tienen abreviaciones estándar para estado/provincia, sufijo de la calle y designaciones de departamento o unidad.
  • Una abreviatura no estándar puede generar escasos resultados de búsqueda.
  • Si no está seguro sobre la abreviatura, no la utilice.
• Urbanización: El nombre de una urbanización denota un área, sector o desarrollo residencial dentro de un área geográfica.

Por ejemplo:

• Número de casa o edificio: 1, 1A, Uno.
• Nombre de la calle como Principal, George Washington, 42nd.
• Sufijo de la calle como ruta, avenida, R, Av.
• Ingrese Ciudad y Estado/Provincia y Código Postal: brindar todos estos datos aumentará la precisión de los resultados. La porción CÓDIGO POSTAL+4 del código postal no es necesaria para verificar una dirección.
• Use las abreviaturas correctas: el Servicio Postal de los Estados Unidos y las autoridades postales en otros países cuentan con abreviaturas estándar para las designaciones de estado o provincia, sufijo de calle y departamento o unidad. Una abreviatura no estándar puede generar escasos resultados de búsqueda. Si no está seguro sobre la abreviatura, no la utilice.
• Considere devolver los comentarios de la respuesta de validación al usuario para darle la opción de elegir la dirección más correcta para él.

• No uses esta API para determinar la posibilidad de entrega de una dirección. FedEx no ofrece servicio de entrega para cada dirección válida. FedEx no hace envíos a apartados postales (excepto a través de FedEx Ground® Economy (antes conocido como FedEx SmartPost^®).
• La información arrojada por la dirección resuelta es para uso sugerido solamente.
• Se pueden revisar hasta 100 direcciones en una solicitud.
• Los campos mínimos requeridos varían de acuerdo con los países.

  Por ejemplo, para las direcciones de EE. UU., se necesita al menos una línea de dirección y un código postal o un código de ciudad o estado, pero para direcciones en AU, el código de estado puede omitirse aun sin un código postal.

• Los resultados de la resolución de la dirección pueden variar de acuerdo al país o territorio.

Nota: la API de validación de la dirección puede no aplicar para todos los países. Consulte la sección Países o territorios que admiten la API de validación de dirección.