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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api-guide/store-front/order/undefined-9.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.