# 사은행사

회원전용 프로모션은 쇼핑몰에서 회원을 대상으로 제공하는 증정 행사로, 상품 사은행사만 존재합니다. 이 프로모션은 구매한 상품의 금액이 사은행사의 최소금액 조건에 부합하면 적용됩니다.

***

## 주요 기능

* **사은행사 조회**
  * 상품상세나 주문서에 진입했을 때, 회원인 경우에만 선택 가능한 사은행사가 있는지 확인하고 조회합니다.
* **적용 우선순위**
  * 사은행사가 하나의 상품에만 적용되더라도, 여러 상품 중 금액이 가장 큰 상품에 사은행사가 매핑됩니다.
* **중복 적용 가능**
  * 하나의 상품에 여러 사은행사가 있는 경우 중복으로 선택이 가능합니다.
* **사은행사 계산 및 적용 여부 판단**
  * 사용자가 선택한 정보로 사은행사를 계산하고, 계산 결과와 사용자가 선택한 정보를 비교하여 적용 여부를 판단합니다.
* **행사 조회 API 호출**
  * 상품상세, 장바구니에서는 `/aeEvtList` API를 호출하여 선택 가능한 행사를 조회합니다.
  * 주문서에서는 `/chooseAeEvtList` API를 호출하여 선택 가능한 행사를 조회합니다.

## 프로세스 정의

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

{% stepper %}
{% step %}

### 상품 상세페이지

상품상세 페이지에서 해당 상품에 적용 가능한\
사은행사 목록을 조회 합니다.
{% endstep %}

{% step %}

### 장바구니

장바구니에 진입후 하단에 사은행사 상품의 목록확인 가능합니다.
{% endstep %}

{% step %}

### 주문서

주문서에 진입후 결제하기 클릭시 사은행사 선택팝업 노출이 되고, 선택하면 결제 진행이 가능합니다.
{% endstep %}

{% step %}

### 프로모션 사은행사 조회

⑤ 실제 사용 가능 사은행사 여부 확인 Validation 호출 전 공통 파라미터 여부 확인
{% endstep %}

{% step %}

### 적용 사은행사 여부 확인

해당 로직은 서비스 단위 검증 및 계산 로직으로, 기능개요 \[[프로모션 검증](broken://pages/911d66d84f51de7b10b0913837aabb5cf7189a57)] 중 ’프로세스 정의’를 참고 해 주세요.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="89.111083984375">API</th><th width="374.5555419921875">설명</th><th width="92.4444580078125">Server</th><th width="89.111083984375">메소드</th><th>비</th></tr></thead><tbody><tr><td>주문서 사은행사 조회</td><td>현재 주문에서 선택할 수 있는 사은행사 목록을 조회합니다. 여러 상품에 동일한 사은행사가 적용이 가능 하다면, 하나의 상품에만 적용 됩니다. 상품을 선택하는 기준은 아래와 같습니다. * 판매가 : 내림차순 * 상품번호 : 올림차순 * 단품번호 : 올림차순</td><td>Order</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=order&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EC%82%AC%EC%9D%80%ED%96%89%EC%82%AC&#x26;path=getAeEvtList_1">🔗API 확인하기></a></td></tr><tr><td>사은행사 적용가능여부 <br>확인</td><td>사은행사가 실제 사용 가능한 사은행사인지 확인합니다.<br>구매한 상품에 혜택을 적용한 금액이 선택한 사은행사의 금액 조건에 부합하는지 체크</td><td>Order</td><td>POST</td><td><p><a href="https://api.x2bee.com/content?msa=order&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EC%82%AC%EC%9D%80%ED%96%89%EC%82%AC&#x26;path=getOrderAeEvtList">🔗API 확인하기></a></p><p>사은품 정보조회: /API/goods/v1/detail/goods</p></td></tr><tr><td>상품상세 사은행사 조회</td><td>상품 상세 진입 시 사용 가능한 사은행사 리스트를 조회합니다.</td><td>Order</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=order&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EC%82%AC%EC%9D%80%ED%96%89%EC%82%AC&#x26;path=getAeEvtList_2">🔗API 확인하기></a></td></tr></tbody></table>

## 기타 참고사항

* 사은행사 정책
  * 프로모션 사은행사는 상품 사은행사만 존재
  * 상품 개당 판매가를 기준으로 금액 허들을 체크합니다
  * 상품 사은행사의 경우 합포장 배송인 상품만 등록/사용이 가능합니다.
  * 사은행사의 사은품이 재고가 부족한 경우에는 미노출이 됩니다.
  * 하나의 사은행가사 여러 개의 상품에 적용이 가능해도 판매가가 가장 큰 상품에 적용합니다.

##


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api-guide/store-front/promotion/undefined-4.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.