La API de validación de direcciones es una solución inteligente que permite corregir datos de contacto incorrectos y lograr una entrega de paquetes más ágil y con mayor precisión. Esta API ajusta el formato de los datos introducidos sobre la dirección del destinatario que se parezcan todo lo posible a una dirección válida y devuelve una dirección real que probablemente sea la prevista.

La API también proporciona anotaciones sobre deficiencias en la dirección introducida o modificaciones que se hayan tenido que hacer para llegar a esa dirección real. Puede utilizar esta API para validar y corregir la información sobre la dirección del destinatario antes de expedir un paquete.

Nota: No utilice esta API para determinar si una dirección es apta para una entrega. FedEx no ofrece servicios de entrega en todas las direcciones válidas. FedEx no realiza entregas en apartados de correos excepto a través de FedEx Ground® Economy (antes conocido como FedEx SmartPost®).

Esta API permite validar y corregir la información sobre la dirección del destinatario antes de expedir un paquete. Al disponer de una dirección precisa en la etiqueta de envío se pueden eliminar los retrasos en la entrega y las tasas adicionales por corrección de la dirección (con formato incorrecto).

Nota:

• Los resultados de la resolución de direcciones varían según el país/territorio.
• La dirección introducida en la solicitud se compara con los datos de referencia que hay en la base de datos de FedEx y se obtiene la dirección que coincida.

Funcionalidades de la API de validación de direcciones

• Proporciona coincidencias de dirección en cuanto a la calle.
• La base de datos de direcciones se actualiza mensualmente.
• Distingue entre direcciones comerciales y residenciales si se encuentra una coincidencia exacta.
• Actualmente, no verifica números de apartamento o puerta.

Prestaciones de la API de validación de direcciones

• Completa las direcciones de destinatarios incompletas: en algunos casos, la API de validación de direcciones podrá añadir información que falte en función de la comparación entre la información proporcionada y los datos de referencia. La API de validación de direcciones no puede añadir información secundaria faltante (es decir, apartamento o puerta) en este momento.
• La base de datos de direcciones se actualiza mensualmente.
• Modifica las direcciones de destinatarios inválidas: por ejemplo, corrige un código postal incorrecto para que coincida con el resto de la información introducida.
• Determina si una dirección es comercial o residencial para aumentar la precisión de la tarifa estimada de cortesía. Aplicable únicamente a direcciones de Estados Unidos y Canadá.
• Confirma la validez e integridad de las direcciones de multitud de países en las siguientes regiones: Estados Unidos, Canadá, Latinoamérica, Europa, Oriente Medio y Asia-Pacífico. Ahora podrá validar información sobre direcciones nacionales e internacionales antes de expedir un paquete, eliminando retrasos innecesarios en la entrega y tasas adicionales de servicio.
• Proporciona coincidencias en cuanto a la calle.
• Se pueden comprobar hasta 100 direcciones en una solicitud de API.

Países/territorios compatibles con la API de validación de direcciones

Puede usar la API de validación de direcciones de FedEx en los siguientes países para corroborar y corregir las direcciones de destinatarios y lograr unas entregas eficientes.

Nota: la información proporcionada a través de una solicitud de validación de direcciones es solo una recomendación.

Descargo de responsabilidad legal: los datos aquí proporcionados son propiedad de FedEx y son información confidencial, ofrecida como cortesía tras su solicitud. Queda prohibida la distribución o la publicación de parte de estos datos de cualquier forma a terceros sin autorización escrita de FedEx. Esta información refleja la clasificación de direcciones de FedEx entre comercial y residencial en la base de datos de direcciones de entrega de FedEx y está sujeta a cambios. Al proporcionar esta información, FedEx no garantiza su precisión presente o futura y no garantiza que los paquetes enviados a estas direcciones se facturen de acuerdo con la clasificación comercial/residencial que se ofrece. El hecho de proporcionar esta información no podrá modificar las condiciones de la relación entre las partes. Consulte la Guía de servicio de FedEx y cualquier acuerdo de precios de la cuenta que se pueda aplicar para conocer los términos y condiciones que regulan los envíos y los cargos de FedEx.

