Controla direcciones de Estados Unidos

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

Datos de USPS en tu flujo de trabajo

Cuando se validan direcciones en los Estados Unidos, el servicio de la API de Address Validation también puede propagar la parte de uspsData del resultado.

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

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 entregas a la dirección proporcionada.

Puedes usar este campo para determinar lo siguiente:

  • la validez de la dirección.
  • si falta un número local en la dirección.
  • si este número no existe en el sistema de datos del USPS.

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

Valor

Comportamiento

Descripción

N o vacío

Corregir la dirección

La dirección no fue confirmada por el DPV.

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

D

Corregir la dirección

Se confirmó 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 local ingresado existe en la calle ingresada. Sin embargo, para llegar a una dirección completamente verificada o de entrega, también se debe proporcionar un número de local válido. En otras palabras, faltaba el sublocal en la entrada.

S

Confirma la dirección

Se confirmó la dirección 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 local secundario proporcionado no existe dentro de ese edificio, según el USPS.

Y

Aceptar la dirección

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

Esto significa que el USPS puede entregar la dirección por completo, incluido el número de registro secundario, si corresponde.

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

Ejemplo de DPV N: corrige la dirección

En este ejemplo, se usa un número de calle que no existe en una dirección válida.

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

Esta es una indicación extremadamente fuerte de que el número de premisa no existe en esta ruta. Al igual que con otras direcciones problemáticas, tu sistema debe solicitar al usuario que realice correcciones.

Ejemplo de DPV D: corregir la dirección

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

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

Esto confirma que faltaba el sublocal en la entrada. Para llegar a un DPV de Y, se debe incluir una sublocalidad válida como parte de la entrada. Por ejemplo, puedes incluir una sub local válida de FL 4 (4o piso) para obtener un valor de dpvConfirmation de Y.

Ejemplo de DPV S: Confirma la dirección

En este ejemplo, se usa un número inferior al local 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 lo siguiente: S

Esto indica que, aunque 1600 Amphitheatre Parkway existe como una dirección que puede aceptar correo, la dirección secundaria no es una parte válida de la dirección. Tu sistema debe confirmar esta información con el usuario y proporcionar la oportunidad de una corrección.

Ejemplo de DPV Y: acepta la dirección

En este ejemplo, se usa la dirección de Googleplex de Mountain View, California, 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 lo siguiente: Y

El USPS puede entregar la dirección por completo. Esto te da un alto grado de confianza con el hecho de que la API mostró una dirección de buena calidad y de que puedes usarla como se proporciona.

Nota: El DPV no indica si la API de Address Validation hizo 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 proporcionadas en los datos del USPS para las direcciones creadas de forma artificial. Esta medida de seguridad está diseñada para impedir la creación artificial de una lista de direcciones mediante la detección del momento en que una dirección enviada parece haberse construido de forma artificial y no se obtuvo de forma legítima. Esto debería ser un caso muy poco frecuente.

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.