Controla direcciones de Estados Unidos

En este documento, se aborda la validación de direcciones específica de 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 del valor que se muestra.

Dado que este objeto no siempre se propaga, no debes depender de 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 muestra 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:

  • La validez de la dirección
  • Si falta un número de sububicación en la dirección
  • Si el número de sububicación no existe en el sistema de datos del USPS

El servicio muestra uno de los cuatro valores dpvConfirmation o no muestra ningún valor dpvConfirmation. En la siguiente tabla, se muestra el comportamiento recomendado que debe usar tu lógica 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 Compila tu lógica de validación.

Valor

Comportamiento

Descripción

N

o vacío

Corrige la dirección

No se confirmó la DPV de la dirección.

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

D

Corrige la dirección

Se confirmó la DPV de la dirección solo para el número principal, y faltaba la información del número secundario.

Esto significa que el número de ubicación ingresado 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 sububicación válido. En otras palabras, faltaba la sububicación en la entrada.

S

Confirma la dirección

Se confirmó la DPV de la dirección 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 ubicación ingresado existe en la ruta ingresada, pero la sububicación proporcionada no existe dentro de ese edificio, según el USPS.

Y

Acepta la dirección

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

Esto significa que el USPS puede realizar la entrega en la dirección por completo, incluido el número de sububicación, si corresponde.

En el resto de esta sección, se analizan situaciones del mundo real que usan los códigos 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, es válida.

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

Esta es una señal extremadamente fuerte de que este número de ubicación 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: Corrige la dirección

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

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

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

Ejemplo de DPV S: Confirma la dirección

En este ejemplo, se usa un número de sububicació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 muestra: S

Esto indica que, si bien 1600 Amphitheatre Parkway existe como una dirección que puede aceptar correo, la sububicación 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 realizar una corrección.

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 muestra: Y

El USPS puede realizar la entrega en la dirección por completo. Esto te da un grado de confianza muy alto de que la API mostró una dirección de buena calidad y que puedes usarla tal como se proporcionó.

Nota: La 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 abarcan las marcas de seguridad que se proporcionan en los datos del USPS para las direcciones creadas artificialmente. Esta medida de seguridad está diseñada para evitar la creación artificial de una lista de direcciones mediante la detección de cuándo una dirección enviada parece haberse creado artificialmente y no se obtuvo de forma legítima. Esto debería ocurrir muy rara vez.

Cuando el USPS identifica una dirección creada artificialmente, el errorMessage campo de la uspsData propiedad 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.