> 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-2.md).

# 전시 템플릿/코너 관리

전시매장에 적용되는 템플릿 파일 정보를 체계적으로 관리하고 수정 및 삭제 제한을 통해 신뢰성 있는 운영을 지원하는 기능을 제공합니다. 매장템플릿에 연결된 코너 컴포넌트 파일 정보를 효율적으로 관리합니다.

***

## 주요 기능

* **전시 템플릿 관리**
  * 템플릿 유형으로는 일반 템플릿, 카테고리 템플릿, 브랜드 템플릿, 기획전 템플릿이 있습니다.
  * 중복된 템플릿 파일명 저장이 불가능합니다.
  * 전시매장에 연결된 경우 템플릿 수정 및 삭제가 불가능합니다.
* **전시 코너 관리**
  * 전시코너는 일반, 더미, 스와이퍼 유형으로 구성될 수 있습니다.
  * 중복된 코너ID 저장이 불가능합니다.
  * 일반, 스와이퍼 코너인 경우 최소 1개에서 최대 10개 세트 개수로 구성될 수 있습니다. 세트 구성 시 최소 1개의 전시대상 정보 저장이 필요합니다.
  * 전시매장에 연결된 경우 코너 수정 및 삭제가 불가능합니다.
* **매장 템플릿 관리**
  * 전시매장에 연결된 전시템플릿은 매장템플릿이라고 정의되며, 1:N으로 연결될 수 있습니다.
  * 매장템플릿에 연결된 전시코너는 템플릿코너로 정의되며, 1:N으로 연결될 수 있습니다.
  * 매장템플릿에 연결된 전시템플릿 또는 전시코너가 있을 경우 매장템플릿 수정 및 삭제가 불가능합니다.

## 프로세스 정의 — 전시 템플릿 관리

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

{% stepper %}
{% 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="116.77783203125">API</th><th width="327">설명</th><th width="93.5555419921875">Server</th><th width="89.111083984375">메소드</th><th>비고</th></tr></thead><tbody><tr><td>전시 템플릿 상세 조회</td><td>•템플릿번호로 해당 템플릿 상세 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EC%A0%84%EC%8B%9C%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=getDisplayTemplateDetail">🔗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=%EC%A0%84%EC%8B%9C%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=getDisplayTemplateList">🔗API 확인하기 ></a></td></tr><tr><td>전시 템플릿 연결 매장/기획전 목록 <br>조회</td><td>•템플릿번호, 템플릿유형코드, 페이지번호로 전시 템플릿에 연결된 매장/기획전 목록을 조회합니다. </td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EC%A0%84%EC%8B%9C%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=getDisplayTemplateMappInfoList">🔗API 확인하기 ></a></td></tr><tr><td>전시 템플릿 연결 매장/<br>기획전 존재 여부</td><td>•템플릿번호, 템플릿유형코드로 전시 템플릿이 연결된 매장/기획전 존재 여부를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EC%A0%84%EC%8B%9C%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=getDisplayTemplateMappCheck">🔗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=%EC%A0%84%EC%8B%9C%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=saveTemplateList">🔗API 확인하기 ></a></td></tr><tr><td>전시 템플릿 저장</td><td>•전시 템플릿 등록하기 위한 API 입니다.<br>•템플릿 파일명은 중복될 수 없습니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EC%A0%84%EC%8B%9C%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=saveTemplate">🔗API 확인하기 ></a></td></tr><tr><td>전시 템플릿 수정</td><td>•전시 템플릿 수정하기 위한 API 입니다. <br>•전시 템플릿이 연결된 매장/기획전이 있을 경우 수정이 불가능합니다. </td><td>BO</td><td>PUT</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EC%A0%84%EC%8B%9C%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=modifyTemplate">🔗API 확인하기 ></a></td></tr><tr><td>매장 연결 <br>템플릿 목록 조회</td><td>•매장번호로 전시매장에 연결된 템플릿 <br>목록을 조회합니다. </td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EC%A0%84%EC%8B%9C%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=getShopMappTemplateList">🔗API 확인하기 ></a></td></tr><tr><td>매장 연결 <br>템플릿 목록 저장</td><td>•매장 연결 템플릿 목록을 저장, 수정, 삭제 할 수 있습니다. <br>•매장 템플릿에 연결된 코너가 있을 경우 삭제 불가능합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EC%A0%84%EC%8B%9C%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=getDisplayTemplateDetail">🔗API 확인하기 ></a></td></tr></tbody></table>

***

## 프로세스 정의 — 전시코너 관리

<figure><img src="/files/OJ2AV33MBLPBlRq6kMal" 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 %}
  {% endstepper %}

