Controla direcciones de Estados Unidos

En este documento, se abarca la validación de direcciones específica para Estados Unidos:

Datos de USPS en tu flujo de trabajo

Cuando se validan direcciones en Estados Unidos, el servicio de la API de Address Validation también puede completar la parte uspsData de la respuesta.

Dado que este objeto no siempre se completa, no debes confiar en esta propiedad como el único medio para validar direcciones, sino que también debes incorporar el veredicto y los componentes de la dirección en tu sistema.

Verificación del punto de entrega (DPV) del USPS

Como parte de la respuesta de uspsData, el campo dpvConfirmation devuelve un solo carácter para informarte si el USPS puede realizar la entrega en la dirección proporcionada.

Puedes usar este campo para determinar lo siguiente:

  • validez de la dirección.
  • Si falta el número de una subinstalación en la dirección
  • Si el número de subinstalación no existe en el sistema de datos del USPS

El servicio devuelve uno de los cuatro valores de dpvConfirmation o no devuelve ningún valor de dpvConfirmation. En la siguiente tabla, se muestra el comportamiento posible que tu lógica podría usar para cada uno de los 5 resultados posibles. Para obtener más detalles sobre esta lógica, consulta Ejemplos de flujos de trabajo en Crea tu lógica de validación.

Valor

Comportamiento

Descripción

N o vacío

Cómo corregir la dirección

No se confirmó la dirección con el DPV.

Esto significa que el USPS no reconoce el número de la propiedad ingresado que existe en la calle (ruta) ingresada y, probablemente, no pueda realizar la entrega allí.

D

Cómo agregar una subinstalación

La dirección se confirmó con el DPV solo para el número principal, y faltaba la información del número secundario.

Esto significa que el número de la dirección ingresada existe en la calle ingresada, pero, para llegar a una dirección completamente verificada o apta para la entrega, también se debe proporcionar un número de subdirección válido. En otras palabras, faltaba la subpremisa en la entrada.

S

Confirma la dirección

La dirección se confirmó con el DPV solo para el número principal, y la información del número secundario estaba presente, pero no se confirmó.

Esto significa que el número de la dirección ingresada existe en la ruta ingresada, pero la subdirección proporcionada no existe dentro de ese edificio, según el USPS.

Y

Acepta la dirección

Se confirmó la dirección con el DPV para el número principal y cualquier número secundario.

Esto significa que el USPS puede entregar el paquete en la dirección, incluido el número de subinstalación, si corresponde.

En el resto de esta sección, se analizan situaciones del mundo real en las que se usan los códigos de DPV.

Ejemplo de DPV N: Corrige la dirección

En este ejemplo, se usa un número de calle inexistente en una dirección que, de otro modo, sería válida.

  • Dirección ingresada: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • Región: EE.UU.
  • El campo dpvConfirmation devuelve: N

Esta es una señal extremadamente fuerte de que este número de instalaciones no existe en esta ruta. Al igual que con otras direcciones problemáticas, tu sistema debe solicitarle al usuario que realice correcciones.

Ejemplo de DPV D: Agrega una subinstalación

En este ejemplo, se usa la oficina de Google en Nueva York, pero no contiene una subinstalación, que es una parte obligatoria de la dirección. Puedes comprobarlo usando la dirección en la demostración sin información de la subinstalación.

  • Dirección ingresada: 111 8th Avenue, Nueva York, NY, 10011
  • Región: EE.UU.
  • El campo dpvConfirmation devuelve: D

Esto confirma que faltaba la subinstalación en la entrada. Para llegar a un DPV de Y, se debe incluir una subpremisa válida como parte de la entrada. Por ejemplo, puedes incluir una subinstalación válida de FL 4 (piso 4) para obtener un valor de dpvConfirmation de Y.

Ejemplo de DPV S: Confirma la dirección

En este ejemplo, se usa un número de subinstalación que no existe dentro del edificio:

  • Dirección ingresada: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • Región: EE.UU.
  • El campo dpvConfirmation devuelve: S

Esto indica que, si bien 1600 Amphitheatre Parkway es una dirección válida, la subinstalación Suite 101 no es una parte válida de la dirección. Puedes considerar confirmar esta información con el usuario y brindarle la oportunidad de corregirla.

Ejemplo de DPV Y: acepta la dirección

En este ejemplo, se usa la dirección de Googleplex en Mountain View, California, como una dirección válida conocida.

  • Dirección ingresada: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Región: EE.UU.
  • El campo dpvConfirmation devuelve: Y

El USPS puede realizar envíos a la dirección. Esto te brinda un alto grado de confianza en que la API devolvió una dirección de buena calidad, y es probable que puedas usarla tal como se proporcionó. Como siempre, ten en cuenta tu nivel de riesgo cuando decidas si solicitarle o no confirmación a tu cliente.

Nota: El DPV no indica si la API de Address Validation realizó algún cambio en la entrada, como una corrección ortográfica.

Mensajes de seguridad para direcciones de EE.UU.

En esta sección, se abordan las marcas de seguridad que se proporcionan en los datos del USPS para las direcciones creadas de forma artificial. Esta medida de seguridad está diseñada para evitar la creación artificial de una lista de direcciones, ya que detecta cuando una dirección enviada parece haberse creado de forma artificial y no se obtuvo de manera legítima. Esto debería ocurrir muy rara vez.

Cuando el USPS identifica una dirección creada de forma artificial, el campo errorMessage de la propiedad uspsData de la respuesta contiene un mensaje de error que describe el problema. Por ejemplo:

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.