FedEx 발송인
필수 구성 요소
FedEx Developer Portal에 로그인하려면 FedEx 사용자 ID가 있어야 하고 조직을 생성해야 합니다.
회사 조직에 참여해 팀과 협업합니다. 회사에 조직이 없는 경우 조직을 만들 수 있습니다.
기존 조직 참여
1. 초대 요청
조직의 관리자에게 초대를 보내 달라고 요청합니다. 초대는 24시간 내에 수락해야 합니다. 초대가 만료되면 관리자에게 다시 보내달라고 요청하세요.
2. 초대 수락
기존 사용자 ID와 비밀번호로 로그인합니다. 본인의 사용자 ID가 다른 조직과 연결되어 있다면 새 ID를 생성해야 합니다.
새 조직 생성
조직을 생성하면 관리자가 됩니다. 관리자는 조직에 참여할 사용자를 초대하고, 프로젝트 및 사용자 역할을 할당하고, 발송 고객번호를 관리할 수 있습니다.
사용자 역할에 대해 자세히 알아보려면 조직 관리 가이드라인을 살펴보세요.
1. FedEx Developer Portal에 로그인합니다.
2. 메뉴에서 내 프로젝트를 선택한 다음 조직 생성을 선택합니다.
3. 다음 세부정보를 입력합니다.
- 다음과 같은 회사에서 일하고 있습니다의 경우, 발송에 FedEx를 이용하고 있고 자체 애플리케이션에 FedEx API를 연동해야 합니다를 선택합니
- 회사명, 회사 웹사이트 및 회사명, 부서, 사업부, 지역 등 팀이 식별할 수 있는 조직 이름을 입력합니다.
4. 생성을 선택합니다.
메뉴의 조직 관리에서 나중에 세부정보를 업데이트하거나 추가할 수 있습니다.
발송 고객번호 추가
1. 고객번호 추가 타일에서 발송 고객번호 추가를 선택합니다. FedEx 고객번호가 없는 경우 계정 생성을 선택하여 새 고객번호를 개설하거나 FedEx 고객지원팀에 문의하세요.
2. + 고객번호 추가를 선택합니다.
3. FedEx 고객번호, 고객번호 닉네임, 고객번호 설정 시 사용한 청구 주소를 입력합니다.
4. 최종 사용자 사용권 계약에 동의하거나 회사 내 권한 있는 대표자에게 이를 전달합니다.
청구 고객번호 추가
1. 청구 고객번호 탭을 선택합니다. FedEx 청구 고객번호가 없는 경우 청구 고객번호 개설하기를 선택하여 새 청구 고객번호를 개설하거나 FedEx 고객지원팀에 문의하세요.
2. 청구 고객번호 추가를 선택합니다. 청구 고객번호는 미국에 기반을 두고 있어야 합니다.
3. FedEx 고객번호, 고객번호 닉네임, 고객번호 설정 시 사용한 미국 청구 주소를 입력합니다.
4. 최종 사용자 사용권 계약을 읽고 수락합니다.
사용자를 관리자로 초대
1. 메뉴에서 조직 관리를 선택한 다음 사용자 탭을 선택합니다.
2. + 사용자 추가를 선택합니다.
3. 국가 또는 지역과 언어 기본 설정을 선택한 다음, 사용자 역할을 Viewer, Contributor 또는 Admin 중에서 선택하세요.
4. (선택 사항) 사용자를 프로젝트에 할당합니다. 프로젝트의 개요 페이지에서 언제든 사용자를 할당할 수 있습니다.
5. 사용자들의 이메일 주소를 입력하고 초대를 클릭합니다. 한 번에 최대 20명의 사용자를 초대할 수 있으며, 각 이메일은 쉼표로 구분됩니다. 초대는 24시간이 지나면 만료됩니다.
API 프로젝트 생성
1. 메뉴에서 내 프로젝트를 선택한 다음, API 탭을 선택하고 + API 프로젝트 생성을 선택합니다.
2. API 요구 사항을 확인합니다.
3. 프로젝트에 포함할 API를 선택합니다.
4. 프로젝트 이름을 생성하고 발송하려는 국가를 선택하여 테스트 발송 고객번호를 받습니다. 유럽 국내 발송의 경우 각 국가마다 별도의 테스트 고객번호가 필요합니다. 나중에 국가를 추가하거나 제거할 수 있습니다.
5. 알림 아래의 설정을 선택하여 알림 기본 설정을 지정합니다.
6. 약관을 읽고 동의합니다.
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 설명서를 참조하세요.
프로젝트를 프로덕션으로 이동
실제로 진행하기 전에 프로덕션 구성을 설정하세요. 키 이름을 변경하고, 프로젝트가 진행된 후 고객번호를 추가하고, 프로젝트 생성 시 선택한 고객번호를 검토할 수 있습니다. 이 고객번호는 프로젝트를 프로덕션으로 옮기는 데 사용됩니다.
참고: 고객번호 기반 Advanced Integrated Visibility 프로젝트는 프로덕션 활성화가 필요하지 않습니다.
1. 메뉴에서 내 프로젝트를 선택한 다음, 프로젝트 이름을 선택합니다.
2. 프로덕션 키 탭을 선택합니다.
3. 프로덕션 자격 증명을 가져오고 안전하게 저장합니다.
- 프로덕션 API 키와 시크릿 키를 안전한 위치에 복사하세요.
- 프로덕션 키는 요청 시 한 번만 표시되므로 안전한 위치에 저장하세요. 잃어버린 경우에는 나중에 새 키를 다시 생성할 수 있습니다.
4. 다음을 선택하여 프로덕션 키 탭에서 프로젝트 세부정보를 확인합니다.
더 많은 발송 고객번호를 추가하려면 발송 고객번호 테이블 상단에 있는 편집을 선택하세요.
검증 단계는 지역별로 다릅니다
아래에 나온 단계는 미국 및 캐나다 고객에게만 적용됩니다. 미국 및 캐나다 외 지역에 거주 중인 고객님들은 API 검증 페이지에서 지원 정보를 찾을 수 있습니다.
API 검증
일부 FedEx API는 프로덕션에 사용하기 전에 발송 라벨 검증이 필요합니다. 시작하기 전에 API 검증 요건을 검토하세요.
1. 메뉴에서 내 프로젝트를 선택한 다음, 프로젝트 이름을 선택합니다.
2. API 키 탭의 테스트 키에서 테스트 자격 증명을 찾으세요.
3. 테스트가 완료되면 프로젝트를 FedEx Developer Portal의 프로덕션으로 이동하여 검증을 시작하세요.
- 프로덕션 키는 요청 시 한 번만 표시되므로 안전한 위치에 저장하세요. 잃어버린 경우에는 나중에 새 키를 다시 생성할 수 있습니다.
4. 연락처 정보, 구현하려는 서비스, 고객번호 및 프로덕션 API 키를 포함하여 라벨 표지에 필요한 정보를 입력합니다.
5. 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
참고: 실제 라벨의 경우 잉크 번짐이나 손상 등 눈에 띄는 결함이 없는지 확인하세요. 라벨을 인쇄할 때 크기를 확대하거나 축소하지 마세요.
6. FedEx 바코드 분석 그룹이 제출된 라벨을 검토하고 해당 라벨을 승인 또는 거부합니다. 라벨이 거부된 경우 피드백을 해결하고 다시 제출하세요.
7. 승인되면 FedEx 바코드 분석 그룹에서 발송 라벨 트랜잭션을 위한 프로덕션 자격 증명을 인증한 후 이메일을 보냅니다.
참고: 승인은 프로젝트 단위로 적용됩니다. 새 프로젝트마다 승인이 필요합니다.
8. 테스트 URL 및 자격 증명을 프로덕션의 URL 및 자격 증명으로 변경합니다.
9. 샘플 데이터로 최종 프로덕션 테스트를 실행하여 모든 것이 예상한 대로 작동하는지 확인합니다.