## API 목록 — 전시코너

<table><thead><tr><th width="107.7777099609375">API</th><th width="295.4444580078125">설명</th><th width="95.888916015625">Server</th><th width="91.3333740234375">메소드</th><th>비고</th></tr></thead><tbody><tr><td>코너 목록 조회</td><td>•코너 저장 시 사용되는 API입니다. <br>•코너ID는 중복 등록이 불가능합니다.</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>•상품검색을 통해 검색된 상품의 기본정보를 조회하는 API 입니다</td><td>BO</td><td>POST</td><td></td></tr><tr><td>코너 수정</td><td>•코너 수정 시 사용되는 API입니다. <br>•코너가 연결된 매장템플릿이 있을 경우 수정이 불가능합니다.</td><td>BO</td><td>PUT</td><td></td></tr><tr><td>코너 목록 저장</td><td>•전시코너목록 저장 시 사용되는 API 입니다. <br>•전시코너목록에서 코너 삭제기능만 제공하고 있어 상세로직은 삭제기능만 구형되어 있습니다.</td><td>BO</td><td>POST</td><td></td></tr><tr><td>매장템플릿 연결 코너 목록 조회</td><td>•매장템플릿번호로 매장 템플릿에 연결된 템플릿코너 목록을 조회합니다.</td><td>BO</td><td>GET</td><td></td></tr><tr><td>매장템플릿 연결 코너 존재 여부</td><td>•매장템플릿번호로 매장템플릿에 연결된 템플릿코너 존재 여부를 조회합니다.</td><td>BO</td><td>GET</td><td></td></tr><tr><td>매장템플릿 연결 코너 목록 저장</td><td>•매장템플릿에 연결된 템플릿코너 목록을 저장, 수정, 삭제 할 수 있습니다.</td><td>BO</td><td>POST</td><td></td></tr><tr><td>코너 연결 매장템플릿 존재 여부</td><td>•코너번호로 해당 코너가 연결된 매장템플릿 존재 여부를 조회합니다.</td><td>BO</td><td>GET</td><td></td></tr><tr><td>코너 연결 매장 목록 조회</td><td>•코너번호로 해당 코너가 연결된 전시매장 목록을 조회합니다.</td><td>BO</td><td>GET</td><td></td></tr></tbody></table>

***

## 용어 정의

<table><thead><tr><th width="118.4444580078125">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>전시템플릿</td><td>•페이지 레이아웃을 영역별 또는 상품이 전시되는 형태로 구성되는 파일을 정의하는 단위입니다. <br>•일반 템플릿, 기획전 템플릿, 카테고리 템플릿, 브랜드 템플릿으로 구분됩니다. <br>•전시매장, 기획전 등에서 사용될 수 있습니다.</td><td></td></tr><tr><td>전시코너</td><td>•페이지 레이아웃 내에서 HTML, 상품, 브랜드, 이미지 등의 콘텐츠로 구성되는<br>컴포넌트 파일을 정의하는 단위입니다. <br>•일반코너, 더미코너, 스와이퍼 코너로 구분됩니다. <br>•노출할 세트 개수를 최소 1개에서 최대 10개로 설정할 수 있습니다.</td><td></td></tr><tr><td>매장템플릿</td><td>•전시매장에 연결된 전시템플릿 단위를 의미합니다. <br>•전시매장에 1:N으로 연결이 가능합니다. <br>•사용여부가 ‘사용’으로 되어 있는 전시템플릿 목록 중 하나 혹은 여러 개를 선택하여 전시매장에 연결할 수 있습니다.</td><td></td></tr><tr><td>템플릿코너</td><td>•매장템플릿에 연결된 전시코너 단위를 의미합니다. <br>•매장템플릿에 1:N으로 연결이 가능합니다. <br>•사용여부가 ‘사용’으로 되어 있는 전시코너 목록 중 하나 혹은 여러 개를 선택하여 <br>매장템플릿에 연결할 수 있습니다.</td><td></td></tr></tbody></table>

##