교환 처리

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

처리가능 상태 설명

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

항목	설명
reject	교환 거부
accept	수거지시
collect_done	교환수거 완료
withhold	교환보류
releasehold	교환 보류 해제
resend	교환 재발송
exchange_done	교환완료 처리

요청 데이터

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

응답 데이터

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

OrderExchangeReject Data

항목	타입	설명
parcel_code	String	택배사 코드 사용가능한 택배사 목록 보기
invoice_no	String	운송장번호

OrderExchangeAccept Data

항목	타입	설명
etc_price	Float	기타 청구 비용

OrderExchangeWithHold Data

항목	타입	설명
reason_code	String	보류 사유 코드 EXCHANGE_DELIVERYFEE: 교환 배송비 청구 EXCHANGE_EXTRAFEE: 기타 교환 비용청구 EXCHANGE_PRODUCT_READY: 교환 상품 준비 중 EXCHANGE_PRODUCT_NOT_DELIVERED: 교환 상품 미입고 EXCHANGE_HOLDBACK: 교환 구매 확정 보류 ETC: 기타 사유
reason_detail	String	보류 상세사유
etc_price	Float	기타 비용 보류 사유가 EXCHANGE_EXTRAFEE 일 때만 입력해주세요.

etc_price 입력 예시

$etc = [
	'etc_price' => [
		'품목주문서번호' => 1000
	]
];

OrderActionFailedList Data

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

OrderActionFailedProdOrderList Data

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

OrderExchangeReSend Data

항목	타입	설명
method	String	재배송방법 DELIVERY: 택배,등기,소포 VISIT_RECEIPT: 방문수령 DIRECT_DELIVERY: 직접 전달 QUICK_SVC: 퀵서비스 NOTHING: 배송없음
parcel_code	String	택배사 코드 재배송방법이 택배,등기,소포 일 때만 입력해주세요. 사용가능한 택배사 목록 보기
invoice_no	String	운송장 번호 재배송방법이 택배,등기,소포 일 때만 입력해주세요.