Validar dirección

Use este punto de conexión para validar y corregir direcciones introducidas y obtener direcciones reales. Se proporcionan y se validan los detalles de la dirección para poder encontrar la solución adecuada. Se indica que la dirección es correcta cuando la dirección introducida coincide con los datos de referencia.

Los datos necesarios asociados a esta solicitud son:

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

Nota: el código del estado o el nombre de la ciudad son suficientes cuando el cliente realiza un envío a un país sin código postal.

La API de validación de direcciones muestra una dirección real efectuando lo siguiente en las direcciones introducidas:

• En primer lugar, la API intenta normalizar la dirección introducida. Esto puede incluir la sustitución de identificadores comunes de vías, como calles y avenidas, por sus abreviaturas estándares (c. y avda.), así como la reordenación de componentes de la dirección. Si la dirección introducida no puede normalizarse, las direcciones corregidas obtenidas serán la dirección introducida. Los valores ajenos a la dirección se descartan.
• En segundo lugar, la API intenta estandarizar la dirección normalizada encontrando una dirección posible o real que probablemente sea la prevista por el usuario. Si la estandarización falla, las direcciones corregidas obtenidas serán la forma normalizada de la dirección introducida. Consulte los elementos obtenidos para ayudar a determinar los problemas con la dirección enviada.
• También se mostrarán algunos elementos de dicha dirección normalizada. Si la estandarización falla, las direcciones corregidas obtenidas serán la dirección real. En tal caso, también se muestran distintos elementos adicionales de la dirección estandarizada e información sobre cómo se llegó a ella a partir de la dirección normalizada.

Valores de retorno de la API de validación de direcciones

Si la dirección obtenida incluye los siguientes valores para los atributos que se indican a continuación, la dirección se considera válida:

• El estado de la dirección es «estandarizada»
• Los atributos de la dirección corregida son «correctos»
• El punto de entrega válido es «correcto»
• La dirección interpolada es «incorrecta»

Si estos atributos no se incluyen en la lista, utilice los atributos adicionales para identificar los posibles problemas con los valores de la dirección.

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

Si se obtiene el mensaje INTERPOLATED.STREET.ADDRESS, es posible que la dirección no sea válida. Si desea más información acerca de los códigos de mensajes, consulte la descripción del elemento del mensaje.

Anotaciones

La API de validación de direcciones proporciona anotaciones con cada dirección validada y obtenida. Las anotaciones proporcionan información sobre las deficiencias, en caso de que las haya, y de los cambios realizados en la dirección introducida hasta llegar a la dirección real.

La API de validación de direcciones emplea datos de referencia para determinar la clasificación de una dirección específica. La clasificación para una dirección funcional se calcula independientemente del proceso de validación de direcciones y se basa en los comentarios realizados por el personal operativo, con fuentes de datos comerciales utilizadas exclusivamente para la confirmación.

La API de validación de direcciones solo tiene cuatro clasificaciones posibles para las direcciones: desconocida, comercial, residencial y mixta. Todas las direcciones comienzan siendo «desconocida» y siguen teniendo esa clasificación hasta que las normas comerciales de validación de direcciones determinen que la clasificación debe cambiar. Una ubicación solo puede tener la clasificación «mixta» cuando se trate de una dirección de varios residentes y contenga tanto unidades comerciales como residenciales.

Nota: el servicio FedEx Express proporciona una línea de dirección adicional (línea de dirección 3) para las direcciones del destinatario. Esta información adicional de la dirección ofrece datos sobre la ubicación más completos y precisos, por lo que aumentan las posibilidades de conseguir una dirección exacta.

Las direcciones reales se clasifican de la siguiente manera:

Dirección comercial

Una dirección comercial es una dirección utilizada para designar su sede central comercial. Se supone que es desde donde opera su empresa, aunque es posible que no sea siempre así.

Una dirección comercial es la ubicación oficial de las instalaciones de una compañía. Podría tratarse de una dirección residencial de una persona o de recintos multimillonarios de grandes compañías tecnológicas, así como cualquier caso situado entre ambos extremos.

Dirección residencial

