> 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/api-guides-en/store-front/event/event-entry.md).

# Event Entry

Provides the feature for a logged-in member to register an entry by clicking the Enter button on the corresponding event's detail page. Event types are divided into drawing events (simple click entry, purchaser drawing, roulette, survey, comments) and non-drawing events (attendance check, purchase gift, coupon download, other \[HTML]).

***

## Key Features

* **Event entry**
  * Provides the entry feature for all events except other \[HTML].
  * For comment events, a written comment can be edited/deleted.
* **Entry check**
  * Performs basic entry checks.
  * Checks whether the event exists, the eligible entry grade, whether the user is logged in, and so on.
  * Performs entry count limit checks (once per day or once per event period).
  * Checks whether the member is synchronized between the orderDB and the eventDB.
  * Performs entry period checks and type-specific condition checks.
  * For purchaser drawing and purchase gift, checks the order amount.
  * For coupon download, checks the coupon quantity.
* **Processing upon entry completion**
  * For non-drawing events (attendance check, coupon download, roulette), the prize or mileage is granted immediately upon a winning entry.
  * For purchase gift or purchaser drawing, the entry count is set to once per event period.
* **Comment editing and deletion**
  * For comment events, a member can edit and delete their own comments.
  * Login is required, and comments other than one's own cannot be edited or deleted.
  * When a comment is deleted, the entry history is also removed.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FTptQtC3BXW4YRQFJpRo5%2F%E1%84%8B%E1%85%B5%E1%84%87%E1%85%A6%E1%86%AB%E1%84%90%E1%85%B3%E1%84%8B%E1%85%B3%E1%86%BC%E1%84%86%E1%85%A9.png?alt=media&#x26;token=58a16153-0a22-4d62-ad5d-49516df9bbaa" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Entering

When a member enters an event, if logged in, the process moves to the entry check logic; if not logged in, the member is redirected to the login page.
{% endstep %}

{% step %}

### Edit/delete comment

A feature for editing/deleting a comment the member has written. Login is required, and only the member's own comments can be edited/deleted. When a comment is deleted, the entry history is also deleted.
{% endstep %}

{% step %}

### Entry check

Performs verification of basic event information and type-specific check logic. If a check fails, an alert for that item is displayed.
{% endstep %}

{% step %}

### Entry logic verification

For drawing events (excluding roulette), the member is classified as an entrant. For roulette, attendance check, and coupon download, the reward is granted immediately at the moment of entry, so the member is classified as a winner.
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="112.333251953125">API</th><th width="243.5555419921875">Description</th><th width="93.3333740234375">Server</th><th width="89">Method</th><th>Notes</th></tr></thead><tbody><tr><td>Event entry processing</td><td>A logged-in member enters by clicking the Enter button on the event detail page.</td><td>Event</td><td>POST</td><td><p><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%9D%91%EB%AA%A8&#x26;path=registerEvent">🔗View API ></a></p><p>Order information inquiry: /api/order/v1/event/evtOrdList<br>Coupon issuance: /api/order/v1/marketing/cpnDown<br>Mileage accrual: /api/member/v1/mileage/mlgSaveUse</p></td></tr><tr><td>Edit event comment</td><td>Edits the logged-in member's own comment.</td><td>Event</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%9D%91%EB%AA%A8&#x26;path=updateEventEntryReply">🔗View API ></a></td></tr><tr><td>Delete event comment</td><td>Deletes a comment written by the logged-in member.</td><td>Event</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%9D%91%EB%AA%A8&#x26;path=deleteEventEntryReply">🔗View API ></a></td></tr></tbody></table>

## Term Definitions

<table><thead><tr><th width="165.111083984375">Term</th><th>Description</th><th data-hidden>Notes</th></tr></thead><tbody><tr><td>Display period​</td><td>Refers to the period during which the event is displayed in the event list.​ Events whose display period has ended cannot be accessed in detail.​</td><td></td></tr><tr><td>Entry period (event period)​</td><td>Refers to the period during which entry is possible after clicking the Enter button on the event detail screen.​</td><td></td></tr><tr><td>Purchase period​</td><td>Refers to the period during which products applicable to the event can be purchased.​</td><td></td></tr><tr><td>Drawing event​</td><td>Refers to an event in which companies select winners through a drawing to provide consumers with various items such as gifts, mileage, and coupons​</td><td></td></tr><tr><td>Non-drawing event​</td><td>Refers to an event in which benefits (coupons, mileage) are granted when participants meet certain conditions or perform a specific activity.​<br>(Immediate payout rather than a drawing — attendance, purchase gift, etc.)​</td><td></td></tr><tr><td>Event reward​</td><td>Represents the compensation or benefit given to people who participate in the event. ​<br>Benefit information provided upon winning an event includes gifts, prizes, mileage, coupons, and so on.​</td><td></td></tr></tbody></table>

## Other Notes

* **Rewards by event type**
  * Simple click / purchaser drawing / survey / comments: prize / mileage / coupon
  * Roulette: mileage / coupon
  * Attendance check: mileage
  * Purchase gift: gift / prize / mileage / coupon
  * Coupon download: coupon<br>
* **Event details and additional items**
  * Attendance check: round information (aply\_Rnk) – CC\_EVT\_DETL\_ITEM
  * Roulette: roulette probability (rolt\_prbl) – CC\_EVT\_DETL\_ITEM -> the sum of roulette probabilities must not exceed 100, and each probability must be greater than 0.
  * Survey: question type code (EV017) – \[multiple choice: 10], \[multiple choice (other): 20], \[multiple choice (image): 30], \[short answer: 40], \[scale: 50] -> question content is required.\
    -> When logged in, retrieves the question answer content (QUEST\_ANS\_CONT) or answer number (ANS\_NO).\
    \> CC\_EVT\_QUEST\_INFO: event question information\
    \> CC\_EVT\_QUEST\_ANS\_INFO: event question answer information
* Upon event entry, the entry history can be checked in the CC\_EVT\_TRGMN\_INFO table.
* Upon event entry, the type-specific check logic and entry logic are invoked according to the value corresponding to common code EV002 (event mid-category code) to process the entry.
* To prevent simultaneous entries on MO and PC from the same account, Redis-CacheManager is used to allow entries at 0.03-second intervals.