주문 반품처리

주문 반품처리 API는 반품 관련 클레임 대상을 조회하고, BO의 요청에 해당하는 클레임을 처리합니다. 이 API를 통해 접수된 반품 목록을 제공하며, 반품 처리에 필요한 정보를 화면에 제공합니다.

주요 기능

반품 접수
- 상품의 반품을 고객이 신청하는 기능.
- 주문 진행 상태(출고완료, 배송완료)에 따라 가능 여부 확인.
- 반품 수량, 사유, 수거지 옵션 선택 가능.
- 추가 결제 및 환불 정보 자동 계산.
- 무료 반품 쿠폰 사용 가능.
반품 취소
- 반품 접수 상태에서 전체 취소 기능 제공.
- 결제한 금액 환불 및 무료 반품 쿠폰 복원.
반품 완료
- 반품 접수 완료 상태에서 반품 처리 기능.
- 주문 시 사용된 쿠폰 복원 및 상품 재고 원복.
- 임직원 주문의 경우 할인 한도 금액 업데이트.
반품 불가
- 불량반품(20) 확인 후 반품 불가 처리.
- 반품 불가 사유 수기 입력.
반품 보류
- 귀책으로 인한 반품 보류 처리 가능.
- 추가 결제 시 무료 반품 쿠폰 사용 가능.
반품 전환
- 교환 상품 회수 후 반품 전환 가능.
- 교환 접수 철회되며 결제 금액 환불.

프로세스 정의_반품 접수 및 목록 조회

	구분	설명

	구분	설명
1	반품주문조회	선택 및 입력된 검색 조건에 부합하는 반품 접수 내역을 조회합니다.
2	반품접수 처리대상조회	주문한 상품 중 반품이 가능한 상품 목록을 조회하여 반품 접수 팝업에 노출합니다.
3	클레임 비용 계산 조회	관리자가 선택한 회수지, 반품 사유에 따른 추가 결제 금액, 반품 완료 후 환불 금액 및 수단 정보를 조회합니다.
4	배송 번호 채번 처리	반품 접수 시 사용될 회수지의 신규 배송번호를 발급합니다.
5	반품 접수	선택된 상품의 반품 접수를 진행합니다.

프로세스 정의_ 반품 철회

	구분	설명

	구분	설명
1	반품 철회대상 조회	철회 가능한 반품 접수 건을 모두 조회합니다.
2	클레임 비용 계산 조회	반품 철회 시 환불 금액과 수단 정보를 조회합니다.
3	반품 철회	선택된 반품 접수 건을 철회합니다.

프로세스 정의_반품 완료

	구분	설명

	구분	설명
1	반품완료 처리대상 조회	반품 접수 건 중 반품 완료 처리가 가능한 대상을 조회합니다.
2	클레임 상세 내역 조회	반품 접수 처리 내역을 조회합니다.
3	반품완료	선택된 반품 접수 건을 완료 처리 합니다.

프로세스 정의_반품 불가

	구분	설명

	구분	설명
1	반품완료 처리대상 조회	반품 접수 건 중 반품 완료 처리가 가능한 대상을 조회합니다.
2	클레임 상세 내역 조회	반품 접수 처리 내역을 조회합니다.
3	반품완료	선택된 반품 접수 건을 완료 처리 합니다.

프로세스 정의_반품 전환

	구분	설명

	구분	설명
1	반품완료 처리대상 조회	반품 접수 건 중 반품 완료 처리가 가능한 대상을 조회합니다.
2	클레임 상세 내역 조회	반품 접수 처리 내역을 조회합니다.
3	반품완료	선택된 반품 접수 건을 완료 처리 합니다.

프로세스 정의_반품 보류

	구분	설명

	구분	설명
1	반품보류 처리대상조회	반품 접수 건 중 반품 보류 처리가 가능한 대상을 조회합니다.
2	클레임 비용 계산 조회	반품 보류 시 추가 결제 금액 및 환불 예정 금액, 환불 수단 정보를 조회합니다.
3	반품보류	선택된 반품 접수 건을 보류 처리합니다.

API 기능 목록

API	설명	Server	메소드	비고

