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 se propaga, no debes confiar en esto propiedad como el único medio para validar direcciones, pero, en su lugar, incorporar el veredicto y abordar los componentes en tu sistema.
Verificación de puntos de entrega (DPV) del USPS
Como parte de la respuesta uspsData
, el campo dpvConfirmation
muestra un solo
para informarle 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
mostrar un valor dpvConfirmation
. La siguiente tabla muestra las recomendaciones
que tu lógica debe usar para cada uno de los 5 resultados posibles. Para ver más
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 establecimiento ingresado. existente 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, y la
faltaba información del número secundario. |
S |
Confirma la dirección |
La dirección se confirmó con DPV solo para el número principal, y la había información del número secundario, 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 al 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 completar la entrega de la dirección, lo que incluye la el número de departamento, 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 premisa no existe en esta ruta. Al igual que con otras direcciones problemáticas, el sistema debería indicar al usuario para que lo corrijan.
Ejemplo de DPV D: corregir la dirección
En este ejemplo, se usa la oficina de Google en Nueva York, pero no contiene un que es una parte obligatoria de la dirección. Puedes ver esto usando 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 llegar a un DPV
de Y, se debe incluir una sublocalización válida como parte de la entrada. Por ejemplo:
puedes incluir una ubicación secundaria válida de FL 4 (4o piso) para obtener una
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 local no es una parte válida de la dirección. Tu sistema debe confirmar esta información con el usuario y proporcionar un para que puedas hacer 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 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 muy alto grado de la confianza de que la API devolvió una dirección de buena calidad, y de que se puede usar según se proporcione.
Nota: El DPV no indica si la API de Address Validation realizó alguna cambios en la entrada, como una corrección ortográfica.
Mensajes de seguridad para direcciones de EE.UU.
Esta sección trata sobre las marcas de seguridad proporcionadas en los datos del USPS para direcciones creadas artificialmente. Esta medida de seguridad está diseñada para evitar que la creación artificial de una lista de direcciones mediante la detección del envío de una dirección parece haber sido construido artificialmente y no obtenido legítimamente. Esto debería ocurrir con muy poca frecuencia.
Cuando el USPS identifica una dirección creada artificialmente, errorMessage
de la propiedad uspsData de la respuesta contiene un
mensaje de error en el que se 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.