Fedex Logo

웹훅
생성 웹훅 관리

Advanced Integrated Visibility 웹훅 유형

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

FedEx Developer Portal에서 Advanced Integrated Visibility 웹훅 프로젝트를 생성한 후 웹훅을 선택한 수신 등록 유형에 기반한 한 개 이상의 FedEx 고객번호 또는 FedEx 배송 조회 번호에 연결할 수 있습니다.

탐색:

ADVANCED INTEGRATED VISIBILITY 고객번호 수신 등록  또는  ADVANCED INTEGRATED VISIBILITY 배송 조회 번호 수신 등록으로 이동하여 각 Advanced Integrated Visibility 웹훅 생성 단계를 확인하세요.

 

 

FedEx Advanced Integrated Visibility 개요


FedEx 고객은 고객번호 또는 배송 조회 번호를 구독하여, 배달 증명 사진을 포함해 라벨 생성부터 패키지 배달 증명에 이르기까지 배송 중인 발송물에 대해 실시간에 가까운 이벤트 알림을 받을 수 있습니다.

구독 유형


FedEx 고객은 다음 옵션에 따라 Advanced Integrated Visibility를 구독할 수 있습니다.

  • 고객번호 기반- FedEx 고객번호를 구독하여 고객번호에 맞는 발송물 업데이트를 받습니다.
  • 배송 조회 번호 기반- FedEx 배송 조회 번호를 구독하여 API 엔드포인트를 통해 지정된 배송 조회 번호에 맞는 발송물 업데이트를 받습니다.

참고: 현재 구독 시 청구를 위해 미국 기반 FedEx 9자리 고객번호가 필요하며, 고객에게는 배송 조회 번호 수를 기준으로 월 수수료가 청구됩니다. Advanced Integrated Visibility 요금에 대한 자세한 내용은 Advanced Integrated Visibility 개요 요금 가이드에서 확인하세요.

고객번호로 구독한 경우, 현재 구독 시 FedEx의 9자리 미국 기반 발송 고객번호가 필요합니다.

아래 표에서 Advanced Integrated Visibility 고객번호 수신 등록 및 Advanced Integrated Visibility 배송 조회 번호 수신 등록 기능에 관한 정보를 확인할 수 있습니다

