소개
픽업 요청 API를 사용해 픽업 가능 여부를 확인한 후 배송직원에게 픽업을 예약하거나 픽업 요청을 취소할 수 있습니다.
픽업 요청 API는 FedEx Express 및 FedEx Ground(반송 및 아웃바운드) 발송 가능 지역 전체에 걸쳐 신규 또는 기존에 처리된 패키지를 대상으로 이용 가능합니다. 이 상세 가이드에서 픽업 요청 API에 관해 꼭 알아두어야 할 모든 최신 정보를 확인할 수 있습니다.
픽업 요청 API 세부 정보
다음은 픽업 요청 API와 관련된 주요 기능입니다.
픽업 가능 여부 확인
픽업 가능 여부 확인 기능을 이용해 입력한 요청을 바탕으로 픽업 서비스의 가능 여부를 확인해볼 수 있습니다. 픽업 가능 여부는 마감 시간과 준비 시간, 두 가지 요인에 따라 결정됩니다.
마감 시간 - 픽업을 예약할 수 있는 가장 늦은 시간입니다. 시간은 픽업 지역 우편 번호 기준 현지 시간입니다.
준비 시간 - 픽업 준비 완료 시간(패키지가 픽업될 준비를 마치는 시점)부터 배송직원이 패키지를 픽업할 준비가 완료되는 시점까지의 시간입니다.
픽업 생성
이 옵션을 사용해 픽업을 예약하고 FedEx Express® FedEx Ground® 국내 및 국제 발송을 신청할 수 있습니다. FedEx Ground 및 Express 픽업 요청 API에서는 픽업 확인 번호를 확인할 수 있으며, 예약된 픽업에 대해 Express 픽업을 요청 시 위치 코드가 추가로 반환됩니다. 또한 이 API를 이용해 반송 화물의 픽업도 예약할 수 있습니다.
추가 수취인 주소 입력줄(주소 입력줄 3)에 더 완전하고 정확한 위치 세부 정보를 입력하면 더 신속하게 FedEx Express® 발송물을 배송할 수 있습니다. FedEx 배송직원이 고객님이 있는 위치나 다른 위치에서(추가 요금이 발생할 수 있음) 발송물을 픽업하도록 예약하여 소요 시간과 노력을 줄일 수 있습니다.
픽업 취소
이 옵션을 사용해 기존 픽업 예약을 취소할 수 있습니다. 이 옵션은 FedEx Express 및 FedEx Ground 국내 및 국제 발송을 대상으로 합니다. FedEx Express 국내 및 국제 픽업은 요청 당일에 취소 가능합니다. FedEx Ground 국내 및 국제 발송물은 픽업 요청 제출 후 24시간 이내에 취소 가능합니다. 발송물이 이미 픽업되었다면, FedEx 고객 서비스 800 FedEx(800 3339)로 연락해 취소를 진행하시기 바랍니다.
픽업 요청 세부 정보
FedEx Express 픽업 요청
- 패키지는 우편번호 기준 해당 접수처의 마감 시간 내에 픽업 준비를 마쳐야 합니다. 마감 시간은 픽업 가능 여부 요청 시 검색할 수 있습니다.
- 패키지가 픽업 준비를 마치는 시점부터 배송직원이 패키지 픽업을 위해 더는 접수처에 방문할 수 없게 되는 시점까지의 시간이 "준비 시간" 보다 짧아선 안 됩니다. 준비 시간 또한 픽업 가능 여부 확인 요청 시 검색할 수 있습니다.
- FedEx Express 픽업은 현재 또는 다음 영업일로 예약할 수 있습니다.
- 단일 픽업 요청당 허용되는 최대 패키지 수량은 99개입니다.
- 기존에 정기 예약 픽업을 이용 중인 경우에는 1회 픽업을 예약하거나 또 다른 정기 예약 픽업을 추가로 요청하지 않아도 됩니다.
- 픽업 요청은 변경할 수 없습니다. 요청을 변경하려면 기존 요청을 취소하고 새로운 요청을 입력해야 합니다.
- FedEx 시스템은 현재 영국 국내 픽업 기능을 지원합니다.
예를 들어 ‘PT4H0M’은 픽업 시간이 4시 0분임을 나타냅니다.
FedEx Ground 픽업 요청
- 다음 영업일 또는 영업일 기준 최대 2주 이후의 픽업을 미리 예약할 수 있습니다.
- 단일 픽업 요청당 허용되는 최대 패키지 수량은 99개입니다.
- 기존에 정기 예약 픽업을 이용 중인 경우에는 1회 픽업을 예약하거나 또 다른 정기 예약 픽업을 추가로 요청하지 않아도 됩니다.
- 추가 요금 부담 시 거주지 주소에서도 픽업 서비스 이용이 가능합니다.
- 픽업 요청은 변경할 수 없습니다. 요청을 변경하려면 기존 요청을 취소하고 새로운 요청을 입력해야 합니다.
픽업 요청 API 서비스 유형
FedEx Express 픽업
fedex.com 및 FedEx 고객 서비스를 통해 접수된 요청을 포함한 FedEx Express 픽업 요청 시에는 배송직원 픽업 요금이 부과됩니다.
FedEx Ground 픽업
FedEx Ground는 요청 시 픽업 서비스를 제공하며 추가 요금이 발생합니다. 정기 예약 픽업 고객의 경우 해당 서비스를 이용하는 고객 번호로 주당 픽업 요금을 부과합니다.
- 정기 예약 픽업을 이용하지 않는 고객에게는 패키지당 일회성 픽업 요금을 부과합니다. FedEx 발송 접수처에서 방문 접수를 하는 경우에는 일회성 픽업 요금이 부과되지 않습니다. 또한 FedEx Ground® Economy(이전 명칭: FedEx SmartPost®) 반송 라벨 인쇄, FedEx Ground® Economy(이전 명칭: FedEx SmartPost®) 반송 라벨 이메일 및 FedEx Ground® 패키지 반송 프로그램 픽업에도 픽업 수수료가 부과되지 않습니다.
- 정기 예약 픽업 고객의 경우 요청 시 FedEx Ground 고객번호에 등록된 발송 접수처가 아닌 다른 주소에서도 픽업 서비스를 제공합니다. 이 서비스를 이용하면 대체 주소에 대한 추가 픽업 요금이 각 주소당 주별로 부과될 수 있습니다.
FedEx Extra Hours
FedEx Extra Hours 서비스는 월요일부터 금요일 사이 1박 배송을 위해 픽업을 요청하는 경우 이용가능한 서비스로, 소매업체는 FedEx Express 익일 지역 배송을 통해 저녁에 접수된 주문을 시간 내에 배송할 수 있습니다.
이용 가능한 서비스에 관해 더 자세한 내용을 알아보려면 fedex.com을 방문하시기 바랍니다.
픽업 요청 API 이용 방법
다음은 픽업 요청 API 픽업에서 이용 가능한 옵션입니다.
픽업 가능 여부 확인
이 엔드포인트를 사용해 이용 가능한 픽업 일정의 세부정보를 요청하십시오.
이 요청과 관련된 주요 입력 정보는 다음과 같습니다.
- 픽업 주소/우편번호
- 픽업 요청 유형(예: 당일/이후 날짜)
- 픽업 담당 FedEx 운송업체(예: Express/Ground)
- 국내/국제 픽업 여부
이 요청에 대한 응답에 성공하면 픽업 마감 시간, 픽업 날짜, 픽업 이용 가능 시간, 기본 준비 시간, 기타 픽업 가능 일정 세부정보 등 이용 가능한 픽업 일정 세부정보가 반환됩니다. 요청이 실패하는 경우에는 오류 메시지와 설명이 반환됩니다.
픽업 생성
이 엔드포인트를 사용해 픽업할 패키지에 대한 픽업 요쳥을 생성합니다.
이 요청과 관련된 주요 입력 정보는 다음과 같습니다.
- 픽업에 대한 비용이 청구될 FedEx 고객번호
- 발송지 세부 정보(주소, 위치, 고객번호 주소/발송인 주소/기타 등 픽업 주소의 유형)
- 픽업 담당 FedEx 운송업체(Express/Ground)
- 관련 고객번호에 해당하는 세부 주소
픽업 요청이 성공하면 예약된 픽업의 픽업 확인 번호, 픽업 알림 및 위치 코드가 반환됩니다. 요청 실패가 있을 경우에는 오류 메시지와 설명이 반환됩니다.
픽업 취소
픽업 취소 요청을 통해 기존에 예약된 패키지 픽업 요청을 취소할 수 있습니다.
이 요청과 관련된 주요 입력 정보는 다음과 같습니다.
- 픽업 확인 코드(픽업 요청 제출 시에 제공)
- 픽업 예정이었던 FedEx 운송업체(Express/Ground)
- 예약 날짜(픽업을 위한 인원 파견 날짜)
- 위치(해당 픽업 요청 처리를 담당하는 FedEx Express 사무소 위치)
픽업 취소에 성공하면 확인 번호와 함께 픽업 취소 확인 메시지가 반환됩니다. 요청 실패가 있을 경우에는 오류 메시지와 설명이 반환됩니다.
참고: 예약된 픽업을 취소하려면 픽업 확인 번호와 그에 해당하는 위치 코드(FDXE에만 해당)를 제출해야 합니다. 픽업 확인 번호와 그에 해당하는 위치 코드(FDXE에만 해당) 정보는 픽업 요청 제출 시에 제공됩니다. FedEx 배송직원이 픽업 위치로 출발한 후에 취소를 시도하면 실패 알림을 받게 됩니다.
비즈니스 규칙
- 다른 국가를 대상으로 픽업을 요청하려면 FedEx 서비스를 통해 발송물 픽업을 원하는 국가의 적절한 국가 코드를 포함한 국가 관련 속성을 제공해야 합니다.
- 디스패치 요청이 성공하면 FedEx가 디스패치 확인 번호를 제공합니다. 기존 요청의 용적 또는 중량 기준을 초과하는 패키지를 추가하지 않는 한 디스패치 요청은 1일 1회로 제한됩니다.
- 패키지 준비 시간과 영업 마감 시간 사이의 시간 간격을 부족하게 입력하는 경우 디스패치 요청에 실패할 수 있습니다. 픽업 시간 관련 문의는 해당 지역의 FedEx 지원 핫라인으로 연락주시기 바랍니다.
- 픽업 요청 API는 중량 단위로 '파운드(LB)' 및 'KG'를 지원합니다. 패키지 및 물품의 중량 단위가 일치하지 않는 경우 요청에 실패할 수 있습니다.
- FedEx Express(멕시코 내 발송)와 FedEx Ground 패키지 모두 픽업 예약이 필요한 경우에는 운송업체별로 하나씩 예약해야 합니다.
- 외곽 지역의 픽업 접수처를 이용하시는 경우 원격 픽업 예약을 위해서 사전에 패키지를 준비해주시기 바랍니다.
- 항상 패키지 픽업이 가능한 가장 늦은 시간을 선택해주시기 바랍니다(또는 회사의 업무 마감 시간).
- 토요일 픽업 서비스의 경우 FedEx Express 패키지를 대상으로 전 세계 일부 지역에서 제공됩니다. 토요일 방문 접수 서비스 또한 다수의 FedEx 접수처에서 이용할 수 있습니다. 접수처 서비스 엔드포인트를 사용하면 토요일 방문 접수 서비스를 이용할 수 있는 접수처 목록을 확인하실 수 있습니다.
- FedEx Ground 및 FedEx Express 픽업의 경우 FedEx 고객번호에 등록된 발송 접수처가 아닌 다른 대체 픽업 주소로 요청할 수도 있습니다.
- 정기 FedEx Express 또는 FedEx Ground 픽업 서비스를 원하시는 경우 FedEx 고객별 지원 담당자에게 문의하십시오.
- 다음의 경우에만 FedEx Express 또는 FedEx Ground 픽업을 취소할 수 있습니다.
- 요청 패키지가 픽업 준비를 마친 시간이 이미 지남
- 준비 시간이 지났는데도 배송직원이 디스패치되지 않음
JSON API 컬렉션
Response