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

# 이벤트 정보관리

쇼핑몰에서 다양한 이벤트를 효율적으로 관리하는 기능을 제공합니다. 이를 통해 이벤트의 생성, 조회, 수정, 그리고 응모자 및 당첨자의 관리가 용이하며, 관련된 알림 및 지급 작업을 효과적으로 수행할 수 있습니다.

***

## 주요 기능

* **이벤트 조회 및 미리보기**
  * 기간, 유형, 번호, 상태 등 다양한 조회 조건을 통해 이벤트를 효과적으로 조회할 수 있습니다.
  * 전체 이벤트를 목록화하여 미리보기를 통해 각 이벤트의 상세 내용을 확인할 수 있습니다.
* **이벤트 등록 및 상세 관리**
  * 새로운 이벤트를 등록할 수 있으며, 상세 탭에서 응모자 추가, 응모자 일괄등록, 그리드 엑셀 다운로드 기능을 제공합니다.
* **이벤트 상세, 응모 및 추첨 관리**
  * 응모자 추가, 응모자 일괄등록을 통해 이벤트 응모자를 효과적으로 관리합니다.
  * 추첨, 당첨취소, 재추첨, 대기자 추가/취소 등 추첨과 관련된 작업을 수행합니다.
  * 당첨자에게는 알림톡 및 메일을 전송하고, 경품 당첨자의 송장번호를 저장합니다.
* **이벤트 상세, 지급 관리**
  * 알림톡 발송, 메일발송, 입금확인취소, 송장번호 저장, 경품/사은품/마일리지/쿠폰 지급요청 등 다양한 지급 작업을 효과적으로 관리합니다.

## 프로세스 정의 — 이벤트 정보 관리

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

{% stepper %}
{% step %}

#### 이벤트 조회

전체 이벤트를 목록화하여 노출하며, 각각의 이벤트의 상세 내용 및 MO 노출 미리보기를 확인 할 수 있습니다.
{% endstep %}

{% step %}

#### 이벤트 등록

이벤트 등록/상세 팝업에서 이벤트 기본정보를 입력하여 이벤트를 등록합니다. 각 이벤트 유형에 따라 유효성 처리가 되어 있습니다.
{% endstep %}

{% step %}

#### 이벤트 삭제

이벤트 관리 상태가 ‘임시등록’ 상태인 이벤트만 삭제 가능합니다.
{% endstep %}

{% step %}

#### 이벤트 상세

그리드 행의 이벤트 번호 클릭 시, 해당 이벤트 상세를 조회합니다.
{% endstep %}

{% step %}

#### 이벤트 목록 조회

입력한 조회 조건에 따라 이벤트를 조회합니다.\
조회조건 : 기간, 이벤트유형, 전시여부, 진행부서, 이벤트번호/명, 이벤트관리상태, 최상단고정여부, 담당자
{% endstep %}

{% step %}

#### 이벤트 미리보기

해당 행의 이벤트 명을 클릭시, 미리보기 파라미터(previewDate) 값이 "Y" 인 상태로, 해당 MO 이벤트 상세 미리보기 화면이 호출됩니다.
{% endstep %}

{% step %}

#### 엑셀 다운로드

화면 내 조회된 그리드에 있는 모든 목록을 엑셀 다운로드합니다.
{% endstep %}

{% step %}

#### 응모 이력 조회

입력된 조회 조건에 따라 이벤트 응모 이력을 조회합니다.\
조회조건 : 이벤트번호/명, 응모번호, 응모일자, 회원ID/명
{% endstep %}
{% endstepper %}

## 프로세스 정의 — 이벤트 응모관리

<figure><img src="/files/0swwgugyjKh929GVdnIW" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### 이벤트 조회

전체 이벤트를 목록화하여 노출하며, 각각의 이벤트의 상세 내용 및 MO 노출 미리보기를 확인 할 수 있습니다.
{% endstep %}

{% step %}

#### 응모관리

