주소 유효성 검사 API는 부정확한 연락처 정보를 확인하여 패키지를 정확하고 신속하게 배송할 수 있게 돕는 스마트한 솔루션입니다. 이 API는 올바른 주소와 유사하게 입력된 수취인 주소 정보를 재구성하여 원래 의도한 주소일 가능성이 높은 실제 주소를 알려줍니다.

또한 입력된 주소의 결함에 대한 주석을 제공하거나 입력된 내용을 실제 주소지에 맞게 변경해 줍니다. 이 API를 사용하면 패키지를 발송하기 전에 수취인 주소 정보를 검증하고 확인할 수 있습니다.

참고: 이 API는 특정 주소지로의 배송 가능성을 판단하는 데 사용할 수 없습니다. 유효한 주소라도 FedEx에서 배송 서비스를 제공하지 않을 수 있습니다. FedEx는 사서함으로 배송하지 않습니다(FedEx Ground® Economy(이전 명칭: FedEx SmartPost®)를 통한 서비스 제외).

이 API를 사용해 패키지를 발송하기 전에 수취인 주소 정보를 확인하고 수정할 수 있습니다. 발송 라벨에 정확한 주소를 기재하면 배송 지연과 추가적인 주소 수정 수수료(잘못된 형식의 주소로 인한 수정)를 피할 수 있습니다.

참고:

• 주소 수정 결과는 국가/지역마다 다릅니다.
• 요청에 입력된 주소를 FedEx 데이터베이스에 있는 참조 데이터와 비교해 일치하는 주소를 반환합니다.

주소 유효성 검사 API 기능

• 도로명 수준의 주소 일치 정보를 확인합니다.
• 매월 주소 데이터베이스 업데이트를 받습니다.
• 정확히 일치하는 주소가 있는 경우 사업지 주소와 거주지 주소를 구분합니다.
• 현재는 건물 또는 아파트 동/호를 검증할 수 없습니다.

주소 유효성 검사 API 성능

• 불완전한 수취인 주소를 완전하게 수정합니다. 제공된 정보를 참조 데이터와 비교 확인하여 주소 유효성 검사 API가 누락된 정보를 추가할 수도 있습니다. 현재는 주소 유효성 검사 API 에 누락된 보조 정보(예: 아파트 또는 입주 호수)를 추가해주는 기능은 없습니다.
• 매월 주소 데이터베이스 업데이트를 받습니다.
• 유효하지 않은 수취인 주소를 수정합니다. 예를 들어 잘못된 우편번호를 나머지 입력 정보에 맞게 수정해 줍니다.
• 사업지 주소와 거주지 주소를 판별해 서비스 요금견적의 정확성을 높입니다. 미국 및 캐나다 주소에만 적용됩니다.
• 미국, 캐나다, 남미, 유럽, 중동 및 아시아 태평양 지역 내 다수의 국가에서 주소의 유효성과 완전성을 확인합니다. 이제 패키지를 발송하기 전에 국내 및 국제 주소 정보를 확인해 불필요한 배송 지연과 추가적인 서비스 수수료를 방지할 수 있습니다.
• 도로명 수준의 일치 정보를 확인합니다.
• 한 번의 API 요청으로 최대 100개의 주소를 확인할 수 있습니다.

주소 유효성 검사 API를 지원하는 국가/지역

효율적인 배송을 위해 다음과 같은 국가에서 FedEx 주소 유효성 검사 API를 사용하여 수취인 주소를 확인하고 수정할 수 있습니다.

참고: 주소 유효성 검사 요청을 통해 반환된 정보는 권장용으로만 참고하십시오.

법적 책임 부인: 여기에서 제공하는 데이터는 FedEx의 독점 기밀 정보이며, 사용자의 요청에 따라 편의를 위해 제공됩니다. 이 데이터의 어떤 부분도 FedEx의 서면 허가 없이 제3자에게 배포하거나 공개할 수 없습니다. 이 데이터는 FedEx 배송 주소 데이터베이스에 있는 현재의 FedEx 주소 수준 사업지/거주지 분류를 반영하며 변경될 수 있습니다. 이 정보의 제공과 관련하여 FedEx는 해당 정보의 현재 또는 향후 정확성을 보장하지 않으며, 이러한 주소로 발송된 패키지의 요금이 여기에서 제공하는 사업지/거주지 분류에 따라 청구된다고 보장하지 않습니다. 이 정보를 제공하는 것이 양 당사자 간의 관계 조건에 변화를 주는 것으로 여겨져서는 안 됩니다. FedEx 발송 및 요금에 적용되는 이용 약관은 FedEx 서비스 가이드 및 해당하는 모든 고객번호 요금 책정 계약을 참고하십시오.

주소 유효성 검사

이 엔드포인트를 사용하여 입력된 주소를 검증 및 해석하고 실제 주소를 반환할 수 있습니다. 주소를 해석하기 위해 주소 세부정보가 제공되고 검증됩니다. 입력된 주소가 알려진 참조 데이터와 일치하는 경우 주소가 해석되었다고 명시됩니다.

이 요청과 관련된 필수 입력 정보는 다음과 같습니다.

• 상세 주소
• 시/군(선택 사항)
• 주 또는 도 코드(선택 사항)
• 우편번호(선택사항)
• 국가 코드

참고: 고객이 우편번호가 없는 국가로 발송하는 경우에는 주 코드 또는 도시명만 제공하면 됩니다.

주소 유효성 검사 API는 입력된 주소에 대해 다음과 같은 작업을 수행해 실제 주소를 반환합니다.

• 첫 번째 단계로 API가 입력 주소의 정규화를 시도합니다. 여기에는 street 및 parkway와 같은 일반 도로 식별자를 ST 및 PKWY와 같은 표준 약어로 대체하고 주소 구성 요소의 순서를 변경하는 작업이 포함될 수 있습니다. 입력 주소를 정규화할 수 없는 경우 해석되어 반환된 주소가 입력 주소가 됩니다. 주소가 아닌 값은 무시됩니다.
• 두 번째 단계에서 해당 API는 사용자가 선택한 것으로 보이는 주소 또는 실제 주소를 찾아 정규화된 주소의 표준화를 시도합니다. 표준화에 실패하는 경우 수정된 주소는 입력된 주소의 정규화된 형태로 반환됩니다. 반환된 요소를 참고하여 제출된 주소에 해당하는 문제를 확인하십시오.
• 더불어 표준화된 주소의 특정 요소가 함께 반환됩니다. 표준화에 실패하는 경우 수정된 주소는 실제 존재하는 주소로 반환됩니다. 이 경우에는 표준화된 주소의 여러 추가적인 요소 그리고 표준화된 주소를 실제 존재하는 주소로 변환한 방법에 대한 정보도 함께 반환됩니다.

주소 유효성 검사 API에서 반환하는 값

반환된 주소가 다음의 속성 및 값을 포함하는 경우 해당 주소는 유효합니다.

• 주소의 주(State)가 표준화됨
• 수정된 주소의 속성값이 참임
• 배송지 유효(DPV) 값이 참임
• 중간에 삽입된 주소가 거짓임

앞서 나열된 내용이 포함되지 않은 경우에는 또 다른 추가 속성을 통해 주소 값에 발생할 수 있는 문제를 확인하십시오.

주소 속성에 대한 자세한 내용은 주소 속성 페이지를 확인하시기 바랍니다.

반환된 출력 고객 메시지가 INTERPOLATED.STREET.ADDRESS인 경우에는 주소가 유효하지 않을 가능성이 있습니다. 고객 메시지 코드에 관한 자세한 내용은 고객 메시지 요소 설명을 참고하시기 바랍니다.

도시화(푸에르토리코만 해당): 보통 푸에르토리코의 도시 지역에서 사용되는 이 설명자는 주소 형식의 중요한 부분으로 특정 도로의 위치를 설명합니다. 푸에르토리코에는 동일한 우편번호를 대상으로 중복되는 도로 이름과 번지수 범위가 있습니다. 이러한 도로는 동일한 번지수 범위를 가질 수 있습니다. 이 경우 특정 주소의 주소를 식별하는 데 도시화 이름이 필요합니다.

예: Sr Pedro Rivera Urb Hermosillo 123 Calle 1 Bayamon, PR 00961-1212

주석

주소 유효성 검사 API는 주소를 확인하고 반환할 때마다 주석을 함께 반환합니다. 주석은 주소에 결함이 있는 경우 이를 알려주고, 입력된 주소가 실제 존재하는 주소로 변환되는 과정에서 변경된 내용을 알려줍니다.

주소 유효성 검사 API는 참조 데이터를 사용해 해당 주소의 분류를 확인합니다. 기능적 주소의 분류는 주소 유효성 검사 절차와 관계없이 처리되며 확인 용도로만 사용되는 상업 데이터 자료와 함께 운영자의 피드백을 바탕으로 이루어집니다.

주소 유효성 API는 주소를 알 수 없음, 비즈니스, 거주, 혼합 등 네 가지로 분류합니다. 모든 주소는 '알 수 없음' 분류로 시작해 주소 유효성 검증 비즈니스 규칙이 이를 변경해야 한다고 확정하기까지 이 상태로 유지됩니다. 여러 세대가 거주하는 주소지로 비즈니스 세대와 거주 세대가 모두 포함된 위치만 '혼합'으로 분류됩니다.

참고: FedEx Express 서비스는 수취인 주소 입력시 추가 주소 입력줄(주소 입력줄 3)을 제공합니다. 이러한 추가 주소 정보는 정확한 주소를 얻을 수 있는 확률을 높여주는 더 완전하고 정확한 위치 세부 정보를 제공합니다.

실제 주소는 다음으로 분류됩니다.

비즈니스 주소

비즈니스 주소는 고객의 주요 비즈니스 장소를 지정하는데 사용되는 주소 입니다. 이는 고객이 비즈니스를 운영하는 장소일 수 있지만 항상 그렇지는 않습니다.

비즈니스 주소는 회사 부지의 공식적인 위치입니다. 이러한 주소는 누군가의 집 주소에서 대형 기술 회사가 선호하는 수 백만 달러 규모의 캠퍼스까지 어떤 것이든 해당할 수 있습니다.

거주지 주소

가정집에서 운영되는 비즈니스를 포함해 집 또는 개인 거주지로 발송되는 미국 내 발송물에는 거주지 배달 요금이 적용됩니다. FedEx Ground를 통해 FedEx Home Delivery를 이용하면 도착지까지의 거리에 따라 영업일 기준 1일 이내에 배송될 수 있습니다.

예:

• 교구 목사관(Rectory)
• 수녀원
• 목사관(Parsonage)
• 다음과 같은 다세대 주택
  • 아파트 건물
  • 콘도(Condominiums)
  • 대학 기숙사

• 제품이 판매 및/또는 유통되는 거주지

다음은 주소 유효성 검사 API 이용에 관한 몇 가지 유용한 팁입니다.

• 올바른 공백 사용: 공백이 바른 위치에 있으며 불필요한 공백은 없는지 확인합니다.
• 올바른 철자 사용: 오탈자가 없는지 다시 한 번 확인합니다. 또한 숫자 영(0)과 문자 O를 바르게 사용했는지 확인합니다.
• 특수문자 사용 금지: 약어 뒤에 찍는 마침표(예: Ave와 Ave.)와 같이 주소에 불필요한 특수문자를 사용하지 않습니다.
• 추가 주소 및 도로 정보 제공: 추가적인 주소 정보를 제공해 주소 결과의 정확성을 높일 수 있습니다.
  • 건물 또는 번지수 - 1, 1A, 1½, One
  • 도로 이름 - Main, George Washington, 42^nd
  • 상세 도로 이름 - Road, Avenue, Rd, Ave
• 도시, 주/도 및 ZIP 또는 우편번호 입력: 세 가지 정보를 모두 입력하면 주소 결과의 정확성을 높일 수 있습니다.
• 도로 및 주소를 순서대로 입력: 도로 주소의 경우 일반적으로 건물 번호 또는 번지수로 시작하여 도로 이름, 도로 유형 또는 상세 도로 이름으로 이어지는 선방향(pre-directional) 표기 형식이거나 또는 아파트 이름, 아파트 동 및/또는 사서함 이름 및 번호 등 후방향(post-directional) 표기 형식입니다.
• 올바른 약어 사용: U.S. Postal Service(미 우편 서비스) 및 Canada Post(캐나다 우편국)은 주/도, 상세 도로 이름, 아파트 또는 세대 이름에 대한 표준 약어를 정하고 있습니다.
  • 표준 약어에 해당하지 않는 경우 검색 결과의 정확성이 떨어질 수 있습니다.
  • 확실하지 않은 약어는 사용하지 마십시오.
• 도시화 - 도시화 이름은 지리학적 지역 내 지역, 구역 또는 거주지 개발을 나타냅니다.

예시:

• 건물 또는 번지수 - 1, 1A, One
• 도로 이름 - Main, George Washington, 42nd
• 상세 도로 이름 - Road, Avenue, Rd, Ave
• 도시, 주/도 및 우편번호 입력: 주소 정보를 모두 입력하면 주소 결과의 정확성을 높일 수 있습니다. 주소 확인에 ZIP와 우편번호 4자리는 필요하지 않습니다.
• 올바른 약어 사용: U.S. Postal Service(미 우편 서비스)와 다른 국가의 우편 당국은 주/도, 상세 도로 이름, 아파트 또는 세대 이름에 대한 표준 약어를 정하고 있습니다. 표준 약어에 해당하지 않는 경우 검색 결과의 정확성이 떨어질 수 있습니다. 확실하지 않은 약어는 사용하지 마십시오.
• 사용자에게 주소 유효성 검증 응답 피드백을 반환해 가장 정확한 주소를 직접 선택할 수 있도록 해보십시오.

• 이 API는 특정 주소지로의 배송 가능성을 확인하는 데 사용할 수 없습니다. 유효한 주소라도 FedEx에서 배송 서비스를 제공하지 않을 수 있습니다. FedEx는 사서함으로 배송하지 않습니다(FedEx Ground® Economy(이전 명칭: FedEx SmartPost^®)를 통한 서비스 제외).
• 수정된 주소를 통해 반환된 정보는 제안용으로 참고만 하십시오.
• 한 번의 요청으로 최대 100개의 주소를 확인할 수 있습니다.
• 최소 필수 입력 필드는 국가마다 다릅니다.

  예를 들어 미국 주소의 경우 최소 한 개의 주소 입력줄과 우편번호 또는 도시 및 주(state) 코드가 필수지만 AUS(호주 주소 형식) 주소는 주 코드 및 우편번호까지 생략될 수 있습니다.

• 주소 수정 결과는 국가/지역마다 다를 수 있습니다.

참고: 주소 유효성 검사 API를 이용할 수 없는 국가도 있습니다. 주소 유효성 검사 API 지원 국가/지역 섹션을 참고하세요.