이 섹션의 문서

더보기

반품 요청

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

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

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

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

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

 

요청

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"  
}

 

응답

<응답 바디>

필드명 타입 설명
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"
}

관련 문서