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

# 기획전 관리

기획전 관리는 기획전 정보 관리와 기획전 그룹 관리로 나뉘어져 있습니다. 해당 기능은 사이트와 몰을 기준으로 기획전 정보를 관리하며, 기획전 기본 정보 및 구분자별 정보를 설정하고 전시 상품을 추가 또는 삭제할 수 있습니다. 또한, 등록된 기획전들을 그룹화하여 효율적으로 관리할 수 있습니다.

## 주요 기능

* **기획전 정보 관리**
  * 사이트, 몰, 기획전 번호(mkdpNo)를 기준으로 기획전 정보를 등록할 수 있습니다.
  * 기획전 기본 정보와 구분자별 정보를 관리합니다.
  * 기획전 콘텐츠로 이미지와 동영상을 등록할 수 있으며, 전시매체당 1개씩 등록 가능합니다.
  * 기획전 구분자 유형으로 텍스트, 이미지, HTML을 선택할 수 있으며, 해당 유형에 따라 콘텐츠를 등록합니다.
  * 각 구분자별로 일반상품, 판매 중, 품절상품을 등록하고, 상품 전시순서를 통해 노출 순서를 제어할 수 있습니다.
* **기획전 그룹 관리**
  * 사이트와 몰을 기준으로 기획전 그룹을 등록할 수 있습니다.
  * 그룹별로 서브 기획전을 조회 및 등록할 수 있으며, 각 기획전의 전시순서를 통해 노출 순서를 제어할 수 있습니다.
* **기획전 권한 체크**
  * 전시회원 등급과 임직원 여부에 따라 기획전 노출을 제한할 수 있습니다.
  * 권한 체크 기준은 AND 기준으로 전시회원 등급(GREEN) 및 임직원 전용 여부를 설정할 수 있습니다.
  * 설정된 권한에 따라 기획전은 특정 회원 등급 또는 임직원에게만 노출되거나 모든 사용자에게 노출됩니다.

***

## 프로세스 정의 — 기획전 관리

