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

Controla direcciones de Estados Unidos

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

Cómo usar los datos del USPS en tu flujo de trabajo
Campos de verificación de puntos 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 de la devolución.

Debido a que este objeto no siempre se propaga, no debes depender de esta propiedad como el único medio para validar las direcciones, sino que debes incorporar el veredicto y los componentes de 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 entregar el pedido en la dirección proporcionada.

Puedes usar este campo para determinar lo siguiente:

validez.
si falta un número de subpredio en la dirección.
si el número de subpredio 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 la descripción general del flujo de trabajo en Usa la respuesta de validación.

Valor	Comportamiento	Descripción
N o vacío	Cómo corregir la dirección	La dirección no se confirmó como DPV. Esto significa que el USPS no reconoce el número de la propiedad ingresado que existe en la calle (ruta) ingresada y no puede realizar entregas allí.
D	Cómo corregir la dirección	La dirección se confirmó como DPV solo para el número principal y faltó la información del número secundario. Esto significa que el número de la premisa ingresado existe en la calle ingresada, pero para llegar a una dirección completamente verificada o de entrega, también se debe proporcionar un número de subpremisa válido. En otras palabras, faltaba la subpremisa en la entrada.
S	Confirma la dirección	La dirección se confirmó como 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 ingresado existe en la ruta ingresada, pero la subdirección proporcionada no existe en ese edificio, según el USPS.
Sí	Acepta la dirección	La dirección se confirmó como DPV para los números principales y secundarios. Esto significa que USPS puede entregar la dirección por completo, incluido el número de subpredio, si corresponde.

En el resto de esta sección, se analizan situaciones del mundo real que 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, es 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 muy claro de que este número de propiedad no existe en esta ruta. Al igual que con otras direcciones problemáticas, el 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 subpremisa, que es una parte obligatoria de la dirección. Para ver esto, usa la dirección de la demo sin información de subpremisa.

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

Esto confirma que faltaba la subpremisa en la entrada. Para obtener un DPV de Y, se debe incluir una subpremisa válida como parte de la entrada. Por ejemplo, puedes incluir una subpremisa válida de FL 4 (4° 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 subpremisa 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 correo, la subpremisa 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, 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 brinda un grado muy alto 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, como una corrección ortográfica.

Mensajes de seguridad para direcciones de EE.UU.

En esta sección, se describen 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 forma legítima. Esto debería ser muy poco frecuente.

Cuando 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.