> 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/system-bo/undefined-4.md).

# 기본 정보 관리

관리자 시스템에서 필요한 기본정보를 효율적으로 관리하는 기능을 제공하는 서비스입니다. 휴일, 우편번호, 금칙어, 공통코드 등을 조회하고, 등록/수정/삭제할 수 있으며, 필요 시 다국어 정보도 관리할 수 있습니다.

***

## 주요 기능

* **휴일 관리**
  * 공휴일 및 사이트 내 기념일, 배송휴무일을 효율적으로 관리합니다.
* **우편번호 관리**
  * 우편번호 정보를 조회하고 등록/수정/삭제할 수 있습니다.
* **금칙어 관리**
  * 사이트 내 금칙어를 관리하여 해당 단어의 검색 또는 작성을 제한합니다.
* **공통코드 관리**
  * 개발에 사용되는 공통코드를 효율적으로 관리합니다.

## 프로세스 정의 — 휴일 및 금칙어 관리

사이트의 휴일 및 금칙어를 조회하거나 등록, 수정, 삭제 할 수 있습니다.

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

{% stepper %}
{% step %}

### 휴일관리조회

선택한 조회조건에 대한 휴일 건수 및 휴일 정보를 조회합니다.
{% endstep %}

{% step %}

### 휴일 등록/수정/삭제

휴일을 신규로 등록하거나 기존 휴일을 수정하고 삭제합니다.
{% endstep %}

{% step %}

### 휴일 일괄등록

엑셀이나 csv로 휴일 정보를 업로드하면 해당 정보를 신규로 저장합니다. 기존에 등록된 휴일이 존재하면 등록이 불가합니다.
{% endstep %}

{% step %}

### 금칙어조회

선택한 조회조건에 대한 금칙어 건수 및 금칙어 정보를 조회합니다.
{% endstep %}

{% step %}

### 금칙어 저장/수정/삭제

금칙어를 신규로 등록하거나 기존 금칙어를 수정하고 삭제합니다.
{% endstep %}

{% step %}

### 금칙어 다국어 목록 조회

화면에서 선택한 금칙어에 대한 다국어 정보를 조회합니다.
{% endstep %}

{% step %}

### 금칙어 다국어 등록/수정

화면에서 선택한 금칙어에 대한 다국어 정보를 등록, 수정합니다.
{% endstep %}
{% endstepper %}

## 프로세스 정의 — 우편번호 및 공통코드 관리

우편번호 및 사이트 개발에 쓰이는 공통코드를 조회하거나 등록, 수정, 삭제 할 수 있습니다.

<figure><img src="/files/5zLWzUIWu91ONEfD9R4c" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% 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="312.3333740234375">설명</th><th width="92.4444580078125" align="center">Server</th><th width="91.333251953125" align="center">메소드</th><th>비고</th></tr></thead><tbody><tr><td>휴일 관리 건수 조회</td><td>공휴일자, 업무구분, 공휴일 구분에 맞는 휴일 목록 건수를 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%ED%9C%B4%EC%9D%BC%20%EA%B4%80%EB%A6%AC&#x26;path=getHolidayListCount">🔗API 확인하기 ></a></td></tr><tr><td>휴일 관리 목록 조회</td><td>공휴일자, 업무구분, 공휴일 구분에 맞는 휴일 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%ED%9C%B4%EC%9D%BC%20%EA%B4%80%EB%A6%AC&#x26;path=getHolidayList">🔗API 확인하기 ></a></td></tr><tr><td>휴일 일괄등록</td><td>엑셀 혹은 csv로 업로드된 휴일 정보를 일괄로 등록합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%ED%9C%B4%EC%9D%BC%20%EA%B4%80%EB%A6%AC&#x26;path=registHolidayExcelList">🔗API 확인하기 ></a></td></tr><tr><td>휴일 등록/수정/삭제</td><td>휴일을 등록, 수정, 삭제합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%ED%9C%B4%EC%9D%BC%20%EA%B4%80%EB%A6%AC&#x26;path=saveHolidayList">🔗API 확인하기 ></a></td></tr></tbody></table>

## API 기능 목록 — 우편번호 관리

<table><thead><tr><th width="127.888916015625">API</th><th width="273.8887939453125">설명</th><th width="92.4444580078125" align="center">Server</th><th width="91.3333740234375" align="center">메소드</th><th>비고</th></tr></thead><tbody><tr><td>우편번호 목록 총 건수 조회</td><td>시도명, 시군구명, 검색어에 맞는 우편번호 목록 건수를 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%9A%B0%ED%8E%B8%EB%B2%88%ED%98%B8%20%EA%B4%80%EB%A6%AC&#x26;path=getZipNoListCount">🔗API 확인하기 ></a></td></tr><tr><td>우편번호 목록 조회</td><td>시도명, 시군구명, 검색어에 맞는 우편번호 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%9A%B0%ED%8E%B8%EB%B2%88%ED%98%B8%20%EA%B4%80%EB%A6%AC&#x26;path=getZipNoList">🔗API 확인하기 ></a></td></tr><tr><td>시도명 목록 조회</td><td>시도명 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%9A%B0%ED%8E%B8%EB%B2%88%ED%98%B8%20%EA%B4%80%EB%A6%AC&#x26;path=getSidoList">🔗API 확인하기 ></a></td></tr><tr><td>구군명 목록 조회</td><td>구군명 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%9A%B0%ED%8E%B8%EB%B2%88%ED%98%B8%20%EA%B4%80%EB%A6%AC&#x26;path=getGuginList">🔗API 확인하기 ></a></td></tr><tr><td>우편번호 저장/수정/삭제</td><td>우편번호 정보를 저장, 수정, 삭제 합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EC%9A%B0%ED%8E%B8%EB%B2%88%ED%98%B8%20%EA%B4%80%EB%A6%AC&#x26;path=saveZipNoList">🔗API 확인하기 ></a></td></tr></tbody></table>

