> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/store-front/order/undefined-9.md).

# 주문 변경

고객이 주문한 상품의 배송지 및 옵션을 변경할 수 있는 기능을 제공합니다. 배송지 변경은 주문 상세 화면에서만 가능하며, 옵션 변경은 주문 목록 및 주문 상세 화면에서 가능합니다. 이때 주문내역구분코드(OM003)가 주문완료(11) 상태일 경우에만 변경이 가능하며, 배송지 변경은 도서산간 지역과 일반 지역 간의 변경만 가능합니다.

***

## 주요 기능

* **배송지 변경**
  * 주문 상세 화면에서 주문완료(11) 상태일 경우에 배송지 변경이 가능합니다.
  * 해당하는 주문번호의 모든 배송 순번을 업데이트합니다.
  * 도서산간 지역과 일반 지역 간의 배송지 변경만 가능합니다.
* **옵션 변경**
  * 주문 목록 및 주문 상세 화면에서 주문완료(11) 상태일 경우에 옵션 변경이 가능합니다.
  * 단건의 옵션 변경만 가능하며, 동일 금액의 판매 중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.
  * 동일 단품 및 예약 상품의 단품은 변경 불가능합니다.

## 프로세스 정의

<figure><img src="/files/OZiFOt5DVAO8MAZGnCpA" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 주문내역 상세조회

비회원인 경우, 비회원 로그인을 통해 회원인 경우 마이페이지 > 주문내역 조회 > 주문내역 상세를 통해 상세 내역을 조회합니다.
{% endstep %}

{% step %}

### 옵션 변경

옵션 변경 버튼을 클릭 후 변경 가능한 단품 정보를 넘겨 받아 옵션을 변경 할 수 있습니다.\
변경 완료 클릭 시 옵션 변경 유효성 검사를 끝낸 후 유효성 검증 성공시 주문 DB 에 저장합니다.
{% endstep %}

{% step %}

### 배송지 변경

배송지 변경 클릭 시 배송지 목록 팝업이 뜨며, 선택 시 배송지 변경이 가능합니다.\
비회원의 경우 배송지 입력 팝업이 뜨고, 선택완료 클릭 시 배송지 변경 유효성 검사를 끝낸 후 유효성 검증 성공 시 주문 DB에 저장합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="117.77783203125">API</th><th width="301.2222900390625">설명</th><th width="93.5555419921875">Server</th><th width="91.3333740234375">메소드</th><th>비</th></tr></thead><tbody><tr><td>주문 배송지 수정 (FO)</td><td>주문 배송지를 변경합니다.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B3%80%EA%B2%BD&#x26;path=ordDlvChangeFO">🔗API 확인하기></a></td></tr><tr><td>옵션 상품 옵션 변경 (FO)</td><td>단건의 주문 옵션을 변경 가능합니다. 동일 금액의 판매중인 상태의 재고가 있는 단품으로 변경 가능합니다.</td><td>Order</td><td>POST</td><td><p><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B3%80%EA%B2%BD&#x26;path=ordChangeFO">🔗API 확인하기></a></p><p>상품별 변경 가능한 단품 정보 조회 API</p><p><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8&#x26;path=getOrderItmInfos">🔗API 확인하기></a></p><p>단품별 재고 증차감 API</p><p><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8&#x26;path=setStockUpdate">🔗API 확인하기></a></p></td></tr></tbody></table>

## 기타 참고사항

* 옵션 변경 버튼 노출은 공통코드로 관리합니다. \
  ST007(FO 시스템 클레임처리 가능상태) cd 91번(옵션변경) 참조 1값(주문내역상태코드 : OM005), 참조2값(주문내역구분코드 : OM003)
* 배송지 변경 버튼 노출은 공통코드로 관리합니다. \
  ST007(FO 시스템 클레임처리 가능상태) cd 92번(배송지변경) 참조 1값(주문내역상태코드 : OM005), 참조2값(주문내역구분코드 : OM003)\
  Ex) 배송지 변경 버튼 노출의 경우 참조1값이 12,21(OM005 : 주문완료(12), 배송지시(21)) , 참조2값이 10(OM003 : 주문완료) 인 경우만 가능합니다.
* 상태에 따른 버튼 노출 기준표

<figure><img src="/files/wKzMvRZxKX67ZLUeBjiQ" alt=""><figcaption></figcaption></figure>