API	설명	Server	메소드	비고
반품접수 처리대상조회	주문한 상품 중 반품이 가능한 대상을 모두 조회합니다. 반품 접수 진행 시 필요한 주문정보 및 공통코드를 조회합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 반품접수 대상 조회(BO) API 호출 (/api/order/v1/claim/return/returnTargetInfo)
반품완료 처리대상조회	반품 접수된 주문 상품 중 반품 완료 처리가 가능한 대상을 모두 조회합니다. 반품 완료 진행 시 필요한 주문정보를 조회합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 반품접수 대상 조회(BO) API 호출 (/api/order/v1/claim/return/returnTargetInfo)
반품불가 대상 조회	반품 접수된 주문 상품 중 반품 불가 처리가 가능한 대상을 모두 조회합니다. 반품 불가 진행 시 필요한 주문정보를 조회합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 반품접수 대상 조회(BO) API 호출 (/api/order/v1/claim/return/returnTargetInfo)
반품전환 처리대상조회	교환 접수된 주문 상품 중 반품 전환 처리가 가능한 대상을 모두 조회합니다. 반품 전환 진행 시 필요한 주문정보를 조회합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 반품접수 대상 조회(BO) API 호출 (/api/order/v1/claim/return/returnTargetInfo)
반품보류 처리대상조회	반품 접수된 주문 상품 중 반품 보류 처리가 가능한 대상을 모두 조회합니다. 반품 보류 진행 시 필요한 주문정보를 조회합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 반품접수 대상 조회(BO) API 호출 (/api/order/v1/claim/return/returnTargetInfo)
반품접수	선택된 상품의 반품접수를 진행합니다. 관리자가 지정한 상품 / 수량 / 회수지 / 반품 사유 / 쿠폰 사용 유무에 따라 비용 및 혜택을 재계산 하고 검증합니다. 반품 과정에서 추가로 발생한 금액이 있는 경우 결제대기 상태로 전환되며, 추후 고객에게 배송비 결제를 요청합니다. 무료 반품 쿠폰 사용시, 회수배송비는 제외되고, 쿠폰은 사용처리 됩니다. 반품 접수 완료 후 고객에게 배송비 결제 안내 알림을 발송합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 반품접수(BO) API 호출 (/api/order/v1/claim/return/acceptReturn)
반품철회	반품 접수 건을 철회합니다. 반품접수시 결제한 비용을 환불합니다. 반품접수시 사용된 무료 반품쿠폰을 복원합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 반품철회(BO) API 호출 (/api/order/v1/claim/return/withdrawalReturn)
반품불가	반품 접수 건을 철회하고, 재 반품이 불가하도록 상태를 변경합니다. 반품 접수 시 결제한 비용을 환불합니다. 반품 접수 시 사용된 무료 반품쿠폰을 복원합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 반품불가(BO) API 호출 (/api/order/v1/claim/return/rejectReturn)
반품완료	회수 완료된 반품 접수 건을 완료 처리합니다. 주문 시 사용한 쿠폰 및 재고를 복원하고, 주문 금액을 환불합니다. 반품 완료 후 고객에게 알림을 발송합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 반품완료(BO) API 호출 (/api/order/v1/claim/return/completeReturn)
반품전환	교환 과정에서 회수된 상품을 당사 귀책으로 반품 접수합니다. 진행중인 교환은 철회하고, 교환 접수 시 발생한 금액에 대해 환불을 진행합니다. 교환 접수 시 차감된 재고를 복원합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 교환중 반품(BO) API 호출 (/api/order/v1/claim/return/transformReturn)
반품보류	당사 귀책으로 접수된 반품 상품이 회수 확인 과정에서 고객 귀책으로 판단된 경우, 귀책 사유에 의해 미 청구된 비용을 재계산하고, 접수 정보를 수정합니다. 재 계산 결과 추가 비용이 발생한 경우, 고객에게 배송비 결제를 요청합니다. 추가 비용 결제 없이 반품 진행이 가능한 경우, 회수완료 처리 합니다.	API-BO	POST	🔗API 확인하기 > 주문(Order) 반품보류(BO) API 호출 (/api/order/v1/claim/return/returnPending)
반품주문조회	조건에 부합하는 반품 접수 내역을 조회합니다.	API-BO	POST	🔗API 확인하기 >
클레임 비용 계산 조회	클레임 업무 별 부가비용, 혜택정보, 추가 결제/환불 예정 금액 및 쿠폰 사용/복원 정보를 제공합니다.	API-BO	POST	클레임 공통 API
배송 번호 채번 처리	클레임 업무 처리 시 필요한 신규 배송번호를 채번합니다.	API-BO	POST	클레임 공통 API
클레임 상세 내역 조회	클레임 상세 내역을 조회합니다. 주문 정보, 클레임 대상 정보, 환불/결제 내용, 복원예정 쿠폰, 배송지 정보를 제공합니다.	API-BO	POST	클레임 공통 API
반품/교환 철회대상 조회	반품, 교환 접수 건 중 철회가 가능한 대상을 조회합니다.	API-BO	POST	주문 교환

기타 참고사항

동일 배송그룹에 한해 반품 접수가 가능합니다.
반품 접수 및 취소 시 처리 가능 주문내역상태와 주문내역구분 값을 확인합니다. 해당 정보는 공통코드로 관리됩니다.
→ ST007(FO시스템 클레임처리 가능상태) 참조 1값 = 주문내역상태코드
→ ST007(FO시스템 클레임처리 가능상태) 참조 2값 = 주문내역구분코드
반품 대상 조회 시 상품 속성인 “반품가능여부”값을 확인합니다.
반품 사유의 경우 공통코드로 관리되며, 사유 별 귀책 구분, 대상 주문 내역 구분 등의 정보를 포함하고 있습니다.
사은품이 있는 상품의 경우, 부분 수량 반품이 불가합니다.
주문 시 부분취소불가 결제수단을 사용한 경우, 전체 주문 반품만 가능합니다.
동일 배송그룹 내에 이미 초도 배송비가 발생한 반품 신청 이력이 있고, 해당 반품 건이 취소 가능 상태인 경우 추가 반품접수가 불가합니다.
초도 배송비가 발생한 반품 접수 시, 동일 배송그룹내의 취소가 가능한 반품 이력이 있는 경우 추가 반품접수가 불가합니다.
반품 접수 시 추가 결제금액이 발생한 경우, 결제 금액이 환불 예정금액보다 큰 경우에만 결제대기상태로 전환되며 그 외에는 환불 금액에서 차감됩니다.
회수지시 상태의 반품 접수건의 취소 진행 시 배송지시취소수량을 업데이트 합니다.
반품불가와 반품보류의 수기 입력 사유 정보는 주문배송정보의 회수완료 대기처리사유로 저장됩니다.
반품 목록 조회 시 파트너 접속 관리자의 경우, 해당 협력사의 접수 내역만 노출됩니다.