<figure><img src="/files/f0Wo0gxEkYly1k64YJbq" 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="111.2222900390625">API</th><th width="333.4443359375">설명</th><th width="93.5555419921875">Server</th><th width="89.1112060546875">메소드</th><th>비</th></tr></thead><tbody><tr><td>기획전 정보 목록 조회</td><td>•기획전 정보 목록을 조회합니다. <br>•전시순서 내림차순, 전시시작날짜 내림차순으로 노출합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getPrMkdpBaseList">🔗API 확인하기 ></a></td></tr><tr><td>기획전 정보 관리 목록 저장</td><td>•기획전 정보 목록을 수정/삭제 합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveMarketingDisplayMgmtList">🔗API 확인하기 ></a></td></tr><tr><td>기획전 단건 복사</td><td>•기획전 정보를 단건 복사합니다. <br>•복사된 기획전 명은 ‘기획전명 + (복사)’, 전시여부는 전시안함으로 고정됩니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=registerCopyMarketingDisplayMgmt">🔗API 확인하기 ></a></td></tr><tr><td>기획전 정보 상세 조회</td><td>•기획전 상세정보를 조회합니다. <br>•기획전, 언어코드를 통해 해당 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getPrMkdpBaseDetail">🔗API 확인하기 ></a></td></tr><tr><td>기획전 이미지 상세 조회</td><td>•기획전 이미지 상세정보를 조회합니다. <br>•기획전, 언어코드를 통해 해당 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getPrMkdpBaseDetail">🔗API 확인하기 ></a></td></tr><tr><td>기획전 기본정보 저장</td><td>•기획전 기본정보를 등록 및 수정합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=savePrMkdpBase">🔗API 확인하기 ></a></td></tr><tr><td>기획전 기본정보 다국어 조회</td><td>•기획전 기본정보 다국어 정보를 조회합니다. <br>•기획전 번호, 언어코드를 통해 해당 기본정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getPrMkdpBaseMultiLanguage">🔗API 확인하기 ></a></td></tr><tr><td>기획전 기본정보 다국어 저장</td><td>•기획전 기본정보 다국어 정보를 저장합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveMarketingDisplayMgmtBaseMl">🔗API 확인하기 ></a></td></tr><tr><td>기획전 구분자 정보 조회</td><td>•기획전 구분자 상세정보를 조회합니다. <br>•기획전, 언어코드를 통해 해당 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getPrMkdpDivobjMultiLanguage">🔗API 확인하기 ></a></td></tr><tr><td>기획전 구분자탭 저장</td><td>•기획전 구분자 정보를 등록/수정/삭제합니다.</td><td>BO</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=common&#x26;depth=%EC%95%8C%EB%A6%BC%EB%A9%94%EC%8B%9C%EC%A7%80&#x26;path=sendMessage">🔗API 확인하기 ></a></td></tr><tr><td>기획전 구분자 다국어 정보 조회</td><td><p>•기획전 구분자 다국어 정보를 조회합니다.</p><p>•기획전번호, 언어코드를 통해 해당 다국어 정보를 조회합니다.</p></td><td>BO</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=common&#x26;depth=%EC%95%8C%EB%A6%BC%EB%A9%94%EC%8B%9C%EC%A7%80&#x26;path=sendMessage">🔗API 확인하기 ></a></td></tr><tr><td>기획전 구분자 다국어 정보 저장</td><td>•기획전 구분자 다국어 정보를 저장합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=savePrMkdpDivobjMl">🔗API 확인하기 ></a></td></tr><tr><td>기획전 구분자 그리드 목록 조회</td><td>•기획전 구분자 그리드 목록을 조회합니다. <br>•전시순서, 구분자번호 순으로 노출됩니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getMarketingDisplayDivobjGridListpresearch.com/?utm_source=extcr">🔗API 확인하기 ></a></td></tr><tr><td>기획전 구분자별 상품 그리드 목록 조회</td><td>•기획전 구분자별 상품 그리드 목록을 조회합니다. <br>•전시순서, 상품등록날짜 순으로 노출됩니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getDivobjGoodsGridList">🔗API 확인하기 ></a></td></tr><tr><td>기획전 상품 그리드 저장</td><td>•기획전 상품 그리드 목록을 등록/수정/삭제합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveDivobjGoodsGridList">🔗API 확인하기 ></a></td></tr><tr><td>중복, 존재하지 않는 상품 제외한 리스트 목록 조회</td><td>•기획전 상품의 중복, 존재하지 않는 상품들을 제외하고 해당 정보들을 리턴해 조회합니다. <br>•중복, 존재하지 않을 시 상품 에러메시지를 담아서 해당 결과값을 반환합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getValidDisplayGoodsList">🔗API 확인하기 ></a></td></tr><tr><td>기획전 상품정보 상세 조회</td><td>•기획전 구분자별 상품 상세정보를 조회합니다. <br>•기획전번호, 구분자번호를 통해 해당 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getGoodsListDetail">🔗API 확인하기 ></a></td></tr><tr><td>기획전 상품 엑셀 일괄 저장</td><td>•기획전 상품을 엑셀 일괄 저장합니다. <br>•중복된 상품을 제외하고 등록합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveMarketingMgmtExcelGoodsList">🔗API 확인하기 ></a></td></tr></tbody></table>

***

## 프로세스 정의 — 기획전 그룹관리

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

{% stepper %}
{% step %}

### 기획전 그룹 관리 목록

\- 기획전 그룹 목록을 조회합니다.\
\- 기획전 그룹을 등록/수정/삭제 합니다.
{% endstep %}

{% step %}

### 기획전 그룹 관리 다국어 팝업

\- 기획전 그룹 다국어 목록을 조회합니다.\
\- 기획전 그룹 다국어 목록을 등록/수정합니다.
{% endstep %}

