[카카오 쇼핑] 배송/ 클레임 택배 조회 API 분리 안내 – Kakao Shopping Open API

안녕하세요. 카카오 쇼핑하기 담당자입니다.

배송/클레임 택배 조회 시 반송 방법별 API가 분리되어, 변경사항 공유드립니다.

1. 적용 일자

2026년 8월 18일 (화)

2. 변경사항

주문정보 조회, 주문정보 복수 조회 내 반송 택배사 번호 (returnDeliveryCompanyId) , 재배송 택배사 번호 (exchangeDeliveryCompanyId) 삭제
반송 방법이 자동 수거, 또는 편의점 택배의 경우, 전용 택배사 조회 API 호출을 해주셔야합니다

택배사 ID는 반송/재배송 상황에 따라 아래 API를 통해 조회하실 수 있습니다.
1) 재배송 택배사 번호 조회 :GET /v1/shopping/delivery/companies
2) 반송 택배사 번호 조회
  -. 반송방법이 자동 수거인 경우 : GET /v1/shopping/collect/companies/auto
  -. 반송방법이 편의점 택배인 경우 : GET /v1/shopping/collect/companies/cvs
  -. 그 외 반송방법인 경우 : GET /v1/shopping/delivery/companies

1) 대상 API

주문정보 조회 API : GET /v1/shopping/order?order_id={order_id}
주문정보 복수 조회 API: GET /v1/shopping/orders/bulk?order_ids={order_ids}
자동수거 전용 택배사 조회 API : GET /v1/shopping/collect/companies/auto
편의점 택배 전용 택배사 조회 API : GET /v1/shopping/collect/companies/cvs

<requestBody 예시\>

편의점 택배 전용 택배사 조회 API

[ { "id": 2001, "code": "CVS", "name": "BGF포스트" } ]

자동수거 택배 전용 택배사 조회 API

[ { "id": 1001, "code": "CJGLS", "name": "CJ대한통운" }, { "id": 1002, "code": "HYUNDAI", "name": "롯데택배(구. 현대택배)" }, { "id": 1003, "code": "EPOST", "name": "우체국택배" }, { "id": 1004, "code": "HANJIN", "name": "한진택배" }, { "id": 1005, "code": "KGB", "name": "로젠택배" }, { "id": 1006, "code": "ILYANG", "name": "일양로지스" }, { "id": 1007, "code": "PINGPONG", "name": "핑퐁" }, { "id": 1008, "code": "RETURNALL", "name": "리터놀" } ]

관련 문서