해당 이벤트 응모자 목록을 조회하거나 응모자 추가 등록을 합니다. 응모자 목록의 응모일시는 수정이 가능합니다. 미입력 시, 현재일로 설정합니다.\
(이벤트 상세 – 기본정보 저장 이후 등록이 가능합니다.)
{% endstep %}

{% step %}

#### 조회

해당 이벤트의 응모관리 그리드 목록과 수를 조회합니다.
{% endstep %}

{% step %}

#### 응모자 추가

회원 조회 팝업을 통해 회원 정보를 가져와 응모자 추가를 합니다.
{% endstep %}

{% step %}

#### 응모자 일괄 등록

업로드 양식을 다운 받아 내용을 저장하여 해당 파일에 기입한 정보를 응모자로 추가합니다. 해당 응모자 정보를 유효성 체크 후, 성공/실패 결과를 노출합니다.
{% endstep %}

{% step %}

#### 엑셀 다운로드

응모관리 그리드 목록을 엑셀로 다운로드 합니다. 다운로드 하기 전에, 엑셀정보 확인 사유를 입력해야합니다.
{% endstep %}
{% endstepper %}

## 프로세스 정의 — 이벤트 추첨관리

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

{% stepper %}
{% step %}

#### 이벤트 정보관리

전체 이벤트를 목록화하여 노출하며, 각각의 이벤트의 상세 내용 및 MO 노출 미리보기를 확인 할 수 있습니다.
{% endstep %}

{% step %}

#### 추첨관리

당첨자/대기자를 추첨, 취소, 재추첨하거나 대기자 추가를 할 수 있습니다.\
(이벤트 상세 – 기본정보 저장 이후 등록이 가능합니다.)
{% endstep %}

{% step %}

#### 조회

해당 이벤트의 추첨관리 그리드 목록과 수를 조회합니다.
{% endstep %}

{% step %}

#### 추첨

이벤트 당첨자/대기자를 추첨하거나 추첨결과를 조회합니다. 임직원 제외 여부 체크 가능합니다. 유형이 구매자 추첨인 경우, 회원의 결제금액과 최소 주문 결제금액을 체크하여 당첨여부를 진행합니다. 금액 미달일 경우, 대기자 처리됩니다.
{% endstep %}

{% step %}

#### 취소

당첨자/대기자 취소를 하기 위해 취소 사유를 입력하고 취소 상태로 변경합니다.
{% endstep %}

{% step %}

#### 재추첨

당첨자 재추첨일 경우, 이벤트 전체 응모자(대기자 제외) 대상으로 재추첨합니다. 대기자 재추첨일 경우, 대기자 중 당첨자 재추첨을 진행합니다.
{% endstep %}

{% step %}

#### 대기자 추가

응모자를 대기자로 추가합니다.
{% endstep %}

{% step %}

#### 엑셀 다운로드

응모관리 그리드 목록을 엑셀로 다운로드 합니다. 다운로드 하기 전에, 엑셀정보 확인 사유를 입력해야합니다.
{% endstep %}
{% endstepper %}

## 프로세스 정의 — 이벤트 지급관리

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

{% stepper %}
{% step %}

#### 정보 관리

전체 이벤트를 목록화하여 노출하며, 각각의 이벤트의 상세 내용 및 MO 노출 미리보기를 확인 할 수 있습니다.
{% endstep %}

{% step %}

#### 지급 관리

이벤트 당첨자 목록에서 당첨된 리워드 지급 요청 및 메일/알림톡 발송을 합니다.\
(이벤트 상세 – 기본정보 저장 이후 등록이 가능합니다.)
{% endstep %}

{% step %}

#### 발송

‘메일/알림톡 발송’ 버튼은 경품일 때만 클릭 가능합니다.\
메일 발송 클릭 시, 메일 발송 팝업을 호출합니다.
{% endstep %}

{% step %}

#### 테스트 발송

