> 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/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)을 참조합니다.


---

# 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/back-office/order-bo/undefined-2.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.