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

배송/클레임 택배사 일부 코드 분리를 진행하게 되어, 교환/반품 반송 방법이 자동수거/ 편의점 반품의 경우 택배사 조회 API가 신규로 생성되어 변경 사항 공유드립니다.

ㄴ 교환 재배송, 반품 고객반송예정(later),고객 반송완료(manual),판매자 직접회수(seller) 기존 배송 택배사로 조회 가능

■ 적용 일자

2026년 8월 10일 (목)

■ 변경사항

주문정보 조회, 주문정보 복수 조회 내 반송 택배사 번호 (returnDeliveryCompanyId) , 재배송 택배사 번호 (exchangeDeliveryCompanyId) 삭제

반송 방법이 자동 수거, 또는 편의점 택배의 경우, 전용 택배사 조회 API 호출을 해주셔야합니다

택배사 ID는 반송/재배송 상황에 따라 아래 API를 통해 조회하실 수 있습니다.재배송 택배사 번호 조회 :GET /v1/shopping/delivery/companies 반송 택배사 번호 조회 반송방법이 자동 수거인 경우 - 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": "리터놀" } ]