Processar endereços dos Estados Unidos

Este documento aborda a validação de endereço específica para os Estados Unidos:

Dados do USPS no seu fluxo de trabalho

Ao validar endereços nos Estados Unidos, o serviço da API Address Validation também pode preencher a parte uspsData do retorno.

Como esse objeto nem sempre é preenchido, não confie nessa propriedade como o único meio de validar endereços, mas incorpore o veredito e os componentes de endereço ao seu sistema também.

Verificação do ponto de entrega do USPS (DPV)

Como parte da resposta uspsData, o campo dpvConfirmation retorna um único caractere para informar se o USPS pode fazer entregas no endereço fornecido.

Use esse campo para determinar o seguinte:

  • da validade do endereço.
  • se um número de sublocal estiver ausente no endereço.
  • se o número do sublocal não existir no sistema de dados do USPS.

O serviço retorna um dos quatro valores dpvConfirmation ou não retorna um valor dpvConfirmation. A tabela abaixo mostra o comportamento recomendado que sua lógica precisa usar para cada um dos cinco resultados possíveis. Para mais detalhes sobre essa lógica, consulte Visão geral do fluxo de trabalho em Usar a resposta de validação.

Valor

Comportamento

Descrição

N ou vazio

Corrigir o endereço

O endereço não foi confirmado com DPV.

Isso significa que o USPS não reconhece o número do local inserido existente na rua inserida (trajeto) e não pode realizar a entrega nesse local.

D

Corrigir o endereço

O endereço foi DPV confirmado apenas para o número principal, e as informações do número secundário estavam ausentes.

Isso significa que o número do local inserido existe na rua inserida, mas, para chegar a um endereço totalmente verificado/para entrega, é necessário fornecer um número de sublocal válido. Em outras palavras, o sublocal estava ausente na entrada.

S

Confirmar o endereço

O endereço foi confirmado como DPV apenas para o número principal, e as informações do número secundário estavam presentes, mas não foram confirmadas.

Isso significa que o número do local inserido existe no trajeto inserido, mas o sublocal fornecido não existe no edifício, de acordo com o USPS.

S

Aceitar o endereço

O endereço foi confirmado como DPV para números primários e secundários.

Isso significa que o endereço pode ser entregue totalmente pelo USPS, incluindo o número do sublocal, se aplicável.

O restante desta seção discute cenários reais que usam os códigos DPV.

Exemplo de DPV N: corrigir o endereço

Este exemplo usa um número de rua não existente em um endereço válido.

  • Endereço inserido: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • Região: EUA
  • O campo dpvConfirmation retorna: N

Esse é um sinal extremamente forte de que esse número de local não existe nesse trajeto. Assim como acontece com outros endereços problemáticos, o sistema precisa solicitar correções ao usuário.

Exemplo de DPV D: corrigir o endereço

Este exemplo usa o escritório do Google em Nova York, mas não contém um sublocal que seja uma parte obrigatória do endereço. Isso é possível usando o endereço na demo sem informações de sublocal.

  • Endereço inserido: 111 8th Avenue, New York, NY, 10011
  • Região: EUA
  • O campo dpvConfirmation retorna: D

Isso confirma que o sublocal estava ausente na entrada. Para chegar a um DPV de Y, um sublocal válido precisa ser incluído como parte da entrada. Por exemplo, é possível incluir um sublocal válido de FL 4 (4o andar) para receber um valor dpvConfirmation de Y.

Exemplo de DPV S: confirme o endereço

Este exemplo usa um número de sublocal que não existe no edifício:

  • Endereço inserido: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • Região: EUA
  • O campo dpvConfirmation retorna: S

Isso indica que, embora a 1600 Amphitheatre Parkway exista como um endereço que aceite correspondência, o sublocal Ste 101 não é uma parte válida do endereço. O sistema precisa confirmar essas informações com o usuário e oferecer uma oportunidade de correção.

Exemplo de DPV Y: aceitar o endereço

Este exemplo usa o endereço do Googleplex em Mountain View, CA, como um endereço de qualidade conhecido.

  • Endereço inserido: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Região: EUA
  • O campo dpvConfirmation retorna: Y

O endereço é totalmente entregue pelo USPS. Isso dá a você um grau de confiança muito alto de que a API retornou um endereço de boa qualidade e que você pode usá-lo conforme fornecido.

Observação: o DPV não indica se a API Address Validation fez alguma mudança na entrada, como uma correção ortográfica.

Mensagens de segurança para endereços dos EUA

Esta seção aborda as sinalizações de segurança fornecidas nos dados do USPS para endereços criados artificialmente. Essa medida de segurança foi projetada para impedir a criação artificial de uma lista de endereços, detectando quando um endereço enviado parece ter sido construído artificialmente e não foi obtido de maneira legítima. Isso é uma ocorrência muito rara.

Quando o USPS identifica um endereço criado artificialmente, o campo errorMessage da propriedade uspsData da resposta contém uma mensagem de erro descrevendo o problema. Exemplo:

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.