이벤트 메일 발송 테스트를 위한 테스터를 추가 및 삭제를 합니다. 테스트그룹 관리에 등록한 테스터 이메일로 메일을 발송합니다.
{% endstep %}

{% step %}

#### 조회

해당 이벤트의 추첨관리 그리드 목록과 수를 조회합니다.
{% endstep %}

{% step %}

#### 입금확인

제세공과금 입금 여부를 ‘Y’로 변경합니다. 제세공과금 입금에 해당하지 않는 것 포함했을 경우, alert 호출하며 지급요청하지 않습니다.
{% endstep %}

{% step %}

#### 입금확인 취소

제세공과금 입금 여부를 ‘N’으로 변경합니다. 제세공과금 입금 취소에 해당하지 않는 것 포함했을 경우, alert 호출합니다.
{% endstep %}

{% step %}

#### 송장번호 저장

리워드가 ‘경품’인 당첨자의 택배사, 운송장번호를 저장합니다.
{% endstep %}

{% step %}

#### 지급 요청

각 당첨자에 대한 해당 리워드 지급을 요청합니다. 경품인 경우, 제세공과금 입금 여부를 체크합니다. 마일리지인 경우, 알림톡/알림함이 발송됩니다. 쿠폰인 경우, 알림함이 발송됩니다.
{% endstep %}

{% step %}

#### 엑셀 다운로드

