이 섹션의 문서

더보기

반품 요청

배송완료 된 배송상품 주문을 반품요청 합니다.

주문 상태(OrderStatus)가 ShippingProgress(배송중), ShippingComplete(배송완료), ExchangeShippingComplete(교환완료)인 경우 처리 가능합니다.

배송방법은 SHIPPING(택배)만 제공되며, 수거타입(CollectType)은 선택 가능 합니다.

  • 반품상품 자동수거 서비스 가입 판매자는 CollectType(수거타입) > AUTO(자동회수)로 선택
  • 택배 외 배송방법 이용 판매자는 CollectType(수거타입) > LATER(반송예정)로 선택
  • CollectType(수거타입) > MANUAL(반송완료)’으로 요청시 ‘deliveryCompanyCode(수거택배사), invoiceNumber(수거 송장번호)’ 정보 필수

반품배송비 지불방법은 Deducted (환불금에서 차감), AddAmount (상품 반송시 동봉), DirectAmount (판매자에게 직접 송금) 선택 가능하며, 반품 사유가 구매자 귀책일 경우에만 입력해주시면 됩니다. 

 

선물하기 선물구매의 경우, 클레임 요청고객을 선택해야 합니다. 

  • 수신자가 반품요청한 경우, claimRequestUser(클레임 요청고객) > RECEIVER(수신자)로 입력
  • 구매자가 반품요청한 경우, claimRequestUser(클레임 요청고객) > BUYER(구매자) 로 입력

선물하기 자기구매 또는 톡딜의 경우 , 클레임 요청고객을 BUYER(구매자) 로 입력합니다. 

  • claimRequestUser(클레임 요청고객) > BUYER(구매자) 로 입력

 

요청

POST /v1/shopping/claims/return/request HTTP/1.1
channel-ids: 101
Content-type: application/json

$RequestBody

 

RequestBody
ReturnClaimRequest json object.

 

예시. 반송완료

{
  "collectType": "MANUAL",
  "deliveryCompanyCode": "CJGLS",
  "invoiceNumber": "0123456789",
  "orderIds": [123400000],
  "reasonCode": "CANCELED_BY_BUYER_CHANGE_OF_MIND",
  "reasonComment": "변심으로 인해 반품요청합니다.",
  "claimShippingFeeMethod": "Deducted"  
}

예시. 자동회수

{
  "collectType": "AUTO",
  "orderIds": [123400000,123400001],
  "reasonCode": "CANCELED_BY_BUYER_CHANGE_OF_MIND",
  "reasonComment": "변심으로 인해 반품요청합니다.",
  "claimShippingFeeMethod": "AddAmount"  
}

예시. 반송예정

{
  "collectType": "LATER",
  "orderIds": [123400000,123400001],
  "reasonCode": "CANCELED_BY_BUYER_CHANGE_OF_MIND",
  "reasonComment": "변심으로 인해 반품요청합니다.",
  "claimShippingFeeMethod": "Deducted"  
}

 

예시. 클레임 요청고객이 "수신자"인 경우

{
  "collectType": "AUTO",
  "orderIds": [123400000,123400001],
  "reasonCode": "CANCELED_BY_BUYER_CHANGE_OF_MIND",
  "reasonComment": "변심으로 인해 반품요청합니다.",
  "claimShippingFeeMethod": "AddAmount",
  "claimRequestUser": "RECEIVER"
}

 

예시. 클레임 요청고객이 "구매자"인 경우

{
  "collectType": "AUTO",
  "orderIds": [123400000,123400001],
  "reasonCode": "CANCELED_BY_BUYER_CHANGE_OF_MIND",
  "reasonComment": "변심으로 인해 반품요청합니다.",
  "claimShippingFeeMethod": "AddAmount", 
  "claimRequestUser": "BUYER"
}

 

응답

<응답 바디>

필드명 타입 설명
claimId Long 클레임아이디클레임아이디
orderIds Array 주문번호

<응답 바디 샘플>

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "claimId": 38718,
  "orderIds": [
    1234567890
  ]
}

 

응답 실패 예시

장바구니 쿠폰과 추가 배송비로 인한 환불예정금액 마이너스 CASE

HTTP/1.1 400
{
  "error_message": "쿠폰 금액 및 추가/반품 배송비가 환불금액보다 크므로 반품요청 처리가 불가합니다. 지불방식 변 경후다시시도해주세요.",
  "error_code": -22028,
  "error_category": "oms_open_api"
}

 

장바구니 쿠폰으로 인한 환불예정금액 마이너스 CASE

HTTP/1.1 400
{
  "error_message": "쿠폰 조건이 충족되지 않아 일부만 반품요청 하실 수 없습니다. 모든 주문을 한 번에 반품요청하시 거나, 카카오고객센터에 문의해주세요",
  "error_code": -22029,
  "error_category": "oms_open_api"
}

 

추가 배송비로 인한 로 인한 환불예정금액 마이너스 CASE

HTTP/1.1 400
{
  "error_message": "추가/반품 배송비가 환불금액보다 크므로 반품요청 처리가 불가합니다. 지불방식 변경 후 다시 시 도해 주세요",
  "error_code": -22030,
  "error_category": "oms_open_api"
}

관련 문서