{% step %}

### 서브 기획전 목록

\- 그룹별 서브 기획전 목록을 조회합니다.\
\- 그룹별 기획전 정보를 등록하기전 중복을 체크합니다.\
\- 서브 기획전 목록을 저장합니다.
{% endstep %}

{% step %}

### 서브 기획전 팝업

\- 기획전 정보 목록을 조회합니다.
{% endstep %}
{% endstepper %}

***

## API 목록 — 기획전 그룹관리

<table><thead><tr><th width="119">API</th><th width="374.77783203125">설명</th><th width="93.5555419921875">Server</th><th width="91.3333740234375">메소드</th><th>비고</th></tr></thead><tbody><tr><td>기획전 그룹 목록 조회</td><td>•기획전 그룹 정보 목록을 조회합니다. <br>•전시순서 오름차순, 등록날짜 내림차순으로 <br>노출됩니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getPrDispGrpBaseList">🔗API 확인하기 ></a></td></tr><tr><td>서브 기획전 목록 조회</td><td>•그룹에 속한 기획전 목록을 조회합니다. <br>•전시순서 오름차순, 전시시작날짜 내림차순으로 노출됩니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=savePrDispGrpMappInfoList">🔗API 확인하기 ></a></td></tr><tr><td>서브 기획전 목록저장시 중복체크</td><td>•서브 기획전 저장 시 중복체크 합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getMarketingDisplayGroupMgmtSubMarketingDisplayChk">🔗API 확인하기 ></a></td></tr><tr><td>기획전 정보 목록 조회</td><td>•기획전 팝업 – 기획전 정보 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getMarketDisplayList">🔗API 확인하기 ></a></td></tr><tr><td>기획전 그룹 목록 등록/<br>수정/삭제</td><td>•기획전 그룹 정보 목록을 등록/수정/삭제합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=savePrDispGrpBaseList">🔗API 확인하기 ></a></td></tr><tr><td>서브 기획전 목록 저장</td><td>•서브 기획전 목록을 등록/수정/삭제 합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=savePrDispGrpMappInfoList">🔗API 확인하기 ></a></td></tr><tr><td>기획전 그룹 다국어 목록 조회</td><td>•기획전 그룹 다국어 정보를 조회합니다. <br>•전시그룹번호, 전시그룹유형코드를 통해 해당 정보를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getMarketingDisplayGroupMultiLanguageList">🔗API 확인하기 ></a></td></tr><tr><td>기획전 그룹 다국어 목록 저장</td><td>•기획전 그룹 다국어 목록을 저장합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=saveMarketingDisplayGroupMultiLanguageList">🔗API 확인하기 ></a></td></tr></tbody></table>

***

## 용어 정의

<table><thead><tr><th width="131.7777099609375">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>전시기간</td><td>기획전이 기획전 목록에서 전시되는 기간을 말합니다. <br>전시기간이 끝난 기획전은 상세 진입이 안됩니다.</td><td></td></tr><tr><td>템플릿</td><td>기획전 템플릿에 따라 기획전 상세페이지를 구성합니다. <br>현재 4개(기획전 템플릿1, 2, 3, 4)의 템플릿이 존재합니다.</td><td></td></tr><tr><td>회원등급</td><td>회원등급에 따라 기획전 노출을 제한합니다. <br>회원 등급 : GREEN, FAMILY, GOLD, VIP, VVIP</td><td></td></tr><tr><td>임직원전용</td><td>임직원 적용 여부에 따라 기획전 노출을 제한합니다.</td><td></td></tr><tr><td>기획전 구분자</td><td>기획전 상세페이지에서 구분 영역을 나타내는 용어를 말합니다. <br>기획전 구분자 별로 구분자정보, 쿠폰배너, 상품리스트를 포함하고 있습니다.</td><td></td></tr></tbody></table>

***