2025년 8월 12일
FedEx Advanced Integrated Visibility 2025년 7월 개선 사항 및 향후 릴리즈
웹훅 제품, 고객 가시성, 통합 경험을 개선하기 위한 지속적인 노력의 일환으로 아래와 같은 여러 주요 업데이트를 도입할 예정이거나 이미 배포했습니다.
릴리즈 날짜: 2025년 7월 31일
- 조직 내 여러 웹훅 구독에서 동일한 발송 고객번호를 추가하는 기능 도입.
- 가독성을 개선하기 위해 웹훅 문서 페이지 재설계.
- 결함 수정 - Account Number subscription API 및 Track Number Subscription API에서 샌드박스 URL 제거. 프로덕션 URL은 기본값으로 표시.
- 결함 수정 - 사용자가 대량의 발송 고객번호를 확인 및 검색할 수 있도록 웹훅 대시보드 UI 문제 해결.
향후 개선 사항– 2025년 9월
- 이벤트 설명 표준화(마침표 제거).
- 배송 조회 스키마 내 사용되지 않는 필드 제거.
- 주소 세부정보, FedEx 접수처에 보관 시설 유형, 픽업 노드 추가.
추가 세부정보:
향후 변경 사항이 웹훅 통합에 부정적인 영향을 주지 않도록 아래 릴리즈 세부정보를 확인하세요.
2025년 7월 31일 릴리즈 - 세부 참고 사
1. 웹훅 구독 전체에 걸친 발송 고객번호 복사
동일한 조직 내 웹훅을 생성 또는 업데이트할 경우, 고객은 여러 구독 ID에 걸쳐 동일한 발송 고객번호를 추가할 수 있습니다. 국가 제한이 적용되지 않습니다.
예시 시나리오:
- 발송 고객번호: ABC123456
- 구독 ID: SubscriptionID-001, SubscriptionID-002, SubscriptionID-003
이제 웹훅 생성 또는 업데이트 시 ABC123456를 3개 구독 전체에 추가하여 조직 시스템 전체에 걸쳐 일관된 배송 조회 및 이벤트 관리가 가능합니다.
업데이트된 웹훅 문서
이제 웹훅 문서 페이지가 개선된 형식 및 시각 자료를 갖추어 더 명확하고 자세한 설명으로 개발자에게 도움을 줍니다.
결함 수정 사항
- 이번 릴리즈에서는 Account Number Subscription API 및 Tracking Number Subscription API에 대해 API 엔드포인트 문서에서 프로덕션 서버 URL만 공유하고 있습니다. 이는 내용을 명확히 하고, 혼란을 줄이는 동시에, 프로덕션에 바로 적용할 수 있도록 하기 위함입니다.
- 사용자가 대량 발송 고객번호를 이용하여 FedEx Developer Portal(FDP)에서 웹훅 생성을 시도하면 오류가 발생하던 문제를 해결했습니다. 이 오류는 웹훅 설정 프로세스에서 전체 고객번호 목록을 로드 또는 표시할 수 없어서 발생했습니다. 이제 사용자는 여러 발송 고객번호로 웹훅 구성 시 모든 고객번호를 확인 및 선택할 수 있습니다.
향후 릴리즈 세부정보 - 2025년 9월
아래에서 향후 릴리즈 세부정보를 확인하세요. 필수적인 개발 작업이 완료되는 즉시 자세한 릴리즈 일정을 공유해 드리겠습니다.
1. 웹훅 데이터 내 이벤트 설명 표준화
시스템 및 통합 전반에 걸쳐 일관성을 유지하기 위해 이벤트 설명의 마침표를 제거할 예정입니다. 이 변경 사항은 모든 이벤트 유형에 적용되며 플랫폼 전체에 걸쳐 일관된 형식을 유지하는 데 도움을 줍니다.
웹훅 통합에 어떤 영향을 줄까요?
시스템이 정확한 이벤트 설명 형식(예: 파싱 또는 매칭용)을 사용하는 경우, 이로 인해 호환되지 않을 수 있습니다.
영향을 받는 이벤트 설명 전체 목록은 아래와 같습니다.
| 현재 이벤트 설명(변경 전) | 신규 이벤트 설명(변경 후) |
|---|---|
| 공항에서 적하 목록 데이터 확인. | 공항에서 적하 목록 데이터 확인 |
| 관세사에서 통관 완료됨. | 관세사에서 통관 완료됨 |
| 관세사에게 도착. | 관세사에게 도착 |
| 관세사에서 통관 지연. | 관세사에서 통관 지연 |
| 도착지 FedEx 시설에 도착. | 도착지 FedEx 시설에 도착 |
| 도착지 FedEx 시설에 있음. | 도착지 FedEx 시설에 있음 |
| 도착지 FedEx 시설에 정시 도착. | 도착지 FedEx 시설에 정시 도착 |
| 도착지 FedEx 시설에 조기 도착. | 도착지 FedEx 시설에 조기 도착 |
| 도착지 FedEx 시설에서 픽업 준비됨. | 도착지 FedEx 시설에서 픽업 준비됨 |
| 도착지 FedEx 시설에서 배송 예외 사항 발생. | 도착지 FedEx 시설에서 배송 예외 사항 발생 |
| 도착지 FedEx 시설에서 지연. | 도착지 FedEx 시설에서 지연 |
| 도착지 FedEx 시설에 보관. | 도착지 FedEx 시설에 보관 |
| 배송 위치에 도착. | 배송 위치에 도착 |
| 배송 위치에서 배송 예외 사항 발생. | 배송 위치에서 배송 예외 사항 발생 |
| 배송 위치에 정시 도착. | 배송 위치에 정시 도착 |
| 배송 위치에 조기 도착. | 배송 위치에 조기 도착 |
| 배송 위치에 배송 지연. | 배송 위치에 배송 지연 |
| 운송 중 배송 옵션 요청 취소됨. | 운송 중 배송 옵션 요청 취소됨 |
| 운송 중 조기 도착. | 운송 중 조기 도착 |
| 운송 중 정시 도착. | 운송 중 정시 도착 |
| 운송 중 픽업 지연. | 운송 중 픽업 지연 |
| 운송 중 통관 완료됨. | 운송 중 통관 완료됨 |
| 운송 중 배송 지연. | 운송 중 배송 지연 |
| FedEx 시설에서 통관 완료됨. | FedEx 시설에서 통관 완료됨 |
| FedEx 시설에서 통관 지연. | FedEx 시설에서 통관 지연 |
| FedEx 시설에 있음. | FedEx 시설에 있음 |
| FedEx 시설에서 출발. | FedEx 시설에서 출발 |
| FedEx 시설에 도착. | FedEx 시설에 도착 |
| FedEx 시설에서 통관 진행 중. | FedEx 시설에서 통관 진행 중 |
| FedEx 시설에 정시 도착. | FedEx 시설에 정시 도착 |
| FedEx 시설에 조기 도착. | FedEx 시설에 조기 도착 |
| 출발지 FedEx 시설에 도착. | 출발지 FedEx 시설에 도착 |
| FedEx 시설에서 지연. | FedEx 시설에서 지연 |
| 출발지 FedEx 시설에서 출발. | 출발지 FedEx 시설에서 출발 |
| FedEx 시설에서 보관 중. | FedEx 시설에서 보관 중 |
| FedEx 시설에서 인계. | FedEx 시설에서 인계 |
| FedEx 시설에서 On Demand Care. | FedEx 시설에서 On Demand Care |
| 출발지 FedEx 시설에 정시 도착. | 출발지 FedEx 시설에 정시 도착 |
| 출발지 FedEx 시설에 조기 도착. | 출발지 FedEx 시설에 조기 도착 |
| 출발지 FedEx 시설에서 통관 지연. | 출발지 FedEx 시설에서 통관 지연 |
| 출발지 FedEx 시설에서 위치 변경됨. | 출발지 FedEx 시설에서 위치 변경됨 |
| 출발지 FedEx 시설에서 통관 완료됨. | 출발지 FedEx 시설에서 통관 완료됨 |
| 출발지 FedEx 시설에서 인계. | 출발지 FedEx 시설에서 인계 |
| 픽업 접수처에 정시 도착. | 픽업 접수처에 정시 도착 |
| 픽업 접수처에 조기 도착. | 픽업 접수처에 조기 도착 |
| 픽업 접수처에서 보관 중. | 픽업 접수처에서 보관 중 |
| 차량에 조기 도착. | 차량에 조기 도착 |
| 차량에 정시 도착. | 차량에 정시 도착 |
| 도착지에서 출발. | 도착지에서 출발 |
| 도착지에 도착. | 도착지에 도착 |
| 도착지에 조기 도착. | 도착지에 조기 도착 |
| 도착지에 정시 도착. | 도착지에 정시 도착 |
| 픽업 접수처에 도착. | 픽업 접수처에 도착 |
| 픽업 접수처에서 픽업 지연. | 픽업 접수처에서 픽업 지연 |
2. 스키마 정리 및 필드 제거
중복을 줄이고 페이로드를 간소화하기 위해 배송 조회 응답 스키마에서 다음 필드가 제거됩니다.
- scanEvent/eventAdditionalInfo/employeeId
- scanEvent/previousEvents/[Array]/eventAdditionalInfo/employeeId
- trackResult/documents/[Array]/systemId
- trackResult/documents/[Array]/lineNbr
- trackResult/documents/[Array]/recordId
- trackResult/documents/[Array]/folderId
해당 필드는 더 이상 필요하지 않으며 향후 릴리즈에서 삭제됩니다.
3. FedEx 접수처에 보관, 픽업 준비됨 이벤트 개선 사항
위치 세부정보가 추가됩니다. 이전에는 보관 이벤트가 다음과 같이 표시되었습니다.
<시설>에 보관
이제는 다음과 같이 표시됩니다.
<주소>(<시설 유형>)에 보관
이번 변경 사항으로 고객이 픽업할 패키지가 보관되어 있는 정확한 장소를 더 명확하게 확인할 수 있게 되어, 전반적인 배송 경험이 향상됩니다.
"픽업 준비됨" 이벤트의 경우, 이벤트 설명에서 주소 라인이 공개 및 추가됩니다. 이번 개선 사항으로 추가 필드를 확인할 필요 없이 패키지 픽업 장소를 바로 알 수 있습니다.
예:
변경 전:
FedEx Office에서 픽업
변경 후:
수취인 픽업 준비됨
(패키지 픽업 가능 장소: FedEx Office – 610.9TH ST), DURHAM, NC
이로써 고객은 패키지를 픽업할 장소를 정확히 파악할 수 있으며, 특히 근처에 FedEx 접수처가 여러 곳 있을 때 도움이 될 겁니다.
