[Open API] 청약철회 제한(반품불가) 카테고리 '고객 취소 요청 거절' 기능 및 API 사양 변경 안내

[Open API] 청약철회 제한(반품불가) 카테고리 '고객 취소 요청 거절' 기능 및 API 사양 변경 안내
안녕하세요, Coupang Open API입니다.
마이쿠팡 앱 내 청약철회 제한(반품불가) 카테고리의 '고객 주문취소 요청' 기능 도입에 따라, Open API를 통한 '고객 취소 요청 거절 (Reject customer cancellation request)' 처리 방식 및 API 사양이 아래와 같이 변경됩니다.

1. 적용 대상 카테고리 및 조건 (Target Category Details)
본 API 사양 변경은 아래 청약철회 제한(반품불가) 카테고리 ID 및 배송/상품 조건 필터에 해당하는 주문 건에 적용됩니다.
카테고리 식별자 (Category Identifier):
kan_category_id: 5128, 9733
kancategoryname: 순금/기타순금
배송 및 상품 조건 필터 (Shipping Method / Category Filter):
신선/냉동 (Fresh/Frozen): COLD_FRESH
판매자 직접배송 (Direct Shipping): VENDOR_DIRECT
주문제작 (Custom-made): MAKE_ORDER

2. 주요 변경 사항 및 처리 옵션
출고중지(Cancel Stage B) 상태의 반품불가 주문에 대해 고객의 취소 요청을 거절할 경우, 기존 '이미출고 (Already Released)' 처리 외에도 신규 옵션인 '상품 준비 중 (Items in Preparation)' 사유를 포함하여 '고객 취소 요청 거절 (Reject customer cancellation request)'을 수행할 수 있게 됩니다.
반품 가능 일반 주문:
기존과 동일하게 동작합니다. (송장 정보 입력 시 이미출고/반품 처리)
청약철회 제한(반품불가) 주문:
동일 API 호출 시 단순 반품 접수가 아닌 '고객 취소 요청 거절'로 처리됩니다.
이미출고뿐만 아니라, 원자재 가공/맞춤 제작/신선식품 포장 등이 시작되어 아직 송장이 발급되지 않은 상품 준비 중 상태에서도 취소 요청을 거절할 수 있도록 deliveryCompanyCode 및 invoiceNumber 항목이 비필수(Optional)로 전환됩니다.

3. API 사양 및 Request Spec 변경
[적용 API]
PATCH /v4/vendors/{vendorId}/returnRequests/{receiptId}/completedShipment (이미출고 및 취소거절 처리)
[변경되지 않는 API]
PUT/PATCH .../stoppedShipment (출고중지 확정/취소 승인)
기타 주문 취소 관련 API 엔드포인트
[Request Spec 상세]
vendorId, receiptId: 필수 (기존과 동일)
deliveryCompanyCode, invoiceNumber: 필수 → 비필수 (Optional)
참고: 이미 발급된 송장이 있는 경우 기존과 동일하게 송장 정보를 입력하여 호출하실 수 있습니다.

4. 셀러 및 ERP 개발사 영향 및 유의사항
반품 가능 카테고리만 연동/사용하는 경우: 별도의 API 코드 수정이 필요하지 않습니다.
반품불가 상품에 본 API를 호출 중인 경우:
기존에는 호출 시 즉시 반품 접수 상태로 전환되었으나, 변경 후에는 '고객 취소 요청 거절'로 처리됩니다.
거절 처리된 주문은 취소되지 않으며 정상 배송을 완료해야 하므로, 후속 프로세스를 '반품 접수' 전제로 구현해 두신 ERP 시스템은 수정이 필요합니다.
신규 엔드포인트 연동 여부: 별도의 신규 API URL은 없으며, 기존 엔드포인트를 그대로 사용하시면 됩니다.

5. 적용 일정
적용 예정일: 2026년 10월 6일 (2026-10-06) (A/B 테스트 및 램프업 후 전면 적용)
개발자 문서: Coupang Open API Developer Portal
감사합니다.