> 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/store-front/promotion/undefined-4.md).

# 사은행사

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

***

## 주요 기능

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

## 기타 참고사항

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

##