Se aplicará un cargo por entrega residencial a los envíos dentro de EE. UU. realizados a un domicilio o residencia privada, incluidos los lugares en los que se opere un negocio desde un domicilio. Use FedEx Home Delivery, a través de FedEx Ground, para entregas residenciales en un día hábil, dependiendo de la distancia al destino.

Ejemplo:

• Rectoría
• Convento
• Casa parroquial
• Residentes de edificios con varias viviendas, como:
  • Edificios de apartamentos
  • Condominios
  • Residencias universitarias

• Una residencia en la que se vendan o se distribuyan productos

A continuación se muestran algunos consejos para utilizar la API de validación de direcciones:

• Compruebe el uso correcto de los espacios: asegúrese de que los espacios introducidos son correctos y evite espacios innecesarios.
• Cuide la ortografía: evite errores ortográficos y tipográficos, y asegúrese de que haya un uso correcto del número cero (0) y de la letra O.
• Evite el uso de caracteres especiales: por favor, no utilice caracteres especiales que no sean necesarios para la dirección, como puntos después de abreviaturas (mejor Ave en lugar de Ave. para la abreviatura de «avenida» en inglés).
• Proporcione información adicional sobre la dirección y la calle: al proporcionar información adicional sobre la calle, aumentará la precisión de los resultados sobre la dirección.
  • Número del edificio o de la casa: 1, 1A, 1½, uno
  • Nombre de la calle: Main, George Washington, 42^nd
  • Tipo de vía pública: Road, Avenue, Rd, Ave
• Introduzca la ciudad, la provincia/estado y el código postal: al proporcionar estos tres elementos se mejora la precisión de los resultados sobre la dirección.
• Introduzca la calle y la dirección en orden: los elementos de una dirección suelen seguir un formato que empieza por el número del edificio o la casa, seguido de un elemento predireccional, el nombre de calle, el tipo de vía pública, un elemento posdireccional, la designación del apartamento, el número del apartamento y/o la designación y el número del apartado de correos privado.
• Use abreviaciones correctas: USPS y Canada Post tienen abreviaciones estándares para estados/provincias, tipos de vía pública y designaciones de apartamentos o unidades.
  • Una abreviatura no estándar puede provocar resultados de búsqueda inexactos.
  • Si no está seguro acerca de una abreviatura, no la use.

Por ejemplo:

• Número del edificio o de la casa, como 1, 1A o uno.
• Nombre de calle, como Main, George Washington, 42nd.
• Tipo de vía pública, como Road, Avenue, Rd, Ave.
• Introduzca la ciudad, la provincia/estado y el código postal: al proporcionar toda la información sobre la dirección se mejora la precisión de los resultados. La parte ZIP+4 del código postal no es necesaria para comprobar una dirección.
• Use abreviaturas correctas: el Servicio Postal de Estados Unidos y las autoridades postales de otros países definen abreviaturas estándares para estados/provincias, tipos de vía pública y designaciones de apartamentos o unidades. Una abreviatura no estándar puede provocar resultados de búsqueda inexactos. Si no está seguro acerca de una abreviatura, no la use.
• Considere enviar la respuesta de la validación de dirección al usuario para darle la oportunidad de elegir la dirección más correcta.

• No utilice esta API para determinar si una dirección es apta para una entrega. FedEx no ofrece servicios de entrega en todas las direcciones válidas. FedEx no realiza entregas en apartados de correos (excepto a través de FedEx Ground® Economy (antes conocido como FedEx SmartPost^®).
• La información obtenida a través de una dirección corregida es solo una recomendación.
• Se pueden comprobar hasta 100 direcciones en una solicitud.
• Los campos obligatorios varían en función de los países.

  Por ejemplo, para las direcciones de Estados Unidos, es necesario introducir al menos una línea de dirección y un código postal o una ciudad o un código de estado, pero para direcciones AUS (formato de dirección de Australia), el código de estado puede omitirse incluso sin introducir un código postal.

• El resultado de la corrección de direcciones puede variar en función del país o el territorio.

Nota: puede que la API de validación de direcciones no sea aplicable a todos los países. Consulte la sección de países/territorios compatibles con la API de validación de direcciones.