지급관리 그리드 목록을 엑셀로 다운로드 합니다. 다운로드 하기 전에, 엑셀정보 확인 사유를 입력해야합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th align="center">API</th><th width="265.666748046875" align="center">설명</th><th width="96.888916015625">Server</th><th width="95.77783203125">메소드</th><th align="center">비고</th></tr></thead><tbody><tr><td align="center">이벤트 관리상태 변경</td><td align="center">이벤트 관리 상태를 변경합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=updateEventStat">🔗API 확인하기 ></a></td></tr><tr><td align="center">테스트 그룹관리 그리드 저장</td><td align="center">테스트 그룹관리 – 그리드를 저장합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveTestGrpInfoMgmt">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 당첨/취소 선정</td><td align="center">해당 이벤트의 응모자 당첨/취소를 선정한다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEvtTrgmnSelectedProc">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 추첨</td><td align="center">해당 이벤트의 응모자 추첨을 한다. *주문정보조회 : api/order/v1/event/evtOrdList</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEvtTrgmnLotProc">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 대기자 취소 저장</td><td align="center">이벤트 대기자취소를 저장합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtTrgmnWaitProc">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 응모관리 그리드 저장</td><td align="center">이벤트 응모관리 – 그리드를 저장합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtTrgmnInfo">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 당첨자 경품지급요청</td><td align="center">이벤트 당첨자 경품지급요청을 합니다. *사은품배송지저장 : /api/order/v1/event/registModifyEtcGftDlvp</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtPmgdPaymentRequest">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 지급관리 송장번호저장</td><td align="center">이벤트 지급관리 – 송장번호를 저장합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtPayMgmtTrgmnInfo">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 당첨자 마일리지 지급요청</td><td align="center">이벤트 당첨자 마일리지 지급요청 *마일리지 지급 : /api/member/v1/milgeage/mlgSaveUse *알림톡/알림함 발송 : /api/common/v1/common/sendMessage</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtMilgPaymentRequest">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 당첨자 이메일 발송</td><td align="center">이벤트 당첨자 이메일을 발송합니다. *메일 발송 : /api/common/interface/bizmessage/sendmail</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtLotWinnerEmailSend">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 당첨취소 저장</td><td align="center">이벤트 당첨취소를 저장한다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtLotWinnerEmailSend">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 관리 목록 그리드 저장</td><td align="center">이벤트 관리 목록 그리드 저장합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtLotWinnerEmailSend">🔗API 확인하기 ></a></td></tr><tr><td align="center">경품지급요청</td><td align="center">경품 지급요청을 한다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtGiveaWayPaymentRequest">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 당첨자 쿠폰 지급완료</td><td align="center">이벤트 당첨자 쿠폰 지급완료 *쿠폰 지급 : /api/order/v1/marketing/cpmDownBo *알림톡/알림함 발송 : /api/common/v1/common/sendMessage</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtCouponRequest">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 적용범위 카테고리 그리드 저장</td><td align="center">이벤트 적용범위 카테고리 그리드를 저장합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtApplyCategory">🔗API 확인하기 ></a></td></tr><tr><td align="center">제세공과금 확인 처리</td><td align="center">제세공과금 확인처리를 합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveChargeAndTaxReqProcDtm">🔗API 확인하기 ></a></td></tr><tr><td align="center">제세공과금 확인 취소 처리</td><td align="center">제세공과금 확인취소 처리를 합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveChargeAndTaxReqProcDtmCancellation">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 상세내용 저장</td><td align="center">이벤트 상세내용을 저장합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveCcEvtBase">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 응모관리 일괄등록 회원 조회</td><td align="center">이벤트 응모관리 – 일괄등록 회원을 조회합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventMgmtMemberCheckList_1">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 상세내용 조회</td><td align="center">이벤트 상세내용을 조회합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventDetail">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 테스트 이메일 발송</td><td align="center">이벤트 테스트 이메일을 발송합니다. *메일 발송 : /api/common/interface/bizmessage/sendmail</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=eventMgmtTestEmailSend">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 등록시 적용범위 카테고리 기본세팅</td><td align="center">이벤트 등록시, 적용범위 카테고리 기본 세팅합니다.</td><td>BO</td><td>POST</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=addEventMgmtApplyCategory">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 알림톡 발송 처리</td><td align="center">이벤트 알림톡 발송 처리를 합니다. *알림톡/알림함 발송 : /api/common/v1/common/sendMessage</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveEventMgmtAlimTalkSendRequest">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 진행중인 상품확인</td><td align="center">이벤트 진행중인 상품확인을 합니다. *상품 쪽에서 호출 중인 API</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=giftCheckInProgress">🔗API 확인하기 ></a></td></tr><tr><td align="center">테스트 그룹관리 목록 조회</td><td align="center">테스트 그룹관리 – 그리드 목록을 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getTestGrpInfoMgmtList">🔗API 확인하기 ></a></td></tr><tr><td align="center">테스트 그룹관리 목록 수 조회</td><td align="center">테스트 그룹관리 – 그리드 목록 수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getTestGrpInfoMgmtList">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 최상단 여부</td><td align="center">이벤트 최상단 여부 체크를 합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventUprFixCnt">🔗API 확인하기 ></a></td></tr><tr><td align="center">발송내역 목록 조회</td><td align="center">발송내역 목록을 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventSendList">🔗API 확인하기 ></a></td></tr><tr><td align="center">발송내역 목록 수 조회</td><td align="center">발송내역 목록 수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventSendListCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트대상자 정보 목록 조회</td><td align="center">이벤트 이벤트대상자 정보 목록을 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventPayMgmtTrgmnInfoList">🔗API 확인하기 ></a></td></tr><tr><td align="center">지급관리 조회 목록 엑셀 다운로드</td><td align="center">지급관리 조회 목록 엑셀 다운로드를 합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventPayMgmtTrgmnInfoListExcelDownload">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트대상자 정보 목록 수 조회</td><td align="center">이벤트 이벤트대상자 정보 목록 수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventPayMgmtTrgmnInfoListCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 응모관리 목록 조회</td><td align="center">이벤트 응모관리 – 그리드 목록을 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventMgmtTrgmnInfoList">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 응모관리 목록 수 조회</td><td align="center">이벤트 응모관리 – 그리드 목록 수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventMgmtTrgmnInfoListCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트대상자 목록 조회- 메일</td><td align="center">이벤트 이벤트대상자 정보 목록 조회합니다 - 메일</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventMgmtSendWinnerInfoList">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트 대상자 목록 수 조회 - 메일</td><td align="center">이벤트 이벤트대상자 정보 목록 수를 조회합니다. - 메일</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventMgmtSendWinnerInfoListCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 적용범위 사이트 목록 조회</td><td align="center">이벤트 적용범위 사이트 목록을 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventMgmtApplySiteList">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 적용범위 카테고리 목록 수 조회</td><td align="center">이벤트 적용범위 사이트 목록 수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventMgmtApplySiteListCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트대상자 정보 당첨자 수 조회</td><td align="center">이벤트 이벤트대상자 정보 당첨자 수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventLotMgmtWinnerMbrCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트대상자 정보 대기자 당첨자 수 조회</td><td align="center">이벤트 이벤트대상자 정보 대기자 => 당첨자 수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventLotMgmtWaitWinnerMbrCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트대상자 대기자 수 조회</td><td align="center">이벤트 이벤트대상자 정보 대기자 수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventLotMgmtWaitWinnerMbrCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 추첨관리 목록 조회</td><td align="center">이벤트 추첨관리 – 그리드 목록을 조회한다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventLotMgmtTrgmnInfoList">🔗API 확인하기 ></a></td></tr><tr><td align="center">추첨관리 조회 목록 엑셀다운로드</td><td align="center">추첨관리 조회 목록 엑셀 다운로드를 합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventLotMgmtTrgmnInfoListExcelDownload">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 추첨관리 목록 수 조회</td><td align="center">이벤트 추첨관리 – 목록 수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventLotMgmtTrgmnInfoListCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트대상자정보 선정결과 목록 조회</td><td align="center">이벤트 이벤트대상자 정보 선정결과 – 그리드 목록을 조회한다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventLotMgmtCcTrgmnInfoSelectedResultList">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트대상자 정보 선정결과 목록 수 조회</td><td align="center">이벤트 이벤트대상자 정보 선정결과 – 그리드 목록 수를 조회한다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventLotMgmtCcTrgmnInfoSelectedResultListCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트대상자정보 추첨결과 목록 조회</td><td align="center">이벤트 이벤트대상자 정보 추첨결과 – 그리드 목록을 조회한다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventLotMgmtCcTrgmnInfoLotResultList">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 이벤트대상자정보 추첨결과 목록 수 조회</td><td align="center">이벤트 이벤트대상자 정보 추첨결과 – 그리드 목록 수를 조회한다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventLotMgmtCcTrgmnInfoLotResultListCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 관리 목록 조회</td><td align="center">이벤트 정보 관리 – 그리드 목록을 조회한다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventList">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 관리 목록 수 조회</td><td align="center">이벤트 정보 관리 – 그리드 목록 수를 조회한다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventListCount">🔗API 확인하기 ></a></td></tr><tr><td align="center">응모관리 조회 목록 엑셀다운로드</td><td align="center">응모관리 조회 목록 엑셀 다운로드를 합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getEventAplctMgmtTrgmnInfoListExcelDownload">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 번호 생성</td><td align="center">이벤트 번호를 생성합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getCreateEvtNo">🔗API 확인하기 ></a></td></tr><tr><td align="center">응모관리 조회 탭 목록 엑셀 다운로드</td><td align="center">응모관리 조회 탭 – 목록 엑셀 다운로드를 합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=excelDownTrgmnList">🔗API 확인하기 ></a></td></tr><tr><td align="center">지급관리 조회 탭 목록 엑셀 다운로드</td><td align="center">지급관리 조회 탭 – 목록 엑셀 다운로드를 합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=excelDownPayList">🔗API 확인하기 ></a></td></tr><tr><td align="center">추첨관리 조회 탭 목록 엑셀 다운로드</td><td align="center">추첨관리 조회 탭 – 목록 엑셀 다운로드를 합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=excelDownLotList">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 응모이력 조회</td><td align="center">이벤트 응모이력을 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%9D%91%EB%AA%A8%EC%9D%B4%EB%A0%A5&#x26;path=getEventApplicationHistoryList">🔗API 확인하기 ></a></td></tr><tr><td align="center">이벤트 응모이력 건수 조회</td><td align="center">이벤트 응모이력 건 수를 조회합니다.</td><td>BO</td><td>GET</td><td align="center"><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%9D%91%EB%AA%A8%EC%9D%B4%EB%A0%A5&#x26;path=getEventApplicationHistoryList">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="197.333251953125" align="center">명칭</th><th align="center">설명</th><th data-hidden align="center">비고</th></tr></thead><tbody><tr><td align="center">전시기간</td><td align="center">이벤트가 이벤트 목록에서 전시되는 기간.</td><td align="center"></td></tr><tr><td align="center">응모기간(행사기간)</td><td align="center">응모 되는 기간</td><td align="center"></td></tr><tr><td align="center">구매기간</td><td align="center">지정된 상품을 구매하는 기간</td><td align="center"></td></tr><tr><td align="center">추첨이벤트</td><td align="center">추첨을 통해서 당첨자가 정해지는 이벤트</td><td align="center"></td></tr><tr><td align="center">비추첨이벤트</td><td align="center">추첨이 아닌 즉시지급, 또는 리워드 없는 이벤트</td><td align="center"></td></tr><tr><td align="center">리워드</td><td align="center">이벤트 당첨 시, 제공하는 혜택 정보( 사은품, 경품, 마일리지, 쿠폰 )입니다</td><td align="center"></td></tr><tr><td align="center">제세공과금</td><td align="center">회원에게 경품 및 마일리지 금액의 22%를 부과하는 공적부담금</td><td align="center"></td></tr></tbody></table>