## API 기능 목록 — 금칙어 관리

<table><thead><tr><th width="112.3333740234375">API</th><th width="375.77783203125">설명</th><th width="93.5555419921875" align="center">Server</th><th width="91.3333740234375" align="center">메소드</th><th>비고</th></tr></thead><tbody><tr><td>금칙어 목록 건수 조회</td><td>금칙어명, 사용여부 조건에 맞는 금칙어 건수를 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B8%88%EC%B9%99%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getBadWordListCount">🔗API 확인하기 ></a></td></tr><tr><td>금칙어 목록 조회</td><td>금칙어명, 사용여부 조건에 맞는 금칙어 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B8%88%EC%B9%99%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getBadWordList">🔗API 확인하기 ></a></td></tr><tr><td>금칙어 저장/수정/<br>삭제</td><td>금칙어 목록을 저장, 수정, 삭제합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B8%88%EC%B9%99%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveBadWord">🔗API 확인하기 ></a></td></tr><tr><td>금칙어 <br>다국어 목록 건수 조회</td><td>선택한 금칙어에 대한 다국어 목록 건수를 조회합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B8%88%EC%B9%99%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getBadWordMlListCount">🔗API 확인하기 ></a></td></tr><tr><td>금칙어 <br>다국어 목록 조회</td><td>선택한 금칙어에 대한 다국어 목록을 조회합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B8%88%EC%B9%99%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getBadWordMlList">🔗API 확인하기 ></a></td></tr><tr><td>금칙어 <br>다국어 등록/수정</td><td>다국어 금칙어를 등록, 수정합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B8%88%EC%B9%99%EC%96%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveBadWordMl">🔗API 확인하기 ></a></td></tr></tbody></table>

## API 기능 목록 — 공통코드 관리

<table><thead><tr><th width="105.6666259765625">API</th><th width="392.22216796875">설명</th><th width="92.4444580078125" align="center">Server</th><th width="92.4443359375" align="center">메소드</th><th>비고</th></tr></thead><tbody><tr><td>그룹코드 목록 건수 조회</td><td>그룹코드, 그룹코드명, 사용여부, 다국어대상여부에 대한 그룹코드 목록 건수를 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C%20%EA%B4%80%EB%A6%AC&#x26;path=getGroupCodeListCount">🔗API 확인하기 ></a></td></tr><tr><td>그룹코드 목록 조회</td><td>그룹코드, 그룹코드명, 사용여부, 다국어대상여부에 대한 그룹코드를 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C%20%EA%B4%80%EB%A6%AC&#x26;path=getGroupCodeList">🔗API 확인하기 ></a></td></tr><tr><td>그룹코드 등록/수정</td><td>그룹코드를 등록, 수정합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C%20%EA%B4%80%EB%A6%AC&#x26;path=saveGroupCode">🔗API 확인하기 ></a></td></tr><tr><td>기준코드 목록 건수 조회</td><td>그룹코드에 대한 기준코드 목록 건수를 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C%20%EA%B4%80%EB%A6%AC&#x26;path=saveGroupCode">🔗API 확인하기 ></a></td></tr><tr><td>기준코드 목록 조회</td><td>그룹코드에 대한 기준코드 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C%20%EA%B4%80%EB%A6%AC&#x26;path=getStandardCodeList">🔗API 확인하기 ></a></td></tr><tr><td>기준코드 등록/수정</td><td>기준코드를 등록, 수정합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C%20%EA%B4%80%EB%A6%AC&#x26;path=saveStandardCode">🔗API 확인하기 ></a></td></tr><tr><td>기준코드 다국어 <br>목록 건수 조회</td><td>기준코드에 대한 다국어 목록 건수를 조회합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C%20%EA%B4%80%EB%A6%AC&#x26;path=getStandardCodeMlListCount">🔗API 확인하기 ></a></td></tr><tr><td>기준코드 다국어 <br>목록 조회</td><td>기준코드에 대한 다국어 목록을 조회합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C%20%EA%B4%80%EB%A6%AC&#x26;path=getStandardCodeMlList">🔗API 확인하기 ></a></td></tr><tr><td>기준코드 다국어 <br>등록/수정</td><td>기준코드 다국어를 등록, 수정합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="https://apibo.x2bee.com/content?bo=system&#x26;depth=%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C%20%EA%B4%80%EB%A6%AC&#x26;path=saveStandardCodeMl">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="85.111083984375">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>금칙어</td><td>금칙어"는 특정한 상황이나 맥락에서 사용하기 부적절하거나 무례하다고 여겨지는 단어나 표현을 가리키는 용어를 말합니다.</td><td></td></tr></tbody></table>


---

# 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, and the optional `goal` query parameter:

```
GET https://tech.x2bee.com/api-guide/back-office/system-bo/undefined-4.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.