> 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/marketing-bo/undefined-8.md).

# 이벤트 템플릿 관리

Created by X2BEE 관리자, last modified on 2024-01-05

쇼핑몰에서 다양한 조회 조건을 활용하여 이벤트 템플릿을 효율적으로 조회하고, 등록/수정/삭제하는 기능을 제공합니다. 템플릿은 이벤트의 기본 구조와 상세 정보를 미리 설정하여 사용자 편의성을 높이는 데 사용됩니다.

***

## 주요 기능

* **이벤트 템플릿 조회**
  * 사용여부, 템플릿 번호/명, 템플릿 설명을 설정하여 이벤트 템플릿을 조회합니다.
* **이벤트 템플릿 등록**
  * 새로운 이벤트 템플릿을 등록합니다.
  * 템플릿 번호는 자동으로 채번되며, 기본정보 및 상세 정보를 입력하여 등록합니다.
* **이벤트 템플릿 수정**
  * 기존의 이벤트 템플릿을 수정합니다.
  * 상세 정보를 수정할 경우, 기존 정보를 삭제하고 새로운 정보를 등록합니다.
* **이벤트 템플릿 삭제**
  * 선택한 이벤트 템플릿을 삭제합니다.
  * 그리드에서 해당 템플릿을 선택하여 삭제합니다.

## 프로세스 정의

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

{% stepper %}
{% step %}

### 이벤트 템플릿 목록 조회

조건을 설정하여 이벤트 템플릿 목록과 건수를 조회합니다.
{% endstep %}

{% step %}

### 이벤트 템플릿 등록

템플릿 등록을 하면, 새로 템플릿 번호를 채번하면서 해당 템플릿 번호를 기준으로 템플릿 베이스 정보와 템플릿 상세 정보를 등록합니다.
{% endstep %}

{% step %}

### 이벤트 템플릿 조회

템플릿 번호로 템플릿 기본정보와 상세 정보를 조회하여 상세 팝업을 호출합니다.
{% endstep %}

{% step %}

### 이벤트 템플릿 수정

템플릿 상세 팝업에서 기본정보를 수정 시, 템플릿 베이스 수정이 되며, 상세 정보를 수정 시, 기존 상세 정보는 모두 삭제하고 다시 새로 상세 등록이 됩니다.
{% endstep %}

{% step %}

### 이벤트 템플릿 삭제

템플릿 그리드 목록에서 row 삭제 상태로 체크 후, 저장 시 이벤트 템플릿이 삭제됩니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="127.888916015625">API</th><th width="285">설명</th><th width="92.4444580078125">Server</th><th width="93.5555419921875">메소드</th><th>비고</th></tr></thead><tbody><tr><td>이벤트 템플릿 그리드 저장</td><td>이벤트 템플릿 그리드를 저장합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventTemplateGrid">🔗API 확인하기 ></a></td></tr><tr><td>이벤트 템플릿 상세 등록</td><td>이벤트 템플릿 상세를 등록합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventTemplateDtlInfo">🔗API 확인하기 ></a></td></tr><tr><td>이벤트 템플릿 베이스 등록</td><td>이벤트 템플릿 베이스를 등록합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventTemplateBase">🔗API 확인하기 ></a></td></tr><tr><td>등록된 이벤트 템플릿 목록 조회</td><td>등록된 이벤트 템플릿 목록을 조회합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=getTemplateListapibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventTemplateBase">🔗API 확인하기 ></a></td></tr><tr><td>등록된 이벤트 템플릿 목록 건수조회</td><td>등록된 이벤트 템플릿 목록 건수를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=getTemplateListCount">🔗API 확인하기 ></a></td></tr><tr><td>이벤트 템플릿 시퀀스 채번</td><td>이벤트 템플릿 시퀀스를 채번합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=getTmplNo">🔗API 확인하기 ></a></td></tr><tr><td>이벤트 템플릿 수정용 조회</td><td>이벤트 템플릿 수정용 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=getTmplInfo">🔗API 확인하기 ></a></td></tr><tr><td>이벤트 템플릿 수정시 상세 데이터 삭제</td><td>이벤트 템플릿 수정 시 상세 데이터를 삭제합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%ED%85%9C%ED%94%8C%EB%A6%BF%20%EA%B4%80%EB%A6%AC&#x26;path=deleteEventTemplateDtlInfo">🔗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>이벤트가 이벤트 목록에서 전시되는 기간. 전시기간이 끝난 이벤트는 상세 진입이 안됩니다.</td><td></td></tr><tr><td>응모기간<br>(행사기간)</td><td>이벤트 응모가 되는 기간</td><td></td></tr><tr><td>추첨이벤트</td><td>추첨을 통해서 당첨자가 정해지는 이벤트</td><td></td></tr><tr><td>비추첨이벤트</td><td>추첨이 아닌 즉시지급, 또는 리워드 없는 이벤트</td><td></td></tr></tbody></table>