반품 처리

PATCH https://api.imweb.me/v2/shop/orders/{주문번호}/return/{상태}

처리가능 상태 설명

주문관리 v2는 반품처리를 지원하지 않습니다.

항목	설명
reject	반품 거부 반품요청 주문에 대해 반품 거부하거나 교환으로 변경합니다.
accept	수거지시 운송업체에게 반품상품 수거를 지시(요청)한 경우 처리해주세요.
collect_done	반품수거 완료 수거중인 상품을 수거완료 처리합니다.
withhold	반품보류 구매자에게 반품 배송비 또는 기타 반품 추가 비용을 청구해야 하거나 반품이 불가할 때 사용합니다.(네이버페이 용)
releasehold	반품 보류 해제 반품 보류 사유가 해결되어 반품 진행이 계속 가능할 때 사용합니다.(네이버페이 용)
return_done	반품완료 처리 수거가 확인된 반품 상품의 환불 처리를 진행하며 구매자에게 추가 비용 청구를 할 수 있습니다. 주의: 자동환불이 불가능한 주문건은 '자동환불불가' 오류가 발생합니다.
return_force_done	강제 반품완료 처리 환불처리실패 또는 환불진행중인 주문을 반품완료 처리합니다. 강제 반품 완료 처리는 자동환불이 지원되지 않으므로 구매자와 협의된 방법으로 환불을 별도 진행해 주셔야 합니다.

요청 데이터

항목	타입	설명
prod_order_no	String	개별/부분 처리 시 사용(선택)
etc	Array	상태별 필수 데이터 reject: OrderReturnRejectData return_done: OrderReturnReturnDoneData 처리 상태에 맞는 추가 데이터를 전달해주세요.

응답 데이터

항목	타입	설명
success	Array	처리 성공한 주문서 번호
failed	Array	처리 실패한 주문서 목록 OrderActionFailedList

OrderReturnReject Data

항목	타입	설명
reason	String	거부사유

OrderReturnReturnDone Data

항목	타입	설명
etc_price	Array	기타 청구비용 목록 주의: 미입력 시 기타 비용 처리가 이루어지지 않습니다. EtcPriceData
refund_point	Array	환불 적립금 전체 반품인 경우 사용한 적립금 전액이 자동 반영됩니다. 부분반품은 환불하실 적립금을 직접 입력하실 수 있습니다. 예: 3000 포인트를 환불하고 싶을 때-> 3000 입력 (단, 해당 주문의 잔여 적립금보다 초과하여 입력 불가) 주의: 미입력 시 적립금 환불 처리가 이루어지지 않습니다. RefundPointData
claim_memo	String	구매자에게 전하실 말씀

EtcPrice Data

항목	타입	설명
prod_order_no	String	품목주문번호
price	Float	기타 청구 비용

RefundPoint Data

항목	타입	설명
prod_order_no	String	품목주문번호
point	Float	환불 적립금

OrderActionFailedList Data

항목	타입	설명
order_no	String	주문번호
prod_order_list	Array	처리 실패한 품목 주문서 목록OrderActionFailedProdOrderListData

OrderActionFailedProdOrderList Data

항목	타입	설명
prod_order_no	String	품목주문번호
msg	String	실패 메세지
detail_msg	String	실패 상세메세지