> 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-11.md).

# 프로모션 검증

## 프로모션 정보 검증

> \## 기능설명\
> \* 주문 생성시 사용자가 선택/사용한 프로모션 정보가 실제로 사용 가능한지 검증합니다.\
> \---\
> \## 상세설명\
> \* \*\*비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.\*\*\
> \* \*\*사용자가 선택한 정보\*\*를 기반으로 \*\*다시 한번 계산/검증\*\* 하여 계산 결과가 동일한지 비교합니다.\
> \* 만약, \*\*결과가 다른 경우에는 주문을 생성할 수 없습니다.\*\*\
> \* 검증내용\
>   \* 할인정보\
>   \* 배송비쿠폰정보\
>   \* 사은행사 정보\
>   \* 적립 정보\
> \---\
> \## 수정번호\
> \* Release v1.03\_231106: 임직원 할인 한도 관리 추가<br>

```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/validatePromotionInfo":{"post":{"tags":["프로모션 검증"],"summary":"프로모션 정보 검증","description":"## 기능설명\n* 주문 생성시 사용자가 선택/사용한 프로모션 정보가 실제로 사용 가능한지 검증합니다.\n---\n## 상세설명\n* **비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.**\n* **사용자가 선택한 정보**를 기반으로 **다시 한번 계산/검증** 하여 계산 결과가 동일한지 비교합니다.\n* 만약, **결과가 다른 경우에는 주문을 생성할 수 없습니다.**\n* 검증내용\n  * 할인정보\n  * 배송비쿠폰정보\n  * 사은행사 정보\n  * 적립 정보\n---\n## 수정번호\n* Release v1.03_231106: 임직원 할인 한도 관리 추가\n","operationId":"doValidatePromotion","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromotionOrderValidationRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"boolean"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PromotionOrderValidationRequest":{"required":["baseDtm","comGbCd","goodsList","mbrGradeCd","mbrNo","ordMediaCd","stafYn"],"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrGradeCd":{"type":"string","description":"회원등급코드(ME008)\n 10 : GREEN\n, 20 : FAMILY\n, 30 : GOLD\n, 40 : VIP\n, 50 : VVIP\n","enum":["10","20","30","40","50"]},"comGbCd":{"type":"string","description":"회사구분코드(ME038)"},"stafYn":{"type":"string","description":"임직원여부"},"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"},"goodsList":{"type":"array","description":"주문 상품정보","items":{"$ref":"#/components/schemas/PromotionGoodsBase"}},"bnfResponse":{"$ref":"#/components/schemas/BenefitResponse"},"dlvResponse":{"$ref":"#/components/schemas/PromotionDeliGrpValidationRequest"},"accmResponse":{"$ref":"#/components/schemas/AccmResponse"},"aeEvtListResponse":{"type":"array","description":"선택된 사은행사 정보","items":{"$ref":"#/components/schemas/AeEvtInfo"}}},"description":"프로모션 주문 생성 검증 Request"},"PromotionGoodsBase":{"required":["brandNo","chlNo","cnt","dispCtgNo","entrNo","goodsNo","itmNo","marketingDisplayNo","salePrc","stdCtgNo","supPcost"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"supPcost":{"type":"integer","description":"공급원가","format":"int64"},"salePrc":{"type":"integer","description":"판매가(1차할인)","format":"int64"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"brandNo":{"type":"string","description":"브랜드번호"},"entrNo":{"type":"string","description":"협력사번호"},"chlNo":{"type":"string","description":"채널번호"},"marketingDisplayNo":{"type":"string","description":"기획전번호"},"cnt":{"type":"integer","description":"수량","format":"int32"}},"description":"주문 상품정보"},"BenefitResponse":{"required":["goodsBenefitList","orderBenefitList","totalDcAmt"],"type":"object","properties":{"totalDcAmt":{"type":"integer","description":"전체할인금액","format":"int64"},"goodsBenefitList":{"type":"array","description":"상품혜택정보 리스트","nullable":true,"items":{"$ref":"#/components/schemas/GoodsBenefitResponse"}},"orderBenefitList":{"type":"array","description":"주문혜택정보 리스트","nullable":true,"items":{"$ref":"#/components/schemas/BenefitOrderPromotionInfo"}}},"description":"쿠폰혜택조회 Response"},"GoodsBenefitResponse":{"required":["benefitList","dcAmt","goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"dcAmt":{"type":"integer","description":"전체할인금액","format":"int64"},"benefitList":{"type":"array","description":"혜택정보리스트","items":{"$ref":"#/components/schemas/OrderPromotionInfo"}}},"description":"상품혜택정보","nullable":true},"OrderPromotionInfo":{"required":["dcAmt","dcAmtPerCnt","entrChrgRate","fixamtFxrtGbCd","ourChrgRate","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"자사분담률","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담률","format":"int32"},"fixamtFxrtGbCd":{"type":"string","description":"정액정률구분코드","enum":["01","02"]},"dcRateAmt":{"type":"integer","description":"할인률/금액","format":"int64"},"minBuyAmt":{"type":"integer","description":"최소구매금액","format":"int64"},"maxDcAmt":{"type":"integer","description":"최대할인금액","format":"int64"},"isMaxYn":{"type":"string","description":"최대혜택여부"},"dcAmt":{"type":"integer","description":"할인금액","format":"int64"},"dcAmtPerCnt":{"type":"integer","description":"개수별할인금액","format":"int64"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"}},"description":"혜택정보리스트"},"BenefitOrderPromotionInfo":{"required":["dcAmt","entrChrgRate","fixamtFxrtGbCd","goods","ourChrgRate","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"자사분담률","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담률","format":"int32"},"fixamtFxrtGbCd":{"type":"string","description":"정액정률구분코드","enum":["01","02"]},"dcRateAmt":{"type":"integer","description":"할인률/금액","format":"int64"},"minBuyAmt":{"type":"integer","description":"최소구매금액","format":"int64"},"maxDcAmt":{"type":"integer","description":"최대할인금액","format":"int64"},"isMaxYn":{"type":"string","description":"최대혜택여부"},"dcAmt":{"type":"integer","description":"할인금액","format":"int64"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"goods":{"type":"array","description":"상품정보 리스트","items":{"$ref":"#/components/schemas/OrderBenefitGoodsInfo"}}},"description":"주문프로모션정보"},"OrderBenefitGoodsInfo":{"required":["dcAmt","goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"dcAmt":{"type":"integer","description":"할인금액","format":"int64"}},"description":"상품정보 리스트"},"PromotionDeliGrpValidationRequest":{"required":["deliNo","entrNo"],"type":"object","properties":{"deliNo":{"type":"string","description":"배송번호"},"entrNo":{"type":"string","description":"협력사번호"},"benefitInfo":{"$ref":"#/components/schemas/DlvBenefitInfo"}},"description":"선택된 배송비 쿠폰 정보"},"DlvBenefitInfo":{"required":["cpnIsuNo","entrChrgRate","ourChrgRate","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"자사분담률","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담률","format":"int32"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"ordCostGbCd":{"type":"string","description":"비용구분코드(OM043)"}},"description":"배송혜택정보","nullable":true},"AccmResponse":{"required":["accmList","totalAccmAmt"],"type":"object","properties":{"totalAccmAmt":{"type":"integer","description":"전체적립금액","format":"int64"},"accmList":{"type":"array","description":"적립 정보 리스트","items":{"$ref":"#/components/schemas/AccmPromotionInfo"}}},"description":"적립정보","nullable":true},"AccmPromotionInfo":{"required":["accmAmt","accmGbCd","accmRate","fixamtFxrtGbCd","promoNm","promoNo"],"type":"object","properties":{"accmGbCd":{"type":"string","description":"자산적립사용사유코드(ME020)\n 21 : 주문적립\n , 22 : 회원등급적립\n , 23 : 예약상품적립\n , 24 : 프로모션적립\n , 50 : 주문사용\n , 58 : 배송비사용\n , 29 : 환불적립\n","enum":["21","22","23","24","50","58","29"]},"accmRate":{"type":"number","description":"적립율","format":"double"},"accmAmt":{"type":"integer","description":"적립금액","format":"int64"},"promoNo":{"type":"string","description":"프로모션 번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션유형","nullable":true,"enum":["40"]},"ourChrgRate":{"type":"integer","description":"자사분담률","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담률","format":"int32"},"fixamtFxrtGbCd":{"type":"string","description":"정액정률구분코드"},"rsrvStdAmt":{"type":"integer","description":"적립기준금액","format":"int64"},"goodsAccmList":{"type":"array","description":"상품적립정보 리스트","items":{"$ref":"#/components/schemas/AccmInfo"}}},"description":"적립 정보 리스트"},"AccmInfo":{"required":["accmAmt","goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"accmAmt":{"type":"integer","description":"적립금액","format":"int64"}},"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"}}}}
```