Controla direcciones de Estados Unidos

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

Datos del USPS en tu flujo de trabajo

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

Debido a que este objeto no siempre se propaga, 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 uspsData, el campo dpvConfirmation devuelve un solo carácter para informarte si el USPS puede realizar entregas en la dirección proporcionada.

Puedes usar este campo para determinar lo siguiente:

  • la validez de la dirección.
  • Si falta un número de subpremisa en la dirección
  • si el número de sublocal 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 recomendado que tu lógica debería usar para cada uno de los 5 resultados posibles. Para obtener más detalles sobre esta lógica, consulta Descripción general del flujo de trabajo en Crea tu lógica de validación.

Valor

Comportamiento

Descripción

N

o vacío

Corrige la dirección

La dirección no se confirmó con el DPV.

Esto significa que el USPS no reconoce el número de local ingresado que existe en la calle (ruta) ingresada y no puede realizar entregas allí.

D

Corrige la dirección

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

Esto significa que el número de edificio ingresado existe en la calle ingresada, pero para obtener una dirección completamente verificada o entregable, también se debe proporcionar un número de subedificio válido. En otras palabras, faltaba el sublocal en la entrada.

S

Confirma la dirección

La dirección se confirmó con 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 local ingresado existe en la ruta ingresada, pero el sublocal proporcionado no existe dentro de ese edificio, según el USPS.

Y

Acepta la dirección.

Se confirmó la dirección con el DPV para los números principales y secundarios.

Esto significa que el USPS puede entregar el correo en la dirección, incluido el número de subpremisa, 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 lo contrario, sería válida.

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

Este es un indicador muy claro de que este número de local no existe en esta ruta. Al igual que con otras direcciones problemáticas, tu sistema debería solicitarle al usuario que las corrija.

Ejemplo de DPV D: Corrige la dirección

En este ejemplo, se usa la oficina de Google en Nueva York, pero no se incluye un sublocal, que es una parte obligatoria de la dirección. Puedes ver esto usando la dirección de la demostración sin la información de la subpropiedad.

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

Esto confirma que faltaba el sublocal en la entrada. Para obtener un DPV de Y, se debe incluir una subpremisa válida como parte de la entrada. Por ejemplo, podrías incluir un sublocal válido 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 sublocal 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 lo siguiente: S

Esto indica que, si bien 1600 Amphitheatre Parkway existe como una dirección que puede aceptar correo, el sublocal Ste 101 no es una parte válida de la dirección. Tu sistema debe 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, CA, como una dirección de calidad conocida.

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

El USPS puede entregar el envío a la dirección completa. Esto te brinda un alto grado de confianza en que la API devolvió una dirección de buena calidad y puedes usarla tal como se proporciona.

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 los indicadores 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 forma legítima. Esto debería ocurrir muy pocas veces.

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.