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