Fedex Logo

웹훅
생성 웹훅 관리

Advanced Integrated Visibility 활용 방법

Advanced Integrated Visibility 웹훅 개요

FedEx는 Advanced Integrated Visibility 웹훅을 이용해 지정된 FedEx 고객번호에 연결된 발송물의 실시간에 가까운 보안 배송 조회 이벤트 데이터를 목적 URL로 안전하게 전달합니다.

이 기능을 이용하려면 FedEx 관리자 또는 DI 관리자가 Advanced Integrated Visibility 웹훅 프로젝트를 생성해야 합니다.

 

탐색 옵션

다음 두 가지 방식으로 Advanced Integrated Visibility 웹훅 페이지에 접근할 수 있습니다.

옵션 1: 내 프로젝트를 통한 경로

  •  왼쪽 탐색 패널에서 '내 프로젝트'로 이동합니다.
  •  웹훅 탭을 클릭합니다.

옵션 2: API 카탈로그를 통한 경로

  •  왼쪽 탐색 패널에서 API 카탈로그로 이동합니다.
  •  검색 막대를 사용해 Advanced Integrated Visibility를 검색하거나 필터 섹션에서 해당 항목을 찾습니다.
  •  웹훅 카드에서 다음 중 하나를 선택합니다.
  •  문서를 클릭한 다음 → + 웹훅 관리를 클릭합니다.

Advanced Integrated Visibility 배송 조회 번호 수신 등록 보기

1. FedEx 개인 액세스 및 설정

  •  FedEx 관리자 또는 FedEx 담당자가 설정 절차를 시작합니다.
  •  조직 프로필은 CSP 고객을 대신하여 지정된 관리자가 생성합니다.
  •  관리자가 고객을 대신하여 이용 가능한 미국 기반 청구 고객번호를 조직 단위에서 추가합니다.
  •  이 설정을 수행하는 관리자는 조직 단위 구성을 관리할 적절한 권한이 있어야 합니다.

2. 배송 조회 번호 수신 등록 워크플로 보기

2.1 수신 등록 보기

  •  FedEx 관리자 또는 담당자가 프로젝트를 생성하면 사용자는 연결된 Advanced Integrated Visibility – 배송 조회 번호 수신 등록 프로젝트를 대시보드에서 확인할 수 있습니다.

2. 기능 보기

  •  사용자는 더 나은 이해와 활용을 위해 수신 등록 프로젝트와 연관된 이용 가능한 기능을 탐색할 수 있습니다.

기능 설명

필드 이름 설명
배송 증명서 발송물이 성공적으로 배송되었음을 확인합니다. 여기에는 다음이 포함됩니다.
  • 배달 증명 사진(PPODA): 정확한 배송 위치를 보여주는 사진을 제공합니다.
  • 배달 증명서 서명(SPOD): 수취인의 서명, 이름, 배송 날짜, 시간, 위치가 담긴 이미지를 제공합니다.
예상 배송 날짜 수취인이 미리 계획할 수 있도록 다음을 제공합니다.
  • 예상 배송일(예정된 픽업일 기준)(EDD)
  • 예상 배송 시간 범위(EDTW)
배송 조회 이벤트 알림을 받을 이벤트 카테고리를 하나 이상 선택할 수 있습니다.
  • 발송
  • 배송 중
  • 배달
  • 예외 사항

 

세부정보 페이지에 다음 정보가 표시됩니다.

필드 이름 설명
웹훅 프로젝트 이름 웹훅 프로젝트에 사용할 고유하고 비어 있지 않은 이름이어야 합니다. 추천 이름이 자동으로 입력되지만, 편집할 수 있습니다. 이 이름은 다른 웹훅에서 중복 사용할 수 없습니다.
목적 URL FedEx가 배송 조회 이벤트 데이터를 전송할 보안 HTTPS 엔드포인트입니다.
필수 요건:
  • 유효하고 정상적으로 동작해야 합니다
  • 표준화된 구문을 따라야 합니다
  • fedex.com 또는 이의 하위 도메인을 포함하지 않아야 합니다
  • 여러 웹훅에서 재사용할 수 있습니다
자세한 내용은 비즈니스 규칙 및 모범 사례 섹션을 참조하세요.
보안 토큰 HMAC를 통해 웹훅 응답을 인증 및 검증하는 데 사용되는 공유된 시크릿입니다.
필수 요건:
  • 26–100자
  • 대문자, 소문자, 숫자가 각각 1개 이상 포함되어야 합니다
  • 여러 웹훅에서 재사용할 수 있습니다
페이로드 언어(국가) 드롭다운 목록에서 배송 조회 데이터를 번역할 언어를 선택합니다.
배송 조회 유형 배송 조회 데이터를 제공받을 방법을 선택합니다.
  • 자세한 배송 조회 – 전체 이벤트 내역
  • 이벤트별 배송 조회 – 최신 이벤트만
이메일 주소 알림을 받으려면 유효한 이메일 주소를 입력하세요.
이메일 언어(국가) 이메일 알림에 사용할 기본 언어를 선택합니다.
참고: 미국 로케일만 지원됩니다(예: en-US, es-US).

 

단계별 과정 안내

4. 수신 등록 프로젝트 생성하기

  •  이전 섹션의 단계를 사용하거나 시작하기 가이드를 참조하세요.

5. OAuth 토큰 생성하기

  •  API 호출을 하려면 OAuth 토큰이 필요합니다.
  •  Authorization API를 사용해 토큰을 생성하세요.
  •  자세한 방법은 API 카탈로그 내 Authorization API 문서를 참조하세요.

6. API 문서 액세스

  •  왼쪽 탐색 메뉴에서 프로젝트 세부정보를 클릭합니다.
  •  프로덕션 키 탭에서 스크롤하여 Advanced Integrated Visibility Tracking Number Subscription API 문서를 찾습니다.

 

API 엔드포인트 개요

엔드포인트 목적
배송 조회 번호 연결 웹훅 수신 등록에서 배송 조회 번호를 추가하거나 제거합니다. 비동기식 작업으로, 응답으로 작업 ID를 받습니다.
배송 조회 번호 작업 세부정보 성공적으로 추가되거나 아직 처리 중인 배송 조회 번호 개수 등 특정 작업 ID에 대한 세부정보를 제공합니다.
배송 조회 번호 작업 상태 현재 처리 중인 모든 작업의 요약을 반환합니다.

 

2단계에서 생성된 OAuth 토큰과 배송 조회 번호 연결 엔드포인트를 사용해 웹훅에 배송 조회 번호를 추가하세요.

유효성 검사 규칙

  •  웹훅 이름은 고유해야 합니다.
  •  목적 URL은 표준화된 구문 형식이어야 합니다.
  •  필수 필드는 모두 입력해야 합니다.
  •  유효한 고객번호를 최소 한 개 이상 연결해야 합니다.

유효성 검사 결과

상태 세부정보
성공 다음과 같이 확인 메시지가 표시됩니다.
“<>이(가) 생성되었습니다. 변경 사항이 적용되는 데 최대 10분이 소요될 수 있습니다."
실패 FedEx가 200(확인) 또는 202(수락) 외 다른 응답을 수신하면 웹훅 목적 URL 유효성 검사가 실패로 간주됩니다.
CLOSE

Response

Copy