Se usó la API de Cloud Translation para traducir esta página.

Controla direcciones de Estados Unidos

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

Usa datos del USPS en tu flujo de trabajo
Campos de la verificación del punto de entrega del USPS (dpv)
Mensajes de seguridad

Datos del USPS en tu flujo de trabajo

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

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

Verificación de puntos 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 de departamento en la dirección.
si el número de sublocalidad no existe en el sistema de datos del USPS.

El servicio muestra uno de los cuatro valores dpvConfirmation o no muestra un valor dpvConfirmation en absoluto. 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 tiene DPV confirmado. 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	La dirección se confirmó con DPV solo para el número principal, pero faltaba la información del número secundario. Esto significa que el número de local ingresado existe en la calle ingresada, pero, para llegar a una dirección completamente verificada o a cargo de entregas, se debe proporcionar un número de departamento secundario válido. En otras palabras, faltaba la premisa 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 local secundario proporcionado no existe dentro de ese edificio, según el USPS.
Y	Aceptar la dirección	Se confirmó la dirección de DPV para los números principales y los secundarios. Esto significa que el USPS puede entregar la dirección en su totalidad, incluido el número de departamento secundario, si corresponde.

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

Ejemplo de DPV N: corregir la dirección

En este ejemplo, se usa un número de calle inexistente 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

Este es un indicador extremadamente contundente de que este número de local no existe en esta ruta. Al igual que con otras direcciones problemáticas, el sistema debe solicitarle correcciones al usuario.

Ejemplo de DPV D: corregir la dirección

En este ejemplo, se usa la oficina de Google en Nueva York, pero no contiene una ubicación secundaria que sea una parte obligatoria de la dirección. Puedes verlo si usas la dirección en la demostración sin información secundaria.

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

Esto confirma que la subpremisa faltaba en la entrada. Para obtener un DPV de Y, se debe incluir una ubicación secundaria válida como parte de la entrada. Por ejemplo, puedes incluir una ubicación secundaria válida de FL 4 (4.o 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 de departamento que no existe en el 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, si bien 1600 Amphitheatre Parkway existe como una dirección que puede aceptar correos, el Ste 101 sublocal no es una parte válida de la dirección. Tu sistema debe confirmar esta información con el usuario y ofrecer la oportunidad de realizar una corrección.

Ejemplo de DPV Y: aceptar 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 lo siguiente: Y

USPS puede realizar la entrega completa de esta dirección. Esto te da un alto grado de confianza de que la API mostró una dirección de buena calidad, y puedes usarla como se proporciona.

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

Mensajes de seguridad para direcciones de EE.UU.

En esta sección, se describen las marcas de seguridad proporcionadas en los datos del USPS para direcciones creadas artificialmente. Esta medida de seguridad está diseñada para evitar la creación artificial de una lista de direcciones a través de la detección del momento en que una dirección enviada parece haberse construido de forma artificial y no se obtuvo legítimamente. Esto debería ocurrir con muy poca frecuencia.

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.