> 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/api-guides-en/back-office/order-bo/undefined-2.md).

# 정기주문 신청관리

선택한 정기주문의 상태를 해지로 변경하고, 상품의 변경 사항 및 주기를 관리하는 기능입니다.

***

## 주요 기능

* **정기주문 조회**
  * 신청 상태, 조회 기간, 회원 번호, 정기주문 번호 등의 조건으로 정기주문 신청 목록을 조회합니다.
* **상세 정보 조회**
  * 선택한 정기주문의 상세 정보와 주문 내역을 조회합니다.
* **상태 변경 및 상품 관리**
  * 선택한 정기주문의 상태를 해지로 변경할 수 있습니다.
  * 건너뛰기 여부 변경 시, 모든 상품에 대해 건너뛰기 여부가 Y인 경우 다음 주문 예정일이 업데이트되고, 건너뛰기 여부는 N으로 변경됩니다.
  * 상품의 변경 사항(건너뛰기 여부, 단품 변경, 수량 변경, 상품 추가)을 저장합니다.
* **상품 삭제 및 주기 변경**
  * 상품을 삭제하거나 정기주문의 주기를 변경할 수 있습니다.

## 프로세스 정의

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

{% stepper %}
{% step %}

### 정기주문 신청 목록 조회

정기주문신청 목록을 조회합니다.
{% endstep %}

{% step %}

### 정기주문 신청 상세 조회

정기주문번호에 해당하는 정기주문 신청 상세 정보를 조회합니다.
{% endstep %}

{% step %}

### 정기주문 주문 목록 조회

정기주문번호에 해당하는 정기주문 주문 목록을 조회합니다.
{% endstep %}

{% step %}

### 정기주문 상품의 변경 가능한 단품 목록 조회

신청한 정기주문 상품의 변경 가능한 단품 목록을 조회합니다.
{% endstep %}

{% step %}

### 정기주문 해지하기

정기주문번호에 해당하는 정기주문신청을 해지 상태로 변경합니다.
{% endstep %}

{% step %}

### 정기주문 변경 사항 저장

정기주문의 상품추가, 단품변경, 수량변경, 건너뛰기 여부를 저장합니다.
{% endstep %}

{% step %}

### 정기주문 상품 삭제

선택한 정기주문의 상품을 삭제합니다.
{% endstep %}

{% step %}

### 정기주문 추가 상품 단품 조회

추가한 상품에 대한 단품 정보를 조회합니다.
{% endstep %}

{% step %}

### 정기주문 변경 이력 목록 조회

정기주문 변경 이력 목록을 조회합니다.
{% endstep %}

{% step %}

### 정기주문 주기변경 전 유효성 검증

주기변경 전 유효성 검증을 합니다.
{% endstep %}

{% step %}

### 정기주문 주기변경

정기주문의 주기를 변경합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="109">API</th><th width="341.22216796875">설명</th><th width="92.4443359375">Server</th><th width="93.5555419921875">메소드</th><th>비고</th></tr></thead><tbody><tr><td>정기주문 해지하기</td><td>선택한 정기주문을 해지합니다.</td><td>BO</td><td>PUT</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=terminateRegularOrder">🔗API 확인하기 ></a></td></tr><tr><td>정기주문 변경 사항 저장</td><td>선택한 정기주문 상품의 변경 사항(건너뛰기 여부, 단품변경, 수량변경, 상품추가)을 저장합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=saveRegularOrder">🔗API 확인하기 ></a></td></tr><tr><td>정기주문 주기변경 전 유효성 검증</td><td>정기주문 주기 변경 전 유효성 검증 합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=isPossibleChangeRegularOrderDeliTerm">🔗API 확인하기 ></a></td></tr><tr><td>정기주문 건너뛰기 다음 주문예정일 변경 여부</td><td>건너뛰기 요청 시, 해당 정기주문의 다음주문예정일이 변경 될 예정인지 그 여부 값(true/false) 을 내립니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=isNextOrderDateWillBeChangedBO">🔗API 확인하기 ></a></td></tr><tr><td>추가한 상품의 단품 정보 조회</td><td>추가한 상품에 대한 단품 정보를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=getItmInfo">🔗API 확인하기 ></a></td></tr><tr><td>정기주문 상품 삭제</td><td>선택한 정기주문 상품을 삭제합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=deleteRegularOrderGoods">🔗API 확인하기 ></a></td></tr><tr><td>정기주문 주기 변경</td><td>선택한 정기주문의 주기를 변경합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=changeDeliTermRegularOrder">🔗API 확인하기 ></a></td></tr><tr><td>정기주문 변경이력 목록 조회</td><td>정기주문신청 변경이력 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=getRegularOrderApplicationHistoryList">🔗API 확인하기 ></a></td></tr><tr><td>정기주문 신청 목록 조회</td><td>정기주문 신청 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=getRegularOrderApplicationList">🔗API 확인하기 ></a></td></tr><tr><td>정기주문 주문 내역 조회</td><td>정기주문의 주문 내역을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=getRegularOrderApplicationList">🔗API 확인하기 ></a></td></tr><tr><td>정기주문 신청 상세 조회</td><td>정기주문 신청 상세 내역을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=getRegularOrderApplicationDetail">🔗API 확인하기 ></a></td></tr><tr><td>정기주문 상품의 변경 가능한 단품 목록 조회</td><td>정기주문 상품의 변경 가능한 단품 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=order&#x26;depth=%EC%A0%95%EA%B8%B0%EC%A3%BC%EB%AC%B8%20%EC%8B%A0%EC%B2%AD%20%EA%B4%80%EB%A6%AC&#x26;path=getGoodsItmInfoList">🔗API 확인하기 ></a></td></tr></tbody></table>

## 기타 참고 사항

* 정기주문 신청의 상태 값은 OM009를 참조합니다.
* 주기 변경 시, 정기배송주기코드(OM034), 정기배송기간코드(OM008)을 참조합니다.