## 기타 참고사항

* 이벤트 등록 - 유형별 추가 영역
* 추첨이벤트(단순클릭응모, 구매자추첨, 룰렛, 설문, 댓글)와 비추첨이벤트(출석체크, 구매사은, 쿠폰다운로드, 기타\[HTML])로 구분됩니다.
* 리워드 지급 프로세스
  * 구매 사은: 지급요청 → 사은품 배송관리 데이터 연동 → 송장번호 등록 → 배송완료 처리
  * 추첨 이벤트: 알림톡/메일 → 제세공과금 입금여부=Y → 지급요청 → 수기발송 처리
  * 쿠폰다운로드 및 룰렛: 당첨 즉시 발급 처리
* 리워드 별 당첨자 알림 발송
  * 경품: 알림톡/알림함/메일
  * 마일리지: 알림톡/알림함
  * 쿠폰: 알림함
* 알림별 발송 시점
  * 경품은 \[알림톡/메일] 버튼 클릭 시 알림톡/알림함/메일로 알림 발송
  * 마일리지는 \[마일리지 지급 요청] 버튼 클릭 시 알림톡/알림함으로 알림 발송
  * 쿠폰은 \[쿠폰지급 요청] 버튼 클릭 시 알림함으로 알림 발송
* **이벤트 유형 별 등록가능 리워드**

|             | 이벤트종류  | 사은품 | 경품 | 마일리지 | 쿠폰 |
| :---------: | ------ | --- | -- | ---- | -- |
|  **추첨 이벤트** | 룰렛     | -   | -  | ✔    | ✔  |
|             | 단순클릭응모 | -   | ✔  | ✔    | ✔  |
|             | 설문     | -   | ✔  | ✔    | ✔  |
|             | 댓글     | -   | ✔  | ✔    | ✔  |
|             | 구매자추첨  | -   | ✔  | ✔    | ✔  |
| **비추첨 이벤트** | 구매사은   | ✔︎  | ✔︎ | ✔    | ✔  |
|             | 출석체크   | -   | -  | ✔    | -  |
|             | 쿠폰다운로드 | -   | -  | -    | ✔  |
|             | 기타     | -   | -  | -    | -  |