기능 고객번호 수신 등록 배송 조회 번호 수신 등록
응답  보안 데이터 = 개인 식별 정보(PII) 데이터 발송인 및 수취인 데이터 SPOD CDO(편리한 배송 옵션)/응답 익명 데이터(개인 식별 정보(PII)를 제외한 발송물, 배송 중 업데이트/응답
연결 고객번호별 연결 = 모든 링크된 배송 조회 번호를 한꺼번에 연결 배송 조회 번호 연결 
소유권 고객번호는 사용자의 소유여야 합니다 배송 조회 번호는 사용자의 소유일 필요가 없습니다
필터링 인바운드, 아웃바운드 및 제3자 발송물로 이벤트를 필터링할 수 있음
 이벤트를 필터링할 수 없습니다
통합 고객번호 연결은 UI를 통해 진행됩니다 배송 조회 연결은 API 엔드포인트를 통해 진행됩니다
제한 사항 최대 100개의 고객번호를 추가할 수 있습니다 요청당 최대 1,000개의 배송 조회 번호를 추가할 수 있습니다
적합한 이용 사례 퍼스트파티 고객 - 고객이 고객번호를 소유한 경우 서드파티 고객 - 퍼스트파티 고객이 소유한 배송 조회 번호를 고객이 보유한 경우

 

FedEx Integrated Visibility – 구독 유형별 기능 비교

기능 / 데이터 요소 배송 조회 번호 수신 등록 고객번호 수신 등록 참고
SPOD(배달 증명 서명) 이용 불가 이용 가능(구성 필요) TIFF 형식의 서명 이미지가 페이로드에서 제공됨
PPOD(배달 증명 사진) 이용 가능(구성 필요) 이용 가능(구성 필요) 배송 위치의 JPEG 이미지가 base64 형식으로 인코딩되어 제공됨
PPODA(배달 시도 증명 사진) 이용 가능(구성 필요) 이용 가능(구성 필요) 배달 시도에 대해 JPEG 이미지가 제공됨
GPS 좌표(gpsPodCoordinates) 이용 불가 사용 가능 배송 조회 기반 구독에서 마스킹 처리됨
연락처 정보(이름, 전화번호, 회사) 마스킹 처리됨 사용 가능 발송인, 수취인, 출발지, 도착지, 브로커 등 포함
도로명 주소 및 우편 번호 마스킹 처리됨 사용 가능 streetLines 및 postalCode는 배송 조회 기반 페이로드에서 마스킹 처리됨
고객번호 마스킹 처리됨 사용 가능 billTo, 발송인 및 수취인 고객번호 값 포함
패키지 재무 정보(예: declaredValue, codAmount) 마스킹 처리됨 사용 가능 관세, COD 및 신고 금액은 마스킹 처리됨
문의 및 반송 세부정보(문의 코드, 반송 사유) 마스킹 처리됨 사용 가능 전체 세부정보는 고객번호 기반 구독자에게만 표시됨
물품 및 내용물 데이터 마스킹 처리됨 사용 가능 부품 코드, 설명, 수량 포함
직원 ID(예: 이벤트 직원) 마스킹 처리됨 이용 불가 개인정보 보호를 위해 두 경우 모두 마스킹 처리됨
이벤트 알림 및 EDD/EDTW 사용 가능 사용 가능 두 경우 모두 예상 배송일/시간 기능 지원됨
복수 발송물(MPS) 사용 가능 사용 가능 추가 배송 조회 정보 포함
예상 배송 정확도 및 위험 점수 사용 가능 사용 가능 프리미엄 티어에만 포함

 

Advanced Integrated Visibility 배송 조회 번호 구독의 마스킹 처리된 데이터 필드

요약

Advanced Integrated Visibility 고객번호 구독 대신 Advanced Integrated Visibility 배송 조회 번호 구독을 사용해 발송물 배송 조회 업데이트를 구독한 경우, 고객의 개인정보를 보호하고 데이터 보안 정책을 준수하기 위해 특정 데이터 필드가 마스킹 처리됩니다.

마스킹 처리 시 승인된 당사자만 개인 연락처 세부정보, 주소, 재무 가치 등 민감한 정보에 액세스할 수 있습니다. 해당 데이터는 Advanced Integrated Visibility 배송 조회 번호 구독을 통해 이용할 수 있지만, Advanced Integrated Visibility 배송 조회 번호 구독을 사용하는 고객에겐 아래 나열된 마스킹 처리된 필드가 'XXXXX'로 표시됩니다.

이 마스킹 처리의 영향은 다음과 같습니다.

  • 출발지/도착지 세부정보 및 관련 당사자에 대한 가시성이 제한됩니다.
  • 개인 식별자(예: 이름, 전화번호) 및 재무 또는 세관 관련 데이터가 포함되지 않습니다.
  • 보안 및 규제 준수를 위해 독점적이거나 민감한 발송물 정보를 보호합니다.

업무 또는 비즈니스 목적으로 마스킹 처리된 필드에 대한 접근이 필요한 고객은 고객번호를 이용해 구독할 것을 권장합니다.

Advanced Integrated Visibility 배송 조회 번호 구독에서 마스킹 처리되는 데이터 포인트는 다음과 같습니다.

스캔 이벤트

  • scanEvent/location/locationContactAndAddress/address/streetLines
  • scanEvent/location/locationContactAndAddress/contact/phoneNumber
  • scanEvent/location/locationContactAndAddress/contact/companyName
  • scanEvent/location/locationContactAndAddress/contact/personName
  • scanEvent/previousEvents/[Array]/location/locationContactAndAddress/address/streetLines
  • scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/phoneNumber
  • scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/companyName
  • scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/personName

발송인 정보

  • trackResult/shipperInfo/contactAndAddress/address/postalCode
  • trackResult/shipperInfo/contactAndAddress/address/streetLines
  • trackResult/shipperInfo/contactAndAddress/contact/phoneNumber
  • trackResult/shipperInfo/contactAndAddress/contact/companyName
  • trackResult/shipperInfo/contactAndAddress/contact/personName
  • trackResult/shipperInfo/account/value

수취인 정보

  • trackResult/recipientInfo/contactAndAddress/address/postalCode
  • trackResult/recipientInfo/contactAndAddress/address/streetLines
  • trackResult/recipientInfo/account/value
  • trackResult/recipientInfo/contactAndAddress/contact/phoneNumber
  • trackResult/recipientInfo/contactAndAddress/contact/companyName
  • trackResultecipientInfo/contactAndAddress/contact/personName

출발지 및 도착지 위치

  • trackResult/originLocation/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/originLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/originLocation/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/originLocation/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/originLocation/locationDetail/locationContactAndAddress/address/postalCode
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/postalCode

배달 및 주소 변경 세부정보

  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/postalCode
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/gpsPodCoordinates
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/postalCode
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/companyName

브로커 정보

  • trackResult/broker/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/broker/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/broker/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/broker/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/broker/locationDetail/locationContactAndAddress/address/postalCode

패키지 및 재무 세부정보

  • trackResult/packageDetail/customsValue/value
  • trackResult/packageDetail/declaredValue/value
  • trackResult/packageDetail/originalTransportationCharge/value
  • trackResult/codDetail/codAmount/value

문의 및 물품 정보

  • trackResult/inquiries/[Array]/categoryCode
  • trackResult/inquiries/[Array]/code
  • trackResult/inquiries/[Array]/createTime
  • trackResult/inquiries/[Array]/statusCode
  • trackResult/commodityInfo/[Array]/description
  • trackResult/commodityInfo/[Array]/code

패키지 내용물 및 반송 사유

  • trackResult/contents/[Array]/partNumber
  • trackResult/contents/[Array]/partCode
  • trackResult/contents/[Array]/description
  • trackResult/contents/[Array]/quantity
  • trackResult/returnReason/[Array]/code
  • trackResult/returnReason/[Array]/description

청구 정보

  • trackResult/billToParties/[Array]/billToParty/accountNumber

고객의 이점:

  • 예상 배송일 및 배송 당일 시간 범위 등의 배송 관련 변경 사항 발생 시 신속한 알림을 수신할 수 있어 수취인이 더욱 안심할 수 있습니다.
  • WISMO(주문 배송 위치 조회) 호출에 따른 고객 서비스 비용은 물론, FedEx 배달 증명 사진을 제공해 배송 이의 제기를 줄일 수 있습니다.
  • 발송물 상태에 대한 실시간에 가까운 알림을 제공할 수 있어 고객 경험이 향상됩니다.
  • 발송물마다 배송 조회 업데이트를 확인하기 위해 계속 폴링을 요청하는 대신, 발송물에 대한 실시간 푸시 업데이트를 수신함으로써 운영 효율성이 높아집니다.

기능 및 배송 조회 이벤트


배송 조회 이벤트

발송물 배송 단계에서 여러 업데이트에 대해 고객에게 알림을 보내 발송물의 상태를 사전에 추적할 수 있습니다. 고객은 알림을 받을 발송물 진행/이벤트 단계를 구체적으로 선택할 수 있습니다. 이용 가능한 발송 이벤트는 다음과 같습니다.

  • 발송: 선택한 발송물 이벤트가 발생하면 알림을 제공합니다. 예: 라벨 생성됨, 픽업 등
  • 운송 중: 발송물 운송 이벤트가 발생하면 알림을 제공합니다. 예: 운송 중, 배송 사무소에서 보관 중인 품목 등
  • 배송: 발송물 배송 이벤트가 발생하면 알림을 제공합니다. 예: 배송 중, 배송됨 등
  • 예외 사항: 배송 예외 사항이 발생하면 알림을 제공합니다. 예: 통관 지연 등
  • 편리한 배송 옵션: 일부 맞춤 배송 조회 이벤트가 발생하면 알림을 제공합니다. 예: FedEx 접수처에 보관 요청 수락됨

이용 가능한 발송물 이벤트 옵션에 관한 자세한 정보는 Advanced Integrated Visibility 배송 조회 이벤트 상태 코드 및 상태 표를 참조하세요.


배달 증명


이 기능은 주문이 의도한 도착지에 성공적으로 도착했음을 알립니다. 여기에는 다음이 포함됩니다.

  • 배달 증명 사진(PPOD): PPOD 이용 시, 패키지가 배송되면 패키지의 정확한 위치를 알 수 있는 사진이 고객에게 제공됩니다.
    Advanced Integrated Visibility는 base64 형식으로 JSON 페이로드를 통해 PPOD 이미지를 제공합니다. 이 이미지는 이후에 JPEG 형식으로 변환할 수 있습니다.

    참고:

    • PPOD는 미국, 캐나다, 푸에르토리코, 홍콩, 뉴질랜드, 영국, 아일랜드에서 이용할 수 있습니다.
    • PPOD는 FedEx Ground, FedEx Express, 주거 지역 패키지/거주지 주소용으로만 이용할 수 있습니다.
    • PPOD는 SPOD가 필요하지 않은 배송에 이용할 수 있습니다. PPOD와 SPOD는 같이 이용할 수 없습니다.
    • PPOD는 고객에게 직접 전달(예: 배송 중 고객에게 직접 인도)되지 않는 서명 불필요(NSR) 배송에 이용할 수 있습니다.
    • PPOD는 14,000~33,000바이트의 이미지 크기를 지원합니다(320 x 240 해상도 이미지 적용 가능).

     

  • 배달 시도 증명 사진(PPODA): PPODA 이용 시, 배송을 완료할 수 없는 경우 패키지가 배송될 위치를 정확하게 알 수 있는 사진이 고객에게 제공됩니다. Advanced Integrated Visibility는 base64 형식으로 JSON 페이로드를 통해 PPODA 이미지를 제공합니다. 이 이미지는 이후에 JPEG 형식으로 변환할 수 있습니다.
    • PPODA는 미국 및 푸에르토리코에서 이용할 수 있습니다.
    • PPODA는 FedEx Ground, FedEx Express, 주거 및 상업 지역 패키지/거주지 및 사업체 주소용으로만 이용할 수 있습니다.
    • PPODA 이미지 예시:
      1. 문의 Doortag를 찍은 PPODA 이미지
      2. 배송지 접근을 제한하는 장애물 사진(예: 잠긴 문)
      3. 정차지에서 배송된 패키지의 PPOD 이미지
    • PPODA는 14,000~33,000바이트의 이미지 크기를 지원합니다(320 x 240 해상도 이미지 적용 가능)

    •  

  • 배달 증명 서명(SPOD): SPOD 이용 시, 수취인의 서명과 이름, 배송 날짜, 시간, 위치가 담긴 이미지가 고객에게 제공됩니다. SPOD 정보는 이미지 대신 바이트 배열로 표시됩니다. 바이트 배열이란 base64로 인코딩된 스트링으로, PNG 형식의 최종 서명 이미지를 받기 위해 디코딩되어야 합니다
    • SPOD는 Advanced Integrated Visibility 배송 조회 번호 구독에서 이용할 수 없습니다.
    • SPOD 이미지 크기는 4,000~6,000바이트여야 합니다(400x95 해상도 이미지 적용 가능).
    • SPOD 이미지 크기는 5,000~8,000바이트여야 합니다(230x150 해상도 이미지 적용 가능).

    •  

  • GPS 배달 증명(GPSPOD):
    • GPS POD는 고객에게 배송 위치의 지리적 좌표를 제공합니다.

      참고: GPSPOD는 Advanced Integrated Visibility 고객번호 구독 시 기본적으로 사용 가능합니다.

예상 배송일(예정된 픽업일 기준) 및 시간 범위 이벤트


발송물 배송 날짜 및/또는 시간 범위를 제공해 발송물 수취인이 일정을 계획하는 데 도움을 줍니다. 여기에는 다음이 포함됩니다.

  • 예상 배송일(예정된 픽업일 기준)(EDD): 발송물이 배송될 것으로 예상되는 날짜를 수령인에게 제공합니다. 예: 20XX년 11월 20일
  • 예상 배송 시간 범위(EDTW): 실제 배송일에 발송물이 배송될 것으로 예상되는 시간 범위를 수령인에게 제공합니다. 예: 오후 2시~6시


이벤트 기반 필터링


발송물 청구 방식에 따라 웹훅 프로젝트를 정리할 수 있습니다. 옵션은 다음과 같습니다.

  • 인바운드: 수취인으로서 본인에게 배송되고 비용이 청구되는 발송물입니다.
  • 아웃바운드: 발송인으로서 본인이 발송하고 본인에게 비용이 청구되는 발송물입니다.
  • 제3자: 제3자 지불인으로서 본인에게 비용이 청구되는 인바운드 및 아웃바운드 발송물입니다.

참고: 발송물 비용 청구 및 결제에 본인의 FedEx 고객번호가 사용됩니다. 제3자 지불인의 경우, 발송인 또는 수취인이 아니더라도 본인의 FedEx 고객번호로 비용이 청구됩니다.


재시도 정책

클라이언트 측 문제 발생 시 FedEx가 배송 조회 이벤트 데이터를 전송하지 못하게 하는 기능입니다. 이 경우, FedEx는 데이터를 보관하고 5분 간격으로 재전송을 3회 시도합니다.

지정된 시간 내에 응답을 받지 못하면 해당 이벤트의 재배송이 중단됩니다. 그러나 고객은 Advanced Integrated Visibility 웹훅 프로젝트 세부정보 페이지에서 수동 '재시도' 버튼을 통해 지난 7일 동안 누락된 이벤트를 요청할 수 있습니다.

재시도 정책에 관한 자세한 정보는 재시도 메커니즘 섹션을 참조하세요.

CLOSE

Response

Copy