미국 주소 처리

이 문서에서는 미국에만 적용되는 주소 확인에 대해 다룹니다.

워크플로의 USPS 데이터

미국의 주소를 확인할 때 Address Validation API 서비스는 반환의 uspsData 부분을 채울 수도 있습니다.

이 객체가 항상 채워지는 것은 아니므로 이 객체에 의존해서는 안 됩니다. 속성을 사용하는 대신 확인 결과 및 주소 구성 요소도 시스템에 통합할 수 있습니다.

USPS 배송 지점 인증 (DPV)

uspsData 응답의 일부로 dpvConfirmation 필드는 단일 결과를 반환합니다. 문자를 입력해 주세요.

이 필드를 사용하여 다음을 확인할 수 있습니다.

  • 있습니다.
  • 주소에 부지 번호가 누락된 경우입니다.
  • USPS 데이터 시스템에 하위 부지 번호가 없는 경우

서비스가 4개의 dpvConfirmation 값 중 하나를 반환하거나 다음 값을 반환하지 않습니다. dpvConfirmation 값을 전혀 반환합니다. 아래 표에는 가능한 5가지 결과에 대해 로직에서 사용해야 하는 권장 동작이 나와 있습니다. 자세한 내용은 자세한 내용은 유효성 검사 응답 사용의 워크플로 개요

값

동작

설명

N 또는 비어 있음

주소 수정

주소가 DPV 확인되지 않았습니다.

이는 USPS에서 입력된 사업장 번호를 인식할 수 없음을 의미합니다. 입력한 도로 (경로)에 있는 상품이 있으며 해당 지역으로는 배송할 수 없습니다.

D

주소 수정

주소가 기본 번호로만 DPV가 확인되었으며 보조 전화번호 정보가 누락되었습니다.

즉, 전제는 입력한 번지수가 입력한 도로에 존재하지만 확인된/배송 가능 주소가 있는 경우 유효한 하위 사업장 번호도 확인할 수 있습니다 즉, 입력에서 하위 전제가 누락되었습니다.

S

주소 확인

주소가 기본 번호로만 DPV가 확인되었으며 보조 번호 정보가 있지만 확인되지 않았습니다.

이는 입력한 사업장 번호가 입력된 경로에 존재한다는 의미입니다. 그러나 제공된 하위 건물이 해당 건물 내에 존재하지 않는다고 USPS에 제출합니다.

Y

주소 수락

기본 및 보조 전화번호의 DPV 주소가 확인되었습니다.

즉, USPS에서 하위 부지 번호(해당하는 경우)를 포함하여 완전히 배송할 수 있는 주소입니다.

이 섹션의 나머지 부분에서는 DPV 코드를 사용하는 실제 시나리오를 설명합니다.

DPV N 예시 - 주소 수정

이 예에서는 유효한 주소에 존재하지 않는 번지수를 사용합니다.

  • 입력된 주소: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • 지역: 미국
  • dpvConfirmation 필드는 N을 반환합니다.

이는 이 경로에 이 건물 번호가 없음을 매우 강하게 나타내는 신호입니다. 다른 문제가 있는 주소와 마찬가지로 시스템에서 사용자에게 수정 메시지를 표시해야 합니다.

DPV D 예 - 주소 수정

이 예에서는 뉴욕에 있는 Google 사무실을 사용하지만 주소의 필수 부분인 하위 건물입니다. 이는 하위 온프레미스 정보 없이 데모의 주소를 테스트합니다.

  • 입력한 주소: 111 8th Avenue, New York, NY, 10011
  • 지역: 미국
  • dpvConfirmation 필드는 D을 반환합니다.

이는 하위 전제가 입력에서 누락되었음을 확인합니다. Y의 DPV에 도달하려면 유효한 하위 전제가 입력의 일부로 포함되어야 합니다. 예를 들어 FL 4 (4층)의 유효한 하위 전제를 포함하여 Y의 dpvConfirmation 값입니다.

DPV S 예시 - 주소 확인

이 예에서는 건물 내에 존재하지 않는 하위 부지 번호를 사용합니다.

  • 입력한 주소: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • 지역: 미국
  • dpvConfirmation 필드는 다음을 반환합니다. S

이것은 1600 Amphitheatre Parkway 가 하위 전제인 Ste 101은 주소의 유효한 부분이 아닙니다. 시스템은 사용자에게 이 정보를 확인하고 수정할 기회를 제공해야 합니다.

DPV Y 예 - 주소 수락

이 예에서는 캘리포니아 마운틴뷰에 있는 Googleplex 주소를 알려진 품질 주소로 사용합니다.

  • 입력된 주소: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • 지역: 미국
  • dpvConfirmation 필드는 다음을 반환합니다. Y

USPS에서 전체 주소를 배송합니다. 이를 통해 매우 높은 수준의 API가 양질의 주소를 반환한다는 확신을 줄 수 있으며 확인할 수 있습니다

참고: DPV에는 Address Validation API에서 입력에 대한 변경사항(예: 맞춤법 교정)

미국 주소용 보안 메시지

이 섹션에서는 인위적으로 생성된 주소의 USPS 데이터에 제공된 보안 플래그를 다룹니다. 이 보안 조치는 사용자가 제출한 주소를 감지하여 자동으로 주소 목록을 이는 인위적으로 생성되었고 합법적으로 획득되지 않은 것으로 보입니다. 이러한 상황은 매우 드물게 발생합니다.

USPS에서 인위적으로 생성된 주소를 식별하면 errorMessage 응답의 uspsData 속성 필드에 오류 메시지가 표시됩니다. 예를 들면 다음과 같습니다.

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.