FedEx 인테그레이터 제공자
필수 구성 요소
FedEx Developer Portal에 로그인하려면 FedEx 사용자 ID가 있어야 하고 조직을 생성해야 합니다.
회사 조직에 참여해 팀과 협업합니다. 회사에 조직이 없는 경우 조직을 만들 수 있습니다.
기존 조직 참여
1. 초대 요청
조직의 관리자에게 초대를 보내 달라고 요청합니다. 초대는 24시간 내에 수락해야 합니다. 초대가 만료되면 관리자에게 다시 보내달라고 요청하세요.
2. 초대 수락
기존 사용자 ID와 비밀번호로 로그인합니다. 본인의 사용자 ID가 다른 조직과 연결되어 있다면 새 ID를 생성해야 합니다.
새 조직 생성
조직을 생성하면 관리자가 됩니다. 관리자는 조직에 참여할 사용자를 초대하고, 프로젝트 및 사용자 역할을 할당하고, 청구 고객번호를 관리할 수 있습니다.
사용자 역할에 대해 자세히 알아보려면 조직 관리 가이드라인을 살펴보세요.
1. 탐색 모음에서 조직 생성 또는 참여를 선택합니다.
2. 다음 세부 정보를 입력합니다.
- 다음과 같은 회사에서 일하고 있습니다의 경우, FedEx 기술을 사용하는 소프트웨어 솔루션을 판매하거나 제공하고 있으며, 검증된 FedEx 인테그레이터 제공자로 등록하고 싶습니다를 선택합니다.
- 회사명, 회사 웹사이트 및 회사명, 부서, 사업부, 지역 등 팀이 식별할 수 있는 조직 이름을 입력합니다.
- 회사 도메인이 포함된 공식 이메일, 귀사가 설립된 국가 또는 지역, 소프트웨어 솔루션을 판매하거나 배포하는 국가 및 지역을 입력합니다.
3. 다음을 선택하세요.
메뉴의 조직 관리에서 나중에 세부정보를 업데이트하거나 추가할 수 있습니다.
청구 고객번호 추가
1. 청구 고객번호 탭을 선택합니다. FedEx 청구 고객번호가 없는 경우 청구 고객번호 개설하기를 선택하여 새 청구 고객번호를 개설하거나 FedEx 고객지원팀에 문의하세요.
참고: 본인의 고객번호를 사용하세요. 고객의 FedEx 고객번호는 사용할 수 없습니다.
2. 청구 고객번호 추가를 선택합니다.
3. FedEx 고객번호, 고객번호 닉네임, 고객번호 설정 시 사용한 미국 청구 주소를 입력합니다.
참고: 청구 주소는 고객번호 설정 시 사용한 주소와 일치해야 합니다. 이 고객번호가 조직의 기본 청구 고객번호가 됩니다.
4. 인증 옵션을 선택합니다.
- 전화 통화는 미국과 캐나다의 인테그레이터만 이용할 수 있습니다.
5. 수신한 인증 코드를 입력하고 제출을 선택합니다.
6. FedEx 인테그레이터 계약을 읽고 수락합니다.
사용자를 관리자로 초대
1. 조직 관리로 이동하여 사용자 탭을 선택합니다.
2. + 사용자 추가를 선택합니다.
3. 다음 세부정보를 입력합니다.
- 국가 또는 지역
- 언어 기본 설정
4. 사용자 역할(Viewer, Contributor 또는 Admin)을 선택합니다.
5. (선택 사항) 사용자를 프로젝트에 할당합니다.
- 프로젝트의 개요 페이지에서 언제든 사용자를 할당할 수 있습니다.
6. 사용자들의 이메일 주소를 입력하고 초대를 클릭합니다.
- 한 번에 최대 20명의 사용자를 초대할 수 있으며, 각 이메일은 쉼표로 구분됩니다. 초대는 24시간 동안 유효합니다.
프로젝트 생성
1. 메뉴에서 내 프로젝트로 이동하고 + 프로젝트 생성을 선택합니다.
2. 프로젝트 이름을 입력합니다.
- 권장되는 이름 형식은 프로젝트명_응용프로그램명입니다. 완료하면 다음을 선택합니다.
3. 프로젝트에 포함할 API 및 Advanced Integrated Visibility 제품을 선택합니다.
- Advanced Integrated Visibility 제품은 미국 FedEx 인테그레이터 제공자만 이용할 수 있습니다.
- 유료 제품을 선택하면, 프로젝트에 청구 고객번호를 지정하고 약관에 동의하라는 메시지가 표시됩니다.
청구 고객번호 지정
참고: 유료 제품을 선택한 경우에만 필수 항목입니다.
1. 조직에 추가된 고객번호 목록에서 청구 고객번호를 지정합니다. 청구 고객번호는 미국에 기반을 두고 있어야 합니다.
2. FedEx Developer Portal 사용권 계약 및 주문 양식에 동의하고 생성을 선택합니다.
프로젝트에서 Advanced Integrated Visibility 구성
1. 애플리케이션 또는 플랫폼에서 콜백을 수신할 도착지 URL을 생성합니다. URL은 다음과 같은 조건을 충족해야 합니다.
- HTTPS를 사용해야 합니다
- RFC1918 IP 대역, fedex.com 및 그 하위 도메인, IP 주소(로컬 호스트, 127.0.0.1 등)는 제외됩니다
2. 인증을 위한 보안 토큰을 생성합니다. 토큰은 다음과 같은 조건을 충족해야 합니다.
- 26~100자 사이로, 대문자, 소문자, 숫자를 최소 1개 이상 포함해야 합니다.
3. 메뉴에서 내 프로젝트를 선택한 다음 Advanced Integrated Visibility 탭을 선택합니다.
4. Advanced Integrated Visibility 프로젝트 생성을 선택합니다.
5. 사용자 유형을 선택합니다.
- FedEx 배송업체: FedEx를 이용해 발송하고 자체 애플리케이션에 FedEx API를 통합하려는 회사입니다
- FedEx Compatible Provider: 인증된 FedEx Compatible Provider입니다
- FedEx 인테그레이터 제공자: FedEx 기술을 사용하는 소프트웨어 솔루션을 판매하거나 제공하고 있으며 검증된 FedEx 인테그레이터 제공자입니다
6. 구독 유형을 선택합니다. 고객번호 또는 배송 조회 번호로 이벤트를 구독할 수 있습니다.
7. 청구 고객번호를 확인하고 배송 증명서, 배송 예정일, 배송 조회 이벤트, 이벤트 기반 필터링 등 원하는 기능을 선택합니다.
8. 프로젝트 세부정보를 입력합니다.
- 쉽게 알아볼 수 있는 고유한 프로젝트 이름을 입력합니다.
- 생성한 도착지 URL과 보안 토큰을 입력합니다.
- Advanced Integrated Visibility 업데이트 및 서비스 중단 관련 알림을 받을 이메일 주소와 언어 기본 설정을 입력합니다.
9. FedEx Developer Portal 사용권 계약 및 주문 양식에 동의하고 생성을 선택합니다.
참고: 선택한 구독 유형에 따라 추가 단계가 필요할 수 있습니다. 자세한 내용은 웹훅 설명서를 참조하세요.
다음 단계에 따라 API 통합을 확인하고 애플리케이션이 테스트 데이터를 송수신할 수 있는지 확인하세요.
1. 메뉴에서 내 프로젝트를 선택한 다음, 프로젝트 이름을 선택합니다.
2. API 키 탭의 테스트 키에서 테스트 자격 증명을 찾으세요.
3. 로그인한 후 설명서 페이지 상단에 있는 JSON 스키마 다운로드 버튼을 사용하여 JSON API 컬렉션을 다운로드하세요. 통합에서 사용하는 엔드포인트의 예제 요청을 검토합니다.
4. 각 API 트랜잭션에서 사용하는 OAuth 액세스 토큰을 요청합니다. 토큰은 1시간 동안 유효하며, 만료되기 전에 갱신되도록 애플리케이션을 구성할 수 있습니다. 자세한 내용은 API Authorization 설명서를 참조하세요.
5. 메뉴에서 API 카탈로그를 선택하고, 작업하려는 API를 선택한 다음, 설명서를 선택하세요.
6. 메뉴에서 엔드포인트를 선택합니다.
7. 테스트 자격 증명 및 FedEx 테스트 URL을 사용하여 샘플 요청을 전송한 다음, 응답이 설명서 예시와 일치하는지 확인하세요. 자세한 내용은 Sandbox 가상화 가이드를 참조하세요.
8. Advanced Integrated Visibility로 테스트를 실행하여 샘플 데이터를 생성하고, 애플리케이션이 배송 조회 정보를 올바르게 처리하는지 확인하세요.
참고: 테스트 자체가 콜백 URL을 인증하는 것은 아닙니다. 자세한 내용은 Advanced Integrated Visibility 설명서를 참조하세요.
검증 단계는 지역별로 다릅니다
아래에 나온 단계는 미국 및 캐나다 고객에게만 적용됩니다. 미국 및 캐나다 외 지역에 거주 중인 고객님들은 API 검증 페이지에서 지원 정보를 찾을 수 있습니다.
API를 프로덕션으로 옮기기 위해서는 검증을 거쳐야 합니다. 검증 레벨은 API에 따라 달라집니다. 시작하기 전에 API 검증 요건을 검토하세요.
1. 메뉴에서 내 프로젝트를 선택한 다음, 프로젝트 이름을 선택합니다.
2. API 키 탭의 테스트 키에서 테스트 자격 증명을 찾으세요.
3. 솔루션을 배포할 지역에 대한 테스트 케이스를 식별합니다. 자세한 내용은 인테그레이터 테스트 케이스 베이스라인을 참조하세요.
4. 테스트 케이스를 실행하기 전에 제공된 테스트 고객번호를 사용하여 등록 트랜잭션을 완료하세요.
5. 필요한 모든 테스트 케이스를 완료합니다.
6. 본인의 연락처 정보와 선택한 FedEx 서비스를 기입해 제품 정보 워크시트(PIW)를 작성하세요.
7. 인테그레이터 검증 표지를 작성하세요.
서류 제출
모든 필요한 자료를 validationmtp@fedex.com으로 보내주세요.
1. 다음과 같은 서류를 준비합니다.
- 작성한 PIW(PDF)
- 작성한 검증 표지(PDF)
- 다단계 인증을 사용한 최종 고객 등록 트랜잭션(JSON)
- 모든 해당 테스트 케이스에 대한 스캔된 발송 라벨(PDF/PNG)
- 세 가지 라벨 형식(PDF, PNG, ZPL(JSON))의 발송 트랜잭션(해당하는 배송 및 요금 책정 API용)
- 다음이 포함된 스크린샷(PDF):
- FedEx 서비스 및 특별 취급을 보여주는 고객 대면 솔루션
- 법적 고지
- 최종 사용자 사용권 계약(EULA)
- 최종 고객 등록 절차
2. 이메일 제공업체의 제약 사항을 피할 수 있도록 모든 파일을 하나의 .zip 파일로 압축합니다.
3. .zip 파일을 작성한 서류를 Validation 팀에 이메일로 제출합니다.
지연 방지를 위한 모범 사례
검토 시간을 줄이려면 다음 가이드라인을 따르세요.
- 라벨은 최소 600DPI로 인쇄하고 스캔합니다. API에서 직접 생성된 파일은 제출하지 마세요.
- 열전사 프린터의 경우 프린터에 맞게 이미지 유형을 요청합니다. 예: Zebra 프린터에서는 ZPLII
- FedEx International Express®의 경우 보조(2차) AWB(항공운송장)도 포함되어야 합니다.
- 복수 발송물(MPS)의 경우 각 패키지의 라벨을 포함하세요.
라벨 평가
Validation 팀에서 제출 사항을 검토합니다.
- 거부된 경우 피드백을 해결하고 서류를 다시 제출하세요.
- 승인되면 확인 이메일을 받게 됩니다. 승인 후, 귀하의 프로덕션 자격 증명이 발송 라벨 트랜잭션에 대해 승인됩니다.
1. 메뉴에서 내 프로젝트를 선택한 다음, 프로젝트 이름을 선택합니다.
2. API 섹션에서 프로덕션 API 키와 시크릿 키를 복사해 안전하게 저장합니다.
참고: 시크릿 키는 한 번만 표시되므로 안전한 위치에 저장하세요. 잃어버린 경우에는 나중에 새 키를 다시 생성할 수 있습니다.
