# 프로모션 사은행사
## 사은행사 적용가능여부 확인
> \## 기능설명\
> \* 선택한 사은행사가 실제 사용 가능한 사은행사인지 확인합니다.\
> \---\
> \## 상세설명\
> \* \*\*비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.\*\*\
> \* 선택한 사은행사가 실제 적용조건에 부합하는지 체크합니다.\
> \* 현재 구매한 상품에 혜택을 적용한 금액이 선택한 사은행사의 금액 조건에 부합하는지 체크합니다.\
> \---\
> \## 특이사항\
> \### 연관된 API 목록\
> \* 단품 상세조회:\
> \ href=" 관리/seltOrderItmInfo">\
> /api/goods/v1/detail/goods\
> \\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.06\_231218\`\`\` : 사은행사 중복 조회 수정
````json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/marketing/orderAeEvtList":{"post":{"tags":["프로모션 사은행사"],"summary":"사은행사 적용가능여부 확인","description":"## 기능설명\n* 선택한 사은행사가 실제 사용 가능한 사은행사인지 확인합니다.\n---\n## 상세설명\n* **비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.**\n* 선택한 사은행사가 실제 적용조건에 부합하는지 체크합니다.\n* 현재 구매한 상품에 혜택을 적용한 금액이 선택한 사은행사의 금액 조건에 부합하는지 체크합니다.\n---\n## 특이사항\n### 연관된 API 목록\n* 단품 상세조회:\n\n/api/goods/v1/detail/goods\n\n---\n## 수정번호\n* ```Release v1.06_231218``` : 사은행사 중복 조회 수정\n","operationId":"getOrderAeEvtList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderAeEvtRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AeResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrderAeEvtRequest":{"required":["ordMediaCd"],"type":"object","properties":{"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"baseDtm":{"type":"string","description":"기준일시","format":"date-time"},"goodsInfo":{"type":"array","description":"상품 리스트","items":{"$ref":"#/components/schemas/OrderAeGoodsRequest"}}},"description":"사은행사 선택 Request"},"OrderAeGoodsRequest":{"required":["goodsNo","itmNo","salePrc"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"salePrc":{"type":"integer","description":"판매가(1차할인)","format":"int64"},"cnt":{"type":"integer","description":"수량","format":"int32"},"aeNo":{"type":"string","description":"사은행사번호"},"aeGoodsNo":{"type":"string","description":"사은품번호"},"aeGoodsItmNo":{"type":"string","description":"사은품단품번호"}},"description":"상품 리스트"},"AeResponse":{"type":"object","properties":{"aeEvtList":{"type":"array","description":"사용 가능한 사은행사 리스트","items":{"$ref":"#/components/schemas/AeEvtInfo"}}}},"AeEvtInfo":{"required":["addEvtTypCd","aeDesc","aeEndDtm","aeGoodsList","aeNm","aeNo","aeStrDtm","goodsNo","itmNo","tmEvtYn"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"aeNo":{"type":"string","description":"사은행사번호"},"addEvtTypCd":{"type":"string","description":"사은행사 유형 코드(MK012)\n 10 : 구매금액사은품\n , 20 : 상품사은품\n","enum":["10","20"]},"aeStrDtm":{"type":"string","description":"사은행사시작일시","format":"date-time"},"aeEndDtm":{"type":"string","description":"사은행사종료일시","format":"date-time"},"payStrDt":{"type":"string","description":"지급시작일자"},"payEndDt":{"type":"string","description":"지급종료일자"},"tmEvtYn":{"type":"string","description":"타임행사여부","nullable":true},"aplyStrTm":{"type":"string","description":"적용시작시간","nullable":true},"aplyEndTm":{"type":"string","description":"적용종료시간","nullable":true},"aeDesc":{"type":"string","description":"사은행사설명"},"aeNm":{"type":"string","description":"사은행사명"},"aeGoodsList":{"type":"array","description":"사은품리스트","items":{"$ref":"#/components/schemas/AeFvrInfo"}}},"description":"사은행사정보","nullable":true},"AeFvrInfo":{"required":["aeFvrSeq","aeGoodsNm","aeGoodsNo","aplyMaxAmt","aplyMinAmt"],"type":"object","properties":{"aeFvrSeq":{"type":"string","description":"사은행사순번"},"aplyMinAmt":{"type":"integer","description":"적용최소금액","format":"int64"},"aplyMaxAmt":{"type":"integer","description":"적용최대금액","format":"int64"},"aeGoodsNm":{"type":"string","description":"사은품상품명"},"aeGoodsNo":{"type":"string","description":"사은품상품번호"},"aeGoodsItmNo":{"type":"string","description":"사은품단품번호"},"aeGoodsImgPath":{"type":"string","description":"사은품이미지경로"}},"description":"사은품리스트"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
````
## 주문서 사은행사 조회
> \## 기능설명\
> \* 현재 주문에서 선택할 수 있는 사은행사 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.\*\*\
> \* 여러 상품에 \*\*동일한 사은행사가 적용이 가능하다면, 하나의 상품에만 적용\*\*됩니다.\
> \* 상품을 선택하는 기준은 아래와 같습니다.\
> \* 판매가 : 내림차순\
> \* 상품번호 : 올림차순\
> \* 단품번호 : 올림차순
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/marketing/chooseAeEvtList":{"post":{"tags":["프로모션 사은행사"],"summary":"주문서 사은행사 조회","description":"## 기능설명\n* 현재 주문에서 선택할 수 있는 사은행사 목록을 조회합니다.\n---\n## 상세설명\n* **비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.**\n* 여러 상품에 **동일한 사은행사가 적용이 가능하다면, 하나의 상품에만 적용**됩니다.\n* 상품을 선택하는 기준은 아래와 같습니다.\n * 판매가 : 내림차순\n * 상품번호 : 올림차순\n * 단품번호 : 올림차순\n","operationId":"getAeEvtList_1","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderAeEvtRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AeResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrderAeEvtRequest":{"required":["ordMediaCd"],"type":"object","properties":{"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"baseDtm":{"type":"string","description":"기준일시","format":"date-time"},"goodsInfo":{"type":"array","description":"상품 리스트","items":{"$ref":"#/components/schemas/OrderAeGoodsRequest"}}},"description":"사은행사 선택 Request"},"OrderAeGoodsRequest":{"required":["goodsNo","itmNo","salePrc"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"salePrc":{"type":"integer","description":"판매가(1차할인)","format":"int64"},"cnt":{"type":"integer","description":"수량","format":"int32"},"aeNo":{"type":"string","description":"사은행사번호"},"aeGoodsNo":{"type":"string","description":"사은품번호"},"aeGoodsItmNo":{"type":"string","description":"사은품단품번호"}},"description":"상품 리스트"},"AeResponse":{"type":"object","properties":{"aeEvtList":{"type":"array","description":"사용 가능한 사은행사 리스트","items":{"$ref":"#/components/schemas/AeEvtInfo"}}}},"AeEvtInfo":{"required":["addEvtTypCd","aeDesc","aeEndDtm","aeGoodsList","aeNm","aeNo","aeStrDtm","goodsNo","itmNo","tmEvtYn"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"aeNo":{"type":"string","description":"사은행사번호"},"addEvtTypCd":{"type":"string","description":"사은행사 유형 코드(MK012)\n 10 : 구매금액사은품\n , 20 : 상품사은품\n","enum":["10","20"]},"aeStrDtm":{"type":"string","description":"사은행사시작일시","format":"date-time"},"aeEndDtm":{"type":"string","description":"사은행사종료일시","format":"date-time"},"payStrDt":{"type":"string","description":"지급시작일자"},"payEndDt":{"type":"string","description":"지급종료일자"},"tmEvtYn":{"type":"string","description":"타임행사여부","nullable":true},"aplyStrTm":{"type":"string","description":"적용시작시간","nullable":true},"aplyEndTm":{"type":"string","description":"적용종료시간","nullable":true},"aeDesc":{"type":"string","description":"사은행사설명"},"aeNm":{"type":"string","description":"사은행사명"},"aeGoodsList":{"type":"array","description":"사은품리스트","items":{"$ref":"#/components/schemas/AeFvrInfo"}}},"description":"사은행사정보","nullable":true},"AeFvrInfo":{"required":["aeFvrSeq","aeGoodsNm","aeGoodsNo","aplyMaxAmt","aplyMinAmt"],"type":"object","properties":{"aeFvrSeq":{"type":"string","description":"사은행사순번"},"aplyMinAmt":{"type":"integer","description":"적용최소금액","format":"int64"},"aplyMaxAmt":{"type":"integer","description":"적용최대금액","format":"int64"},"aeGoodsNm":{"type":"string","description":"사은품상품명"},"aeGoodsNo":{"type":"string","description":"사은품상품번호"},"aeGoodsItmNo":{"type":"string","description":"사은품단품번호"},"aeGoodsImgPath":{"type":"string","description":"사은품이미지경로"}},"description":"사은품리스트"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 상품상세 사은행사 조회
> \## 기능설명\
> \* 상품 상세에서 사용가능한 사은행사 리스트를 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.\*\*\
> \* 상품에 선택 가능한 사은행사 정보를 조회합니다.\
> \* 선택 가능한 사은행사 중 사은품이 아래 조건에 맞는 사은행사만 조회됩니다.\
> \* 재고 : 존재\
> \* 사은품 상태 : 판매중\
> \* 배송유형 : 합배송
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/marketing/aeEvtList":{"post":{"tags":["프로모션 사은행사"],"summary":"상품상세 사은행사 조회","description":"## 기능설명\n* 상품 상세에서 사용가능한 사은행사 리스트를 조회합니다.\n---\n## 상세설명\n* **비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.**\n* 상품에 선택 가능한 사은행사 정보를 조회합니다.\n* 선택 가능한 사은행사 중 사은품이 아래 조건에 맞는 사은행사만 조회됩니다.\n * 재고 : 존재\n * 사은품 상태 : 판매중\n * 배송유형 : 합배송\n","operationId":"getAeEvtList_2","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderAeEvtRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/AeEvtInfo"}}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrderAeEvtRequest":{"required":["ordMediaCd"],"type":"object","properties":{"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"baseDtm":{"type":"string","description":"기준일시","format":"date-time"},"goodsInfo":{"type":"array","description":"상품 리스트","items":{"$ref":"#/components/schemas/OrderAeGoodsRequest"}}},"description":"사은행사 선택 Request"},"OrderAeGoodsRequest":{"required":["goodsNo","itmNo","salePrc"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"salePrc":{"type":"integer","description":"판매가(1차할인)","format":"int64"},"cnt":{"type":"integer","description":"수량","format":"int32"},"aeNo":{"type":"string","description":"사은행사번호"},"aeGoodsNo":{"type":"string","description":"사은품번호"},"aeGoodsItmNo":{"type":"string","description":"사은품단품번호"}},"description":"상품 리스트"},"AeEvtInfo":{"required":["addEvtTypCd","aeDesc","aeEndDtm","aeGoodsList","aeNm","aeNo","aeStrDtm","goodsNo","itmNo","tmEvtYn"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"aeNo":{"type":"string","description":"사은행사번호"},"addEvtTypCd":{"type":"string","description":"사은행사 유형 코드(MK012)\n 10 : 구매금액사은품\n , 20 : 상품사은품\n","enum":["10","20"]},"aeStrDtm":{"type":"string","description":"사은행사시작일시","format":"date-time"},"aeEndDtm":{"type":"string","description":"사은행사종료일시","format":"date-time"},"payStrDt":{"type":"string","description":"지급시작일자"},"payEndDt":{"type":"string","description":"지급종료일자"},"tmEvtYn":{"type":"string","description":"타임행사여부","nullable":true},"aplyStrTm":{"type":"string","description":"적용시작시간","nullable":true},"aplyEndTm":{"type":"string","description":"적용종료시간","nullable":true},"aeDesc":{"type":"string","description":"사은행사설명"},"aeNm":{"type":"string","description":"사은행사명"},"aeGoodsList":{"type":"array","description":"사은품리스트","items":{"$ref":"#/components/schemas/AeFvrInfo"}}},"description":"사은행사정보","nullable":true},"AeFvrInfo":{"required":["aeFvrSeq","aeGoodsNm","aeGoodsNo","aplyMaxAmt","aplyMinAmt"],"type":"object","properties":{"aeFvrSeq":{"type":"string","description":"사은행사순번"},"aplyMinAmt":{"type":"integer","description":"적용최소금액","format":"int64"},"aplyMaxAmt":{"type":"integer","description":"적용최대금액","format":"int64"},"aeGoodsNm":{"type":"string","description":"사은품상품명"},"aeGoodsNo":{"type":"string","description":"사은품상품번호"},"aeGoodsItmNo":{"type":"string","description":"사은품단품번호"},"aeGoodsImgPath":{"type":"string","description":"사은품이미지경로"}},"description":"사은품리스트"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
---
# 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/store-front-api/order-api/undefined-14.md?ask=
```
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.