Processar endereços dos Estados Unidos

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

Dados da 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 a única maneira de validar endereços. Em vez disso, incorpore o veredito e os componentes de endereço ao seu sistema também.

Verificação do ponto de entrega (DPV, na sigla em inglês) do USPS

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

Use esse campo para determinar o seguinte:

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

O serviço retorna um de quatro valores dpvConfirmation ou não retorna nenhum valor dpvConfirmation. A tabela abaixo mostra o possível comportamento que sua lógica pode usar para cada um dos cinco resultados possíveis. Para mais detalhes sobre essa lógica, consulte Exemplos de fluxos de trabalho em Crie sua lógica de validação.

Valor

Comportamento

Descrição

N ou vazio

Corrigir o endereço

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

Isso significa que os Correios dos EUA não reconhecem o número do imóvel inserido na rua (via) informada e provavelmente não podem fazer a entrega no local.

D

Adicionar um sublocal

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

Isso significa que o número do imóvel inserido existe na rua informada, mas, para chegar a um endereço totalmente verificado/entregável, também é necessário fornecer um número de subimóvel válido. Em outras palavras, a subpremissa estava faltando na entrada.

S

Confirmar o endereço

O endereço foi confirmado pelo 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 imóvel inserido existe na rota informada, mas o subimóvel fornecido não existe no edifício, de acordo com o USPS.

S

Aceitar o endereço

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

Isso significa que o endereço pode ser entregue pelo USPS, incluindo o número do sub-local, 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 inexistente 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 indicador muito forte de que esse número de premissa não existe na rota. Assim como ocorre com outros endereços problemáticos, seu sistema precisa pedir correções ao usuário.

Exemplo de DPV D: adicionar um sublocal

Este exemplo usa o escritório do Google em Nova York, mas não contém um sub-local, que é uma parte obrigatória do endereço. Para conferir isso, use o endereço na demonstração sem informações de subunidade.

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

Isso confirma que a subpremissa estava faltando na entrada. Para chegar a um DPV de Y, uma subpremissa válida precisa ser incluída como parte da entrada. Por exemplo, inclua uma subpremissa válida de FL 4 (4º andar) para receber um valor dpvConfirmation de Y.

Exemplo de DPV: confirmar o endereço

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

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

Isso indica que, embora 1600 Amphitheatre Parkway seja um endereço válido, a subunidade Sala 101 não é uma parte válida do endereço. Recomendamos confirmar essas informações com o usuário e dar a ele a oportunidade de fazer uma 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 válido conhecido.

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

O endereço é totalmente entregável pelo USPS. Isso dá um grau muito alto de confiança de que a API retornou um endereço de boa qualidade, e você provavelmente pode usá-lo como fornecido. Como sempre, considere seu nível de risco ao decidir se vai pedir ou não a confirmação do cliente.

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 nos EUA

Esta seção aborda as flags de segurança fornecidas nos dados do USPS para endereços criados artificialmente. Essa medida de segurança foi criada para evitar a criação artificial de uma lista de endereços. Ela detecta quando um endereço enviado parece ter sido construído artificialmente e não obtido de forma legítima. Isso é muito raro.

Quando o USPS identifica um endereço criado artificialmente, o campo errorMessage da propriedade uspsData da resposta contém uma mensagem de erro que descreve 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.