> 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/store-front-api/order-api/undefined-14.md).
# 프로모션 사은행사
## 사은행사 적용가능여부 확인
> \## 기능설명\
> \* 선택한 사은행사가 실제 사용 가능한 사은행사인지 확인합니다.\
> \---\
> \## 상세설명\
> \* \*\*비회원은 해당 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"}}}}
```