> 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/api-en/store-front-api-reference/order-api/promotion-validation.md). # Promotion Validation ## Validate Promotion Information > \## Function Description\ > \* Validates whether the promotion information selected/used by the user when creating an order is actually usable.\ > \---\ > \## Detailed Description\ > \* \*\*This is a member-only API; non-members cannot use it.\*\*\ > \* Recalculates/re-validates based on \*\*the information selected by the user\*\* and compares whether the calculation result matches.\ > \* \*\*If the result differs, the order cannot be created.\*\*\ > \* Validation content\ > \* Discount information\ > \* Delivery fee coupon information\ > \* Gift event information\ > \* Accrual information\ > \---\ > \## Revision History\ > \* Release v1.03\_231106: Added employee discount limit management
```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":["Promotion Validation"],"summary":"Validate Promotion Information","description":"## Function Description\n* Validates whether the promotion information selected/used by the user when creating an order is actually usable.\n---\n## Detailed Description\n* **This is a member-only API; non-members cannot use it.**\n* Recalculates/re-validates based on **the information selected by the user** and compares whether the calculation result matches.\n* **If the result differs, the order cannot be created.**\n* Validation content\n * Discount information\n * Delivery fee coupon information\n * Gift event information\n * Accrual information\n---\n## Revision History\n* Release v1.03_231106: Added employee discount limit management\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":"Success","content":{"*/*":{"schema":{"type":"boolean"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PromotionOrderValidationRequest":{"required":["baseDtm","comGbCd","goodsList","mbrGradeCd","mbrNo","ordMediaCd","stafYn"],"type":"object","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrGradeCd":{"type":"string","description":"Member Grade Code (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":"Company Classification Code (ME038)"},"stafYn":{"type":"string","description":"Employee Status"},"ordMediaCd":{"type":"string","description":"Order Channel Code (OM007)\n 10 : Phone Consultation (CC)\n, 20 : PC\n, 30 : Mobile Web\n, 40 : Android App\n, 50 : iOS App\n, 60 : Subscription Order\n","enum":["10","20","30","40","50","60"]},"baseDtm":{"type":"string","description":"Reference Date/Time","format":"date-time"},"goodsList":{"type":"array","description":"Order Product Information","items":{"$ref":"#/components/schemas/PromotionGoodsBase"}},"bnfResponse":{"$ref":"#/components/schemas/BenefitResponse"},"dlvResponse":{"$ref":"#/components/schemas/PromotionDeliGrpValidationRequest"},"accmResponse":{"$ref":"#/components/schemas/AccmResponse"},"aeEvtListResponse":{"type":"array","description":"Selected Gift Event Info","items":{"$ref":"#/components/schemas/AeEvtInfo"}}},"description":"Promotion Order Creation Validation Request"},"PromotionGoodsBase":{"required":["brandNo","chlNo","cnt","dispCtgNo","entrNo","goodsNo","itmNo","marketingDisplayNo","salePrc","stdCtgNo","supPcost"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"supPcost":{"type":"integer","description":"Supply Cost","format":"int64"},"salePrc":{"type":"integer","description":"Selling Price (1st Discount)","format":"int64"},"stdCtgNo":{"type":"string","description":"Standard Category No."},"dispCtgNo":{"type":"string","description":"Display Category No."},"brandNo":{"type":"string","description":"Brand No."},"entrNo":{"type":"string","description":"Vendor No."},"chlNo":{"type":"string","description":"Channel No."},"marketingDisplayNo":{"type":"string","description":"Special Exhibition No."},"cnt":{"type":"integer","description":"Quantity","format":"int32"}},"description":"Order Product Information"},"BenefitResponse":{"required":["goodsBenefitList","orderBenefitList","totalDcAmt"],"type":"object","properties":{"totalDcAmt":{"type":"integer","description":"Total Discount Amount","format":"int64"},"goodsBenefitList":{"type":"array","description":"Product Benefit Information List","nullable":true,"items":{"$ref":"#/components/schemas/GoodsBenefitResponse"}},"orderBenefitList":{"type":"array","description":"Order Benefit Information List","nullable":true,"items":{"$ref":"#/components/schemas/BenefitOrderPromotionInfo"}}},"description":"Search Coupon Benefit Response"},"GoodsBenefitResponse":{"required":["benefitList","dcAmt","goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"dcAmt":{"type":"integer","description":"Total Discount Amount","format":"int64"},"benefitList":{"type":"array","description":"Benefit Information List","items":{"$ref":"#/components/schemas/OrderPromotionInfo"}}},"description":"Product Benefit Information","nullable":true},"OrderPromotionInfo":{"required":["dcAmt","dcAmtPerCnt","entrChrgRate","fixamtFxrtGbCd","ourChrgRate","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name"},"promoTypCd":{"type":"string","description":"Promotion Type Code (MK002)\n 11 : Product Discount Coupon\n , 12 : Cart Coupon\n , 13 : Stackable Discount Coupon\n , 14 : Free Shipping Coupon\n , 15 : Free Return Coupon\n , 20 : Employee Discount\n , 21 : Instant Product Discount\n , 40 : Product Mileage\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"In-House Cost Sharing Ratio","format":"int32"},"entrChrgRate":{"type":"integer","description":"Vendor Cost Sharing Ratio","format":"int32"},"fixamtFxrtGbCd":{"type":"string","description":"Fixed Amount/Fixed Rate Classification Code","enum":["01","02"]},"dcRateAmt":{"type":"integer","description":"Discount Rate/Amount","format":"int64"},"minBuyAmt":{"type":"integer","description":"Minimum Purchase Amount","format":"int64"},"maxDcAmt":{"type":"integer","description":"Maximum Discount Amount","format":"int64"},"isMaxYn":{"type":"string","description":"Maximum Benefit Status"},"dcAmt":{"type":"integer","description":"Discount Amount","format":"int64"},"dcAmtPerCnt":{"type":"integer","description":"Discount Amount by Quantity","format":"int64"},"cpnIsuNo":{"type":"string","description":"Coupon Issuance No."}},"description":"Benefit Information List"},"BenefitOrderPromotionInfo":{"required":["dcAmt","entrChrgRate","fixamtFxrtGbCd","goods","ourChrgRate","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name"},"promoTypCd":{"type":"string","description":"Promotion Type Code (MK002)\n 11 : Product Discount Coupon\n , 12 : Cart Coupon\n , 13 : Stackable Discount Coupon\n , 14 : Free Shipping Coupon\n , 15 : Free Return Coupon\n , 20 : Employee Discount\n , 21 : Instant Product Discount\n , 40 : Product Mileage\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"In-House Cost Sharing Ratio","format":"int32"},"entrChrgRate":{"type":"integer","description":"Vendor Cost Sharing Ratio","format":"int32"},"fixamtFxrtGbCd":{"type":"string","description":"Fixed Amount/Fixed Rate Classification Code","enum":["01","02"]},"dcRateAmt":{"type":"integer","description":"Discount Rate/Amount","format":"int64"},"minBuyAmt":{"type":"integer","description":"Minimum Purchase Amount","format":"int64"},"maxDcAmt":{"type":"integer","description":"Maximum Discount Amount","format":"int64"},"isMaxYn":{"type":"string","description":"Maximum Benefit Status"},"dcAmt":{"type":"integer","description":"Discount Amount","format":"int64"},"cpnIsuNo":{"type":"string","description":"Coupon Issuance No."},"goods":{"type":"array","description":"Product Information List","items":{"$ref":"#/components/schemas/OrderBenefitGoodsInfo"}}},"description":"Order Promotion Information"},"OrderBenefitGoodsInfo":{"required":["dcAmt","goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"dcAmt":{"type":"integer","description":"Discount Amount","format":"int64"}},"description":"Product Information List"},"PromotionDeliGrpValidationRequest":{"required":["deliNo","entrNo"],"type":"object","properties":{"deliNo":{"type":"string","description":"Delivery No."},"entrNo":{"type":"string","description":"Vendor No."},"benefitInfo":{"$ref":"#/components/schemas/DlvBenefitInfo"}},"description":"Selected Shipping Fee Coupon Info"},"DlvBenefitInfo":{"required":["cpnIsuNo","entrChrgRate","ourChrgRate","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name"},"promoTypCd":{"type":"string","description":"Promotion Type Code (MK002)\n 11 : Product Discount Coupon\n , 12 : Cart Coupon\n , 13 : Stackable Discount Coupon\n , 14 : Free Shipping Coupon\n , 15 : Free Return Coupon\n , 20 : Employee Discount\n , 21 : Instant Product Discount\n , 40 : Product Mileage\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"In-House Cost Sharing Ratio","format":"int32"},"entrChrgRate":{"type":"integer","description":"Vendor Cost Sharing Ratio","format":"int32"},"cpnIsuNo":{"type":"string","description":"Coupon Issuance No."},"ordCostGbCd":{"type":"string","description":"Cost Classification Code (OM043)"}},"description":"Shipping Benefit Info","nullable":true},"AccmResponse":{"required":["accmList","totalAccmAmt"],"type":"object","properties":{"totalAccmAmt":{"type":"integer","description":"Total Accrual Amount","format":"int64"},"accmList":{"type":"array","description":"Accrual Information List","items":{"$ref":"#/components/schemas/AccmPromotionInfo"}}},"description":"Accrual Information","nullable":true},"AccmPromotionInfo":{"required":["accmAmt","accmGbCd","accmRate","fixamtFxrtGbCd","promoNm","promoNo"],"type":"object","properties":{"accmGbCd":{"type":"string","description":"Asset Accrual/Usage Reason Code (ME020)\n 21 : Order Accrual\n , 22 : Member Grade Accrual\n , 23 : Reservation Product Accrual\n , 24 : Promotion Accrual\n , 50 : Order Usage\n , 58 : Delivery Fee Usage\n , 29 : Refund Accrual\n","enum":["21","22","23","24","50","58","29"]},"accmRate":{"type":"number","description":"Accrual Rate","format":"double"},"accmAmt":{"type":"integer","description":"Accrued Amount","format":"int64"},"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name"},"promoTypCd":{"type":"string","description":"Promotion Type","nullable":true,"enum":["40"]},"ourChrgRate":{"type":"integer","description":"In-House Cost Sharing Ratio","format":"int32"},"entrChrgRate":{"type":"integer","description":"Vendor Cost Sharing Ratio","format":"int32"},"fixamtFxrtGbCd":{"type":"string","description":"Fixed Amount/Fixed Rate Classification Code"},"rsrvStdAmt":{"type":"integer","description":"Accrual Standard Amount","format":"int64"},"goodsAccmList":{"type":"array","description":"Product Accrual Information List","items":{"$ref":"#/components/schemas/AccmInfo"}}},"description":"Accrual Information List"},"AccmInfo":{"required":["accmAmt","goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"accmAmt":{"type":"integer","description":"Accrued Amount","format":"int64"}},"description":"Product Accrual Information List"},"AeEvtInfo":{"required":["addEvtTypCd","aeDesc","aeEndDtm","aeGoodsList","aeNm","aeNo","aeStrDtm","goodsNo","itmNo","tmEvtYn"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"aeNo":{"type":"string","description":"Gift Promotion No."},"addEvtTypCd":{"type":"string","description":"Gift Event Type Code (MK012)\n 10 : Purchase Amount Gift\n , 20 : Product Gift\n","enum":["10","20"]},"aeStrDtm":{"type":"string","description":"Gift Event Start Date/Time","format":"date-time"},"aeEndDtm":{"type":"string","description":"Gift Event End Date/Time","format":"date-time"},"payStrDt":{"type":"string","description":"Payment Start Date"},"payEndDt":{"type":"string","description":"Payment End Date"},"tmEvtYn":{"type":"string","description":"Time Event Status","nullable":true},"aplyStrTm":{"type":"string","description":"Application Start Time","nullable":true},"aplyEndTm":{"type":"string","description":"Application End Time","nullable":true},"aeDesc":{"type":"string","description":"Gift Promotion Description"},"aeNm":{"type":"string","description":"Gift Event Name"},"aeGoodsList":{"type":"array","description":"Free Gift List","items":{"$ref":"#/components/schemas/AeFvrInfo"}}},"description":"Gift Promotion Information","nullable":true},"AeFvrInfo":{"required":["aeFvrSeq","aeGoodsNm","aeGoodsNo","aplyMaxAmt","aplyMinAmt"],"type":"object","properties":{"aeFvrSeq":{"type":"string","description":"Gift Event Sequence No."},"aplyMinAmt":{"type":"integer","description":"Minimum Applicable Amount","format":"int64"},"aplyMaxAmt":{"type":"integer","description":"Maximum Applicable Amount","format":"int64"},"aeGoodsNm":{"type":"string","description":"Gift Product Name"},"aeGoodsNo":{"type":"string","description":"Gift Product No."},"aeGoodsItmNo":{"type":"string","description":"Free Gift Item No."},"aeGoodsImgPath":{"type":"string","description":"Gift Image Path"}},"description":"Free Gift List"},"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"}}}} ```