시작하기
FedEx Developer Portal은 사용 중인 애플리케이션에 FedEx를 통합할 수 있는 다양한 애플리케이션 프로그래밍 인터페이스(API)를 제공합니다. 본 지침은 조직을 설정하고, 프로젝트를 생성하고, 통합을 테스트하고, 프로젝트를 프로덕션으로 옮기는 방법과 함께 일부 케이스에 대해 API를 검증하는 방법도 안내해 드립니다.
사용자 유형:
FedEx에서 통합 서비스를 제공하는 세 가지 유형의 사용자에는 FedEx 배송업체, Fedex Compatible Provider라고 하는 검증된 소프트웨어 솔루션, 그리고 검증된 FedEx 인테그레이터 제공자가 있습니다.
FedEx 발송인:
FedEx를 이용해 발송하고 자체 애플리케이션에 FedEx API를 통합하려는 회사입니다.
솔루션 또는 서비스 제공업체:
FedEx API와 통합해 솔루션, 애플리케이션 또는 플러그인을 제작한 다음 FedEx를 이용해 발송하는 외부 조직에 판매 및/또는 배포하려는 회사입니다.
- FedEx Compatible Provider: FedEx Compatible 프로그램을 통한 계약상 합의 내용이 있는 검증된 회사입니다.
- FedEx 인테그레이터 제공자: FedEx 인테그레이터 프로그램을 통한 계약상 합의 내용이 있는 검증된 회사입니다.
아래에서 귀사를 가장 적합하게 설명한 옵션을 선택하세요. 사용자 유형에 상관없이 고객님에 꼭 맞는 시작 경험을 선택할 수 있습니다.
시작하려면 선택하세요.
Which of the following best describes your business?
Select user
- FedEx Shipper: Company who integrates FedEx APIs into their own applications.
- FedEx Compatible Provider: Company validated by the FedEx Compatible program who integrates with FedEx APIs to build a solution, application or plugin that can be sold and/or distributed to an external organization.
- FedEx Integrator Provider: Validated company with a contractual agreement through the FedEx Integrator Program.
필수 구성 요소
FedEx Developer Portal에 로그인하려면 FedEx 사용자 ID가 있어야 하고 조직을 생성해야 합니다.
회사에 조직이 없는 경우 조직을 만들 수 있습니다. 이미 조직이 있는 경우에는 기존 조직에 참여하세요.
새 조직 생성
탐색 모음에서 조직 생성 또는 참여를 클릭합니다.
참고: 조직의 생성자로서 귀하는 자동으로 관리자가 됩니다.
관리자가 수행할 수 있는 작업:
사용자 참여 초대
사용자 역할(예: Contributor, Viewer) 및 프로젝트 할당
발송 고객번호 관리
이러한 역할에 대해 자세히 알아보려면 조직 관리 가이드를 살펴보세요.
회사 유형의 경우, "FedEx 기술을 사용하는 소프트웨어 솔루션을 판매하거나 제공하고 있으며, 검증된 FedEx 인테그레이터 제공자입니다"를 선택합니다.
회사명, 웹사이트 URL, 고유 조직 이름을 입력하세요. 조직명은 귀하의 회사명과 일치하거나 특정 그룹(부서, 사업부, 지역, 위치)을 나타낼 수 있습니다. 이 정보는 요청을 검증하는 데 필요합니다.
참고: 다른 모든 사용자가 알아볼 수 있는 조직 이름을 선택하세요(예: 회사명, 부서, 지역, 위치).
회사의 위치와 소프트웨어 솔루션이 판매 또는 배포될 위치를 지정하세요.
청구 고객번호를 추가하고 고객번호를 인증하세요.
참고: FedEx 인테그레이터 프로그램에 참여하는 발송 및 물류 서비스 제공자로서 본인의 고객번호를 사용해야 합니다. 고객의 FedEx 고객번호를 사용할 수 없습니다.
FedEx 고객번호를 입력하세요. 기존 FedEx 고객번호가 없는 경우, fedex.com에서 개설하거나 FedEx 지원 담당자에게 문의하세요.
고객번호 닉네임 및 고객번호와 연결된 청구 주소를 입력합니다. 다음을 선택하세요.
참고: 청구 주소는 이 고객번호에 대한 FedEx의 기록과 일치해야 합니다. 이 고객번호가 조직의 기본 청구 고객번호가 됩니다.
조직 생성을 완료하려면 고객번호를 인증해야 합니다. 인증 옵션(전화(미국 및 캐나다 내 인테그레이터만 가능), 이메일, 문자)을 선택하고 다음을 선택합니다.
메시지를 수신하면 인증 코드를 입력하고 제출을 선택합니다.
약관에 동의
글로벌 인테그레이터 계약 및 프로그램 매뉴얼을 살펴보세요. 체크박스를 선택해 약관에 동의한 다음 수락을 선택합니다.
확인 화면이 표시됩니다. 필요한 경우 조직 관리를 클릭해 세부정보를 편집하세요.
사용자 초대
참고: 관리자만 사용자를 초대할 수 있습니다.
왼쪽 탐색 메뉴에서 조직 관리를 선택합니다.
사용자 탭으로 이동하여 사용자 추가를 선택합니다.
양식을 작성하고 새 사용자에게 Viewer, Contributor 또는 Admin으로 적절한 역할을 할당합니다.
사용자 역할에 대한 자세한 내용은 조직 관리 가이드를 참조하세요.
프로젝트 드롭다운 메뉴에서 프로젝트에 사용자를 할당합니다(해당되는 경우).
각 사용자의 이메일 주소를 입력한 다음 초대를 선택합니다.
기존 조직 참여
초대 요청: 조직의 관리자에게 초대를 보내달라고 요청합니다. 만료되기 전 24시간 내에 초대를 수락해야 합니다. 필요한 경우 관리자에게 다시 보내도록 요청하세요.
초대 수락: 기존 사용자 ID와 비밀번호로 로그인합니다. 본인의 사용자 ID가 이미 다른 조직과 연결되어 있다면 새 ID를 생성해야 합니다.
기존 조직 참여
1단계: 조직 Admin에게 초대 발송 요청
회사에 이미 생성된 조직이 있는 경우 조직의 Admin에게 초대를 요청합니다. 24시간 내에 초대를 수락해야 하지만, 정해진 기한이 지나도 언제든 다시 초대를 보내도록 요청할 수 있습니다.
2단계: 초대 수락
초대를 수락하려면 기존 사용자 ID와 비밀번호로 로그인하거나, 기존 사용자 ID가 이미 다른 조직에 연결되어 있다면 새 ID를 만들어야 합니다.
API 프로젝트 생성
내 프로젝트 페이지로 가 API 탭을 엽니다. API 프로젝트 생성 버튼을 클릭합니다.
1단계: 프로젝트에 포함하려는 API 선택
API 할당량, 속도 제한 및 API 검증 세부정보를 검토합니다.
2단계: 프로젝트 세부정보 구성
- 조직 내에서 고유하고 식별 가능한 이름을 프로젝트에 부여합니다.
- 발송물의 도착 국가를 선택하시면 테스트 발송 고객번호가 할당됩니다.유럽 국가 내에서 국내 발송 패키지를 테스트하려면 각 국가마다 별도의 테스트 고객번호가 있어야 합니다. 나중에 언제든 국가를 추가/제거할 수 있습니다.
- 최신 API 업데이트 및 서비스 중단과 관련된 모든 정보에 대한 알림을 받으려면 알림 환경설정을 설정하세요.
3단계: FedEx Developer Portal 사용권 계약을 포함해 약관을 읽고 동의
약관에 동의하고 생성 버튼을 클릭하면 확인 화면이 표시됩니다. 그런 다음 새 프로젝트에서 테스트 자격 증명을 볼 수 있습니다.
웹훅 프로젝트 생성
목적 애플리케이션 또는 플랫폼에 유효한 (콜백) URL 생성
목적 URL은 인증 코드와 메시지 및 FedEx에서 보내는 웹훅 페이로드 알림을 수신하는 데 사용됩니다. URL은 보안을 위해 HTTPS를 사용해야 합니다. 다음을 포함하는 URL은 차단됩니다.
- RFC1918 IP 대역
- fedex.com 또는 이의 하위 도메인
- IP 주소가 포함된 URL(로컬 호스트, 127.0.0.1 등이 포함된 경우도 해당)
보안 토큰 생성
이 보안 토큰을 조직과 FedEx 간에 전송된 정보를 인증하고 검증하는 시크릿 키로 사용할 수 있습니다. 보안 토큰은 다음을 포함해야 합니다.
- 최소 26자에서 최대 100자 사이
- 대문자 1개 이상 포함
- 소문자 1개 이상 포함
- 숫자 1개
예: Y1F6OiVUQW2JPSElmRE9U0IY5
URL 및 보안 토큰을 정의했다면 이제 웹훅 프로젝트를 생성할 수 있습니다. 내 프로젝트 페이지로 가 웹훅 탭을 엽니다. 웹훅 프로젝트 생성 버튼을 클릭합니다.
구독 유형 선택
FedEx 발송인은 고객번호 또는 배송 조회 번호로 이벤트를 구독할 수 있습니다.
1단계: 청구 고객번호 확인 및 기능 선택
- 기본 청구 고객번호를 검토하고 확인 처리하거나 조직의 다른 고객번호를 선택합니다.
- 배달 증명 옵션, 예상 배송 옵션, 배송 조회 이벤트, 이벤트 기반 필터링 등의 기능을 선택해 프로젝트를 구성합니다.
2단계: 프로젝트 세부정보 입력
- 조직 내에서 고유하고 식별 가능한 이름을 프로젝트에 부여합니다.
- 사전 설정 인증 시 생성한 목적 URL 및 보안 토큰 세부정보를 입력합니다(위에 나온 단계들 참조).
- 최신 웹훅 업데이트 및 서비스 일시 중단과 관련된 정보에 대한 알림을 받으려면 이메일 주소와 선호하는 언어를 입력하세요.
3단계: 약관 읽기 및 동의
FedEx Developer Portal 사용권 계약 및 주문 양식을 포함해 약관에 동의하고 생성 버튼을 클릭하면 확인 화면이 표시됩니다.
선택한 구독 유형에 따라 추가적인 단계가 있을 수 있습니다. 설명서에서 자세한 내용을 알아보세요.
API 프로젝트 개요 페이지에서 테스트 키 탭에 있는 테스트 자격 증명(API 키, 시크릿 키 및 발송 고객번호)을 가져옵니다.
1단계: OAuth 액세스 토큰 요청
각 API 트랜잭션에서 OAuth 액세스 토큰을 사용해야 합니다. 토큰의 유효 시간은 한 시간이므로 세션이 만료되기 전에 토큰을 갱신하도록 응용 프로그램을 코딩해야 합니다. 자세한 내용은 API 인증 설명서를 참조하세요.
2단계: API 설명서 검토
각 API의 설명서를 클릭해 비즈니스 컨텍스트를 읽으면 API 활용 방법을 이해하는 데 도움이 됩니다. 로그인한 후 설명서 페이지의 상단에서 아래로 이동하며 JSON API 컬렉션을 다운로드하세요. 원하는 연동 방식과 맞는 엔드포인트의 예제 요청을 검토할 수도 있습니다.
3단계: Sandbox를 사용해 샘플 트랜잭션 테스트
왼쪽 탐색 메뉴에서 원하는 엔드포인트를 클릭해 특정 Sandbox로 이동할 수 있습니다. 고객님의 사용 케이스에 맞는 샘플 요청을 확인한 다음 테스트 자격 증명과 FedEx 테스트 URL을 사용해 요청 예제에 설명된 것처럼 엔드포인트 호출을 구현해 보세요. 수신한 API 호출 응답이 설명서에 표시된 것과 일치하는지 확인합니다. Sandbox 가상화 가이드에서 테스트 경험에 대한 자세한 내용을 알아보세요.
웹훅 테스트
테스트는 생성한 URL의 유효성 여부를 판단하는 데 도움이 될 수 있습니다. 이를 통해 FedEx가 URL을 식별하고 해당 URL과의 연결을 구축해 데이터를 보낼 수 있습니다. 또한 애플리케이션에 제공된 배송 조회 데이터를 처리할 수 있는지 확인하는 데 도움이 될 샘플 테스트 데이터를 제공할 수도 있습니다. 그러나 테스트 자체가 URL을 인증하는 것은 아닙니다. 웹훅 URL의 테스트 방법에 대해 알아보려면 웹훅 설명서를 참고하세요.
프로젝트 개요 페이지로 가 프로덕션 키 탭을 엽니다.Advanced Integrated Visibility 고객번호 구독 프로젝트는 프로덕션으로 옮기지 않아도 됩니다.
1단계: 프로젝트 구성
- 필요에 따라 키 이름을 변경합니다.
- 프로젝트 생성 흐름 1단계에 선택한 고객번호를 검토합니다. 이 고객번호는 프로젝트를 프로덕션으로 옮기는 데 사용됩니다.프로젝트가 프로덕션에서 활성화되면 필요에 따라 고객번호를 추가할 수 있습니다.
2단계: 프로젝트 키 받기
프로덕션 API 키를 복사하면 보안상 안전한 곳에 프로덕션 시크릿 키가 표시됩니다. 프로덕션 시크릿 키는 보안을 위해 한 번만 표시됩니다. 잃어버린 경우에는 새 키를 생성할 수 있습니다.
프로덕션 키를 받은 후 다음을 클릭하면 프로덕션 키 탭에서 프로젝트 세부정보를 볼 수 있습니다.
- 프로젝트에 더 많은 발송 고객번호를 추가하려면 발송 고객번호 테이블 상단에 있는 편집을 클릭하세요.
검증 단계는 지역별로 다릅니다
아래에 나온 단계는 미국 및 캐나다 고객에게만 적용됩니다. 미국 및 캐나다 외 지역에 거주 중인 고객님들은 API 검증 페이지에서 지원 정보를 찾을 수 있습니다.
일부 API는 프로덕션 환경에서 사용하기 위해 발송 라벨 검증이 필요합니다. API에 검증이 필요한지 확인하세요.
1단계: 웹 기반 응용 프로그램을 사용해 FedEx API 개발 및 테스트
웹 기반 응용 프로그램의 개발이 끝나면 테스트 자격 증명(테스트 발송 고객번호, API 키 및 시크릿 키)을 사용해 테스트를 완료합니다. 테스트 API 키와 시크릿 키는 프로젝트 개요 페이지에 표시되며 언제든 볼 수 있습니다.
2단계: 프로젝트를 프로덕션으로 이동
FedEx API의 테스트를 마치고 나면 FedEx Developer Portal에서 프로젝트를 프로덕션으로 옮겨 검증 프로세스를 시작해야 합니다. 프로젝트를 성공적으로 이동시키면 프로덕션 API 키와 시크릿 키가 표시됩니다. 프로덕션 시크릿 키는 한 번만 볼 수 있지만 나중에 다시 생성할 수도 있습니다.
3단계: 라벨 표지 작성
라벨 표지에 연락처 정보와 구현하려는 서비스에 대한 설명을 기재합니다. 고객번호와 프로덕션 키도 포함합니다.
4단계: 테스트 라벨을 생성한 후 바코드 분석 그룹에 제출
애플리케이션과 관련된 FedEx 테스트 환경에서 테스트 라벨을 생성한 다음 승인을 위해 FedEx 라벨 평가 팀에 테스트 라벨을 제출합니다. 바코드 분석 그룹에서 라벨 평가를 완료하는 데는 영업일 기준 3일이 걸립니다.
테스트 라벨 검토가 지연되는 것을 방지하려면 여기에 나온 모범 사례를 준수하세요.
- 라벨은 최소 600DPI로 인쇄하고 스캔해야 합니다. API가 생성한 파일은 보내지 마십시오.
- 열전사 프린터의 경우 프린터 모델에 맞게 라벨 이미지 유형을 설정해야 합니다. 예: Zebra 프린터에서는 ZPLII.
- 평가용 샘플 라벨을 만들 때에는 발송인/수취인 주소 정보를 사용합니다. 적용 중인 특정 서비스에 대해서만 샘플 라벨을 만드십시오.
- FedEx® C.O.D.(배송 시 요금 수납) 라벨에는 그에 상응하는 C.O.D. 반송 라벨도 포함되어야 합니다.
- FedEx International Express® 발송물에는 보조/2차 AWB(항공운송장) 라벨도 포함되어야 합니다.
- MPS(복수 발송물)에는 각각의 패키지 당 라벨이 포함되어야 합니다.
- PDF 및 라벨 표지를 이메일 label@fedex.com으로 전송합니다.
- 출력한 실제 라벨은 아래 주소로 보낼 수 있습니다.
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
스캔한 라벨에 시각적 결함(예: 바코드 위에 불필요한 선, 잉크 얼룩, 물리적 손상 등)이 있으면 검사를 통과하거나 승인을 받을 수 없습니다.
실제 출력한 라벨을 보낼 때는 인쇄 품질은 물론 라벨이 실수로 확대/축소(즉, 배율 조정)되지 않도록 주의하세요. 이는 테스트 라벨이 평가 과정을 통과하지 못하는 가장 큰 두 가지 요인입니다.
5단계: 라벨 평가 검토
바코드 분석 그룹이 제출된 테스트 라벨을 평가하고 해당 라벨을 승인 또는 거부합니다. 제출한 라벨의 승인 또는 거부와 관련하여서는 바코드 분석 그룹이 직접 연락드릴 것입니다. 라벨이 승인되면 계속 다음 단계를 진행합니다. 라벨이 거부되면 안내에 따라 라벨을 수정한 다음 승인을 위해 다시 제출합니다.
6단계: 애플리케이션 활성화
바코드 분석 그룹에서 테스트 라벨의 프로덕션 상태를 승인하면, 확인된 발송 라벨 트랜잭션을 전송할 수 있도록 사용자의 프로덕션 자격 증명을 승인하고 이메일로 검증이 성공했음을 통보합니다. 승인은 프로젝트 단위로 진행됩니다.
7단계: URL 및 자격 증명 변경
테스트 URL 및 테스트 자격 증명을 프로덕션 URL 및 프로덕션 자격 증명으로 변경합니다. 샘플 데이터를 사용해 프로덕션 환경에서 구현 사항을 다시 테스트하십시오.
필수 구성 요소
고객님의 사업체는 이미 Fedex Compatible Provider입니다. 해당 사업체가 Compatible 프로그램에 속하지 않는 경우 상기 선택 사항을 'Non-Compatible Provider'로 변경해 주세요.
1단계: 조직 참여 초대 받기
FedEx에서 조직을 생성한 후 팀 멤버 한 명을 조직으로 초대합니다. 이 사용자가 조직의 Admin으로 지정됩니다.
2단계: 초대 수락
초대를 수락하려면 기존 사용자 ID와 비밀번호로 로그인하거나, 기존 사용자 ID가 이미 다른 조직에 연결되어 있다면 새 ID를 만들어야 합니다.
3단계: 사용자 초대
Admin은 사용자를 조직에 초대하고 역할과 프로젝트를 할당할 수 있습니다. 사용자 탭을 엽니다. 사용자 추가 버튼을 클릭합니다.
- 사용자 역할을 Viewer, Contributor, Admin 중에서 선택합니다. 조직 관리 가이드에서 역할에 대한 자세한 내용을 알아보세요.
- 기존 프로젝트가 있는 경우 사용자에게 프로젝트를 할당합니다. 프로젝트 개요 페이지에서 프로젝트에 사용자를 할당할 수도 있습니다.
- 선택한 역할로 조직에 참여시키려는 사용자의 이메일 주소를 입력합니다.
API 카탈로그에서 솔루션에 적합한 API 또는 웹훅을 선택합니다. FedEx 고객 기술 지원 컨설턴트(CTC) 및 Compatible Channel 매니저가 비즈니스 니즈에 따라 솔루션에 적합한 API 선택을 선택하도록 도와드릴 수 있습니다.
1단계: PIW 작성
CPC(Compatible Provider Community)로 돌아가 PIW(Product Information Worksheet)을 작성합니다.
2단계: FedEx에서 생성한 프로젝트 검토
PIW가 승인되면 FedEx가 귀하의 프로젝트를 생성합니다. 솔루션의 각 버전마다 FedEx Developer Portal에서 별도의 프로젝트를 가집니다.
3단계: 고객 팀과 함께 API 시범 참여
FedEx CTC 및 Verification 팀과 더불어 FedEx Compatible 팀에서 고객 팀과 함께 API 기술 시범을 준비합니다. FedEx 팀은 Compatible 프로그램 검증, 새 API 기능과 특징에 대해 토의하고 질문에 답합니다.
API 프로젝트 개요 페이지에서 테스트 키 탭에 있는 테스트 자격 증명(API 키 및 시크릿 키)을 가져옵니다.
1단계: 고객 키 생성
자격 증명 등록 API를 사용해 고객 키를 생성합니다. 이 API는 API 프로젝트 개요 페이지 하단의 API 섹션에서만 찾을 수 있는 비공개 API입니다.
2단계: OAuth 액세스 토큰 요청
각 API 트랜잭션에서 OAuth 액세스 토큰을 사용해야 합니다. 토큰의 유효 시간은 한 시간이므로 세션이 만료되기 전에 토큰을 갱신하도록 응용 프로그램을 코딩해야 합니다. 자세한 내용은 API 인증 설명서를 참조하세요. 샘플 코드를 확인하면 샘플 드롭다운에서 '리셀러'가 선택되었는지 확인하세요.
3단계: API 설명서 검토
각 API의 설명서를 클릭해 비즈니스 컨텍스트를 읽으면 API 활용 방법을 이해하는 데 도움이 됩니다. 로그인한 후 설명서 페이지의 상단에서 아래로 이동하며 JSON API 컬렉션을 다운로드하세요. 원하는 연동 방식과 맞는 엔드포인트의 예제 요청을 검토할 수도 있습니다.
4단계: Sandbox를 사용해 샘플 트랜잭션 테스트
왼쪽 탐색 메뉴에서 원하는 엔드포인트를 클릭해 특정 Sandbox로 이동할 수 있습니다. 고객님의 사용 케이스에 맞는 샘플 요청을 확인한 다음 테스트 자격 증명과 FedEx 테스트 URL을 사용해 요청 예제에 설명된 것처럼 엔드포인트 호출을 구현해 보세요. 수신한 API 호출 응답이 설명서에 표시된 것과 일치하는지 확인합니다. Sandbox 가상화 가이드에서 테스트 경험에 대한 자세한 내용을 알아보세요.
5단계: 각 솔루션 검증
솔루션을 전부 테스트하고 나면, 각 솔루션을 검증하도록 Verification 팀에 테스트 케이스를 제출하세요. 귀하의 검증이 승인되면 FedEx는 제출된 모든 내용을 완전히 검토하고 귀하에게 알립니다.
웹훅 테스트
조직에 웹훅 이용 권한이 있는 경우 테스트는 생성한 URL의 유효성 여부를 판단하는 데 도움이 될 수 있습니다. 이를 통해 FedEx가 URL을 식별하고 해당 URL과의 연결을 구축해 데이터를 보낼 수 있습니다. 또한 애플리케이션에 제공된 배송 조회 데이터를 처리할 수 있는지 확인하는 데 도움이 될 샘플 테스트 데이터를 제공할 수도 있습니다. 그러나 테스트 자체가 URL을 인증하는 것은 아닙니다. 웹훅 URL의 테스트 방법에 대해 알아보려면 웹훅 설명서를 참고하세요.
그 다음으로 귀하의 프로젝트를 프로덕션으로 이동시킵니다. API 프로젝트 개요 페이지로 가 프로덕션 키 탭을 엽니다. 시크릿 키 열에서 시크릿 키 생성 링크를 클릭합니다.
이제 프로덕션 환경에서 샘플 데이터를 사용해 귀하의 구현을 다시 테스트 할 수 있습니다.
필수 구성 요소
FedEx Developer Portal에 로그인하려면 FedEx 사용자 ID 및 고객번호가 있어야 하고 조직을 생성해야 합니다.
회사에 아직 생성된 조직이 없다면 조직을 생성하고, 기존 조직이 있는 경우에는 참여합니다.
새 조직 생성
탐색 모음에서 조직 생성 또는 참여를 클릭합니다.
참고: 조직의 생성자로서 귀하는 자동으로 관리자가 됩니다.
관리자가 수행할 수 있는 작업:
사용자 참여 초대
사용자 역할(예: Contributor, Viewer) 및 프로젝트 할당
발송 고객번호 관리
이러한 역할에 대해 자세히 알아보려면 조직 관리 가이드를 살펴보세요.
회사 유형의 경우, "FedEx 기술을 사용하는 소프트웨어 솔루션을 판매하거나 제공하고 있으며, 검증된 FedEx 인테그레이터 제공자입니다"를 선택합니다.
회사명, 웹사이트 URL, 고유 조직 이름을 입력하세요. 조직명은 귀하의 회사명과 일치하거나 특정 그룹(부서, 사업부, 지역, 위치)을 나타낼 수 있습니다. 이 정보는 요청을 검증하는 데 필요합니다.
참고: 다른 모든 사용자가 알아볼 수 있는 조직 이름을 선택하세요(예: 회사명, 부서, 지역, 위치).
회사의 위치와 소프트웨어 솔루션이 판매 또는 배포될 위치를 지정하세요.
청구 고객번호를 추가하고 고객번호를 인증하세요.
참고: FedEx 인테그레이터 프로그램에 참여하는 발송 및 물류 서비스 제공자로서 본인의 고객번호를 사용해야 합니다. 고객의 FedEx 고객번호를 사용할 수 없습니다.
FedEx 고객번호를 입력하세요. 기존 FedEx 고객번호가 없는 경우, fedex.com에서 개설하거나 FedEx 지원 담당자에게 문의하세요.
고객번호 닉네임 및 고객번호와 연결된 청구 주소를 입력합니다. 다음을 선택하세요.
참고: 청구 주소는 이 고객번호에 대한 FedEx의 기록과 일치해야 합니다. 이 고객번호가 조직의 기본 청구 고객번호가 됩니다.
조직 생성을 완료하려면 고객번호를 인증해야 합니다. 인증 옵션(전화(미국 및 캐나다 내 인테그레이터만 가능), 이메일, 문자)을 선택하고 다음을 선택합니다.
메시지를 수신하면 인증 코드를 입력하고 제출을 선택합니다.
약관에 동의
FedEx 인테그레이터 계약 및 프로그램 매뉴얼을 살펴보세요. 체크박스를 선택해 약관에 동의한 다음 수락을 선택합니다.
확인 화면이 표시됩니다. 필요한 경우 조직 관리를 클릭해 세부정보를 편집하세요.
사용자 초대
참고: 관리자만 사용자를 초대할 수 있습니다.
왼쪽 탐색 메뉴에서 조직 관리를 선택합니다.
사용자 탭으로 이동하여 사용자 추가를 선택합니다.
양식을 작성하고 새 사용자에게 Viewer, Contributor 또는 Admin으로 적절한 역할을 할당합니다.
사용자 역할에 대한 자세한 내용은 조직 관리 가이드를 참조하세요.
프로젝트 드롭다운 메뉴에서 프로젝트에 사용자를 할당합니다(해당되는 경우).
각 사용자의 이메일 주소를 입력한 다음 초대를 선택합니다.
기존 조직 참여
초대 요청: 조직의 관리자에게 초대를 보내달라고 요청합니다. 만료되기 전 24시간 내에 초대를 수락해야 합니다. 필요한 경우 관리자에게 다시 보내도록 요청하세요.
초대 수락: 기존 사용자 ID와 비밀번호로 로그인합니다. 본인의 사용자 ID가 이미 다른 조직과 연결되어 있다면 새 ID를 생성해야 합니다.
API 프로젝트 생성
내 프로젝트 페이지로 이동하여 프로젝트 생성을 선택합니다.
프로젝트 이름 필드를 기입합니다. 권장되는 이름 형식은 '프로젝트명_응용프로그램명'입니다. 완료하면 다음을 선택합니다.
프로젝트에 대한 API 및 Advanced Integrated Visibility 제품을 선택합니다.
참고: Advanced Integrated Visibility 제품은 미국 FedEx 인테그레이터 제공자만 이용할 수 있습니다.
참고: 유료 제품을 선택하면, 프로젝트에 청구 고객번호를 지정하고 약관에 동의하라는 메시지가 표시됩니다.
청구 지정 및 약관 동의
조직에 추가된 고객번호 목록에서 청구 고객번호를 지정합니다. 앞 단계에서 유료 제품을 선택한 경우에만 이 단계를 진행하게 됩니다.
제품과 관련된 약관에 동의해 주세요.
세부정보 확인
선택한 제품을 검토합니다. 입력한 청구 고객번호를 확인하세요.
FedEx Developer Portal 사용권 계약을 검토하고 동의해 주세요.
생성을 클릭하여 프로젝트를 생성하고 테스트 자격 증명을 확인합니다.
프로젝트에서 Advanced Integrated Visibility 구성
필수 구성 요소
필수 구성 요소
- 요금 책정 검토: 구독자에게는 배송 조회 번호 수를 기준으로 월 수수료가 청구됩니다. 요금에 대한 자세한 내용은 주문 양식을 참조하세요.
- 고객번호 설정: Advanced Integrated Visibility를 사용하려면 미국 기반 청구 고객번호와 최소 한 개 이상의 발송 고객번호가 필요합니다. 이 두 고객번호 유형은 동일할 수 없습니다. 관리자만 조직 관리 페이지에서 청구 고객번호 및 발송 고객번호를 추가할 수 있습니다.
도착지 애플리케이션 또는 플랫폼에서 유효한 콜백 URL 생성 – 애플리케이션/플랫폼 URL:
보안을 위해 HTTPS를 사용해야 합니다.
RFC1918 IP 대역, fedex.com 하위 도메인 또는 직접 IP 주소(예: 127.0.0.1)를 포함할 수 없습니다.
보안 토큰 생성
26~100자 길이여야 하며 다음을 포함해야 합니다.
- 대문자 1개
- 소문자 1개
- 숫자 1개
예: Y1F6OiVUQW2JPSElmRE9U0IY5
Advanced Integrated Visibility 구성
Advanced Integrated Visibility를 선택합니다. 배송 증명서, 배송 예정일, 배송 조회 이벤트, 이벤트 기반 필터링 등의 기능을 선택하세요.
도착지 URL 및 보안 토큰을 입력합니다.
Advanced Integrated Visibility 업데이트 및 서비스 일시 중단 알림을 받을 이메일을 입력하세요.
세부정보 확인
FedEx Developer Portal 사용권 계약 및 주문 양식을 검토하고 동의해 주세요.
생성을 선택하여 설정을 완료합니다.
참고: 수신 등록 유형에 따라 추가 단계가 적용될 수 있습니다. 자세한 내용은 설명서를 참조하세요.
테스트 자격 증명 받기 및 테스트 시작
API 설명서 검토
- API 설명서를 읽고 FedEx에서 제공하는 다양한 API와 비즈니스 환경 및 통합 프로세스에 대해 파악해 보세요.
- 관련 API 설명서 페이지에서 JSON 스키마를 다운로드합니다.
- 원하는 엔드포인트의 요청 예시를 검토합니다.
테스트 자격 증명 받기
프로젝트 개요 페이지에서 API 키 탭으로 이동합니다. API 키와 시크릿 키는 테스트 키 헤더 아래에 나옵니다.
API 설명서 검토
- 모든 API 트랜잭션에는 OAuth 토큰이 필요하며 1시간 후에 만료됩니다.
- 토큰이 만료되기 전에 애플리케이션에서 토큰을 새로 고침해야 합니다.
- 자세한 내용은 API 인증 설명서를 참조하세요.
Sandbox에서 API 트랜잭션 테스트
- API 카탈로그에서 관련 API로 이동한 후 설명서를 선택합니다.
- 왼쪽 메뉴에서 원하는 API 엔드포인트를 선택합니다.
- 본인의 사용 케이스에 맞는 샘플 요청을 사용합니다.
- 테스트 자격 증명 및 FedEx 테스트 URL을 사용하여 API 호출을 구현합니다.
- 응답을 설명서와 비교하여 확인합니다.
- 자세한 내용은 Sandbox 가상화 가이드를 참조하세요.
Advanced Integrated Visibility 테스트
Advanced Integrated Visibility 테스트는 URL 형식을 검증하고, FedEx와 애플리케이션 간의 연결을 설정하는 데 도움을 줍니다.
이 테스트는 배송 조회 정보를 처리하기 위한 샘플 테스트 데이터를 제공합니다.
참고: 테스트 자체가 URL을 인증하는 것은 아닙니다.
자세한 내용은 Advanced Integrated Visibility 설명서를 참조하세요.
API 프로젝트를 프로덕션으로 옮기기 위해서는 검증을 거쳐야 합니다. 검증 레벨은 API에 따라 달라집니다.
FedEx API 개발 및 테스트
- 프로젝트 개요 페이지에서 테스트 자격 증명(API 키 및 시크릿 키)을 사용합니다.
- 솔루션을 배포할 지역에 대한 테스트 케이스를 식별합니다(인테그레이터 테스트 케이스 베이스라인 참조).
- 테스트 케이스를 실행하기 전에 제공된 테스트 고객번호를 사용하여 등록 트랜잭션을 완료하세요.
- 필요한 모든 테스트 케이스를 실행합니다.
프로젝트 개요 페이지로 이동합니다.
프로덕션 키 요청을 선택합니다. FedEx에서 프로덕션 키 요청을 수신하고 해당 요청이 승인되면 알려드립니다.
PIW 및 검증 표지 작성
본인의 연락처 정보와 원하는 FedEx 서비스를 기입해 제품 정보 워크시트(PIW) 및 인테그레이터 검증 표지를 작성하세요.
서류 제출
다음과 같은 서류를 취합한 후, 이메일 제공업체의 제약 사항을 피할 수 있도록 .zip 파일로 압축합니다. validationmtp@fedex.com으로 보내주세요.
필요한 서류
- 작성한 PIW(PDF)
- 작성한 검증 표지(PDF)
스크린샷(PDF):
FedEx 서비스/특별 취급을 보여주는 고객대면 솔루션
법적 고지
EULA 동의서
최종 고객 등록 절차
- 다단계 인증을 사용한 최종 고객 등록 트랜잭션(JSON)
- 모든 해당 테스트 케이스에 대한 스캔된 발송 라벨(PDF/PNG)
- PDF, PNG, ZPL 등 세 가지 라벨 형식의 발송 트랜잭션(JSON)(해당하는 배송 및 요금 책정 API용)
지연 방지를 위한 모범 사례
- 라벨은 최소 600 DPI로 인쇄하고 스캔해야 합니다.
- 열전사 프린터 라벨은 프린터 모델과 일치해야 합니다(예: Zebra 프린터의 경우 ZPLII).
- FedEx International Express® 발송물에는 보조 항공운송장(AWB) 라벨이 필요합니다.
- 복수 발송물(MPS)은 각 패키지에 대한 라벨을 포함해야 합니다.
라벨 평가
검증 팀에서 제출 사항을 승인하거나 거부할 것입니다.
- 거부된 경우 피드백에 따라 수정하고 다시 제출하세요.
- 승인되면 인증 성공을 확인해주는 이메일을 받게 됩니다. 이메일을 받으시면 귀하의 프로덕션 자격 증명이 발송 라벨 트랜잭션에 대해 승인됩니다.
검증 후 지침 준수
필요에 따라 검증 후 요구사항을 검토하고 구현하세요.
프로덕션 키가 승인되었다는 알림을 받으면 프로젝트 개요 탭에서 프로덕션 키를 받을 수 있습니다.
- 프로덕션 API 키와 시크릿 키를 복사한 후 안전하게 보관하세요.
- 시크릿 키는 한 번만 표시되며, 분실할 경우 새로 생성해야 합니다.
