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

# Promotion Discount

## Look Up Order Form Delivery Fee Coupons

> \## Function Description\
> \* Looks up delivery fee coupon information by delivery group.\
> \---\
> \## Detailed Description\
> \* \*\*This is a member-only API; non-members cannot use it.\*\*\
> \* The same coupon can appear in more than one delivery group.\
> \* Under the current policy, \*\*only one delivery fee coupon can be applied per order\*\*.\
> \* Depending on the promotion type, free-shipping coupons and free-return coupons can be looked up.<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/orderDlvBenefitList":{"post":{"tags":["Promotion Discount"],"summary":"Look Up Order Form Delivery Fee Coupons","description":"## Function Description\n* Looks up delivery fee coupon information by delivery group.\n---\n## Detailed Description\n* **This is a member-only API; non-members cannot use it.**\n* The same coupon can appear in more than one delivery group.\n* Under the current policy, **only one delivery fee coupon can be applied per order**.\n* Depending on the promotion type, free-shipping coupons and free-return coupons can be looked up.\n","operationId":"getDlvBenefitInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DlvOrderApiRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromotionDlvOrderResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"DlvOrderApiRequest":{"required":["baseDtm","deliGrpInfoList","mbrGradeCd","mbrNo","promoTypCd"],"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"]},"promoTypCd":{"type":"string","description":"Promotion Type (Free Shipping Coupon, Free Return Shipping Coupon)","enum":["14","15"]},"baseDtm":{"type":"string","description":"Reference Date/Time","format":"date-time"},"deliGrpInfoList":{"type":"array","description":"Delivery Group List","items":{"$ref":"#/components/schemas/DeliGrpRequest"}}},"description":"Search Shipping Fee Coupon Request"},"DeliGrpRequest":{"required":["deliNo","entrNo"],"type":"object","properties":{"deliNo":{"type":"string","description":"Delivery No."},"entrNo":{"type":"string","description":"Vendor No."}},"description":"Delivery Group Information"},"PromotionDlvOrderResponse":{"required":["deliGrpInfo","usePsbClmDlvCpnCnt","usePsbDlvCpnCnt"],"type":"object","properties":{"usePsbDlvCpnCnt":{"type":"integer","description":"Number of Available Free Shipping Coupons","format":"int32"},"usePsbClmDlvCpnCnt":{"type":"integer","description":"Number of Available Free Return Coupons","format":"int32"},"deliGrpInfo":{"type":"array","description":"Delivery Group List","items":{"$ref":"#/components/schemas/DeliGrpInfo"}}}},"DeliGrpInfo":{"required":["benefitList","deliNo","entrNo"],"type":"object","properties":{"deliNo":{"type":"string","description":"Delivery No."},"entrNo":{"type":"string","description":"Vendor No."},"benefitList":{"type":"array","description":"Benefit Information","items":{"$ref":"#/components/schemas/DlvBenefitInfo"}}},"description":"Delivery Group Information"},"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},"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"}}}}
```

## Look Up Order Form Maximum Benefit Price

> \## Function Description\
> \* Looks up \*\*the maximum-benefit / usable discount information\*\* based on conditions.\
> \---\
> \## Detailed Description\
> \* \*\*This is a member-only API; non-members cannot use it.\*\*\
> \* When \*\*a coupon/discount is selected\*\*: looks up the maximum benefit.\
> \* When \*\*no coupon/discount is selected\*\*: checks whether the selected coupon/discount is usable.\
> \* Checks and calculates the usable benefit information for the given product.\
> \* Benefits that would cause a reverse margin on the product due to the discount are not returned.\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: Added employee discount limit management\
> \* Release v2.00\_240530: Made the maximum benefit calculation account for order quantity<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/orderBenefitList":{"post":{"tags":["Promotion Discount"],"summary":"Look Up Order Form Maximum Benefit Price","description":"## Function Description\n* Looks up **the maximum-benefit / usable discount information** based on conditions.\n---\n## Detailed Description\n* **This is a member-only API; non-members cannot use it.**\n* When **a coupon/discount is selected**: looks up the maximum benefit.\n* When **no coupon/discount is selected**: checks whether the selected coupon/discount is usable.\n* Checks and calculates the usable benefit information for the given product.\n* Benefits that would cause a reverse margin on the product due to the discount are not returned.\n---\n## Revision History\n* Release v1.03_231106: Added employee discount limit management\n* Release v2.00_240530: Made the maximum benefit calculation account for order quantity\n","operationId":"getBenefitInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderBenefitRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/BenefitResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrderBenefitRequest":{"required":["baseDtm","comGbCd","goodsList","mbrGradeCd","mbrNo","ordMediaCd","ordTypeGbCd","orderBnfList","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"]},"ordTypeGbCd":{"type":"string","description":"Order Type\n 10 : Cart\n , 20 : Order\n , 30 : Claim\n","enum":["10","20","30"]},"baseDtm":{"type":"string","description":"Reference Date/Time","format":"date-time"},"goodsList":{"type":"array","description":"Product Benefit List","items":{"$ref":"#/components/schemas/GoodsBenefitInfo"}},"orderBnfList":{"type":"array","description":"Order Benefit List","items":{"$ref":"#/components/schemas/BenefitInfo"}}},"description":"Search Coupon Benefit Request"},"GoodsBenefitInfo":{"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"},"bnfList":{"type":"array","description":"Selected Benefit Info","items":{"$ref":"#/components/schemas/BenefitInfo"}}},"description":"Product Benefit List"},"BenefitInfo":{"required":["promoNo"],"type":"object","properties":{"promoNo":{"type":"string","description":"Promotion No."},"cpnIsuNo":{"type":"string","description":"Coupon Issuance No."}},"description":"Order Benefit List"},"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"},"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"}}}}
```

## Look Up Product Detail Maximum Benefit Price

> \## Function Description\
> \* Calculates the discount information with the largest discount amount among the benefits usable for the product.\
> \---\
> \## Detailed Description\
> \* Calculates the discount information with the largest discount amount among the benefits usable for the product.\
> \* For members, downloadable coupons are also included in the maximum benefit calculation.\
> \* Discount information applied in the maximum benefit calculation\
> &#x20; \* Non-members\
> &#x20;   \* Promotion (discount): Product instant discount (applicable member grade: all selected, all unselected (considering data migration))\
> &#x20; \* Members\
> &#x20;   \* Promotion (discount): Employee discount, product instant discount\
> &#x20;   \* Held coupons: Product discount coupon\
> &#x20;   \* Downloadable coupons\
> &#x20;     \* Promotion type: Product discount coupon\
> &#x20;     \* Coupon issuer: Fixed promotional coupon\
> &#x20;    \* Coupon issuance method: Customer download issuance, discount coupon code issuance\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: Added employee discount limit management<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/maxDcAmt":{"post":{"tags":["Promotion Discount"],"summary":"Look Up Product Detail Maximum Benefit Price","description":"## Function Description\n* Calculates the discount information with the largest discount amount among the benefits usable for the product.\n---\n## Detailed Description\n* Calculates the discount information with the largest discount amount among the benefits usable for the product.\n* For members, downloadable coupons are also included in the maximum benefit calculation.\n* Discount information applied in the maximum benefit calculation\n  * Non-members\n    * Promotion (discount): Product instant discount (applicable member grade: all selected, all unselected (considering data migration))\n  * Members\n    * Promotion (discount): Employee discount, product instant discount\n    * Held coupons: Product discount coupon\n    * Downloadable coupons\n      * Promotion type: Product discount coupon\n      * Coupon issuer: Fixed promotional coupon\n     * Coupon issuance method: Customer download issuance, discount coupon code issuance\n---\n## Revision History\n* Release v1.03_231106: Added employee discount limit management\n","operationId":"getGoodsMaxBenefit","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsBenefitRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GoodsMaxBenefitResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"GoodsBenefitRequest":{"required":["goodsList","ordMediaCd"],"type":"object","properties":{"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"]},"goodsList":{"type":"array","description":"Product List","items":{"$ref":"#/components/schemas/GoodsDetailMaxBenefitGoodsInfo"}}},"description":"Search Product Detail Maximum Benefit Price Request"},"GoodsDetailMaxBenefitGoodsInfo":{"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"},"cnt":{"type":"integer","description":"Quantity","format":"int32"},"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."}},"description":"Product List"},"GoodsMaxBenefitResponse":{"required":["goodsNo","itmNo","maxBenefitAmt","salePrc"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"salePrc":{"type":"integer","description":"Selling Price","format":"int64"},"maxBenefitAmt":{"type":"integer","description":"Maximum Discount Benefit Amount (Maximum Benefit Price)","format":"int64"},"promoList":{"type":"array","description":"Promotion List","items":{"$ref":"#/components/schemas/GoodsPromotionInfo"}}}},"GoodsPromotionInfo":{"required":["dcAmt","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name (Coupon 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"]},"dcAmt":{"type":"integer","description":"Discount Amount","format":"int64"}},"description":"Promotion 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"}}}}
```

## Look Up Product Instant Discount Price

> \## Function Description\
> \* Looks up the usable product instant discount per product.\
> \---\
> \## Detailed Description\
> \* An API that looks up the product instant discount with the largest discount rate for each given product.<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/goodsDirectDiscountList":{"post":{"tags":["Promotion Discount"],"summary":"Look Up Product Instant Discount Price","description":"## Function Description\n* Looks up the usable product instant discount per product.\n---\n## Detailed Description\n* An API that looks up the product instant discount with the largest discount rate for each given product.\n","operationId":"getGoodsDirectDiscountInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsDirectDiscountRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GoodsDirectDiscountInfo"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"GoodsDirectDiscountRequest":{"required":["baseDtm","goodsList"],"type":"object","properties":{"baseDtm":{"type":"string","description":"Reference Date/Time","format":"date-time"},"goodsList":{"type":"array","description":"Product List","items":{"$ref":"#/components/schemas/DisplayGoodsInfo"}}}},"DisplayGoodsInfo":{"required":["goodsNo","itmNo","salePrc","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"}},"description":"Product List"},"GoodsDirectDiscountInfo":{"required":["dcAmt","dcRateAmt","fixamtFxrtGbCd","goodsNo","itmNo","promoNm","promoNo","salePrc"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"salePrc":{"type":"integer","description":"Selling Price","format":"int64"},"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name"},"fixamtFxrtGbCd":{"type":"string","description":"Fixed Amount/Rate Type Code (MK005)\n 01: Fixed Amount\n , 02: Fixed Rate\n","enum":["01","02"]},"dcRateAmt":{"type":"integer","description":"Discount Rate/Amount","format":"int64"},"dcAmt":{"type":"integer","description":"Discount Amount","format":"int64"}}},"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"}}}}
```

## Look Up Maximum Delivery Fee Benefit

> \## Function Description\
> \* An API that looks up only the delivery fee coupon information from the order form coupon list lookup API.\
> \---\
> \## Detailed Description\
> \* Delivery fee coupon information: Looks up the usable delivery fee coupon information by delivery group, and sets the delivery fee coupon on one delivery group according to the sort order below.\
> &#x20; \* Delivery fee Desc -> Additional delivery fee Desc -> Delivery group number Asc<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/getMaxBenefitDeliveryCoupon":{"post":{"tags":["Promotion Discount"],"summary":"Look Up Maximum Delivery Fee Benefit","description":"## Function Description\n* An API that looks up only the delivery fee coupon information from the order form coupon list lookup API.\n---\n## Detailed Description\n* Delivery fee coupon information: Looks up the usable delivery fee coupon information by delivery group, and sets the delivery fee coupon on one delivery group according to the sort order below.\n  * Delivery fee Desc -> Additional delivery fee Desc -> Delivery group number Asc\n","operationId":"getMaxBenefitDeliveryCoupon","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CouponPopupRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DlvCouponInfo"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CouponPopupRequest":{"required":["baseDtm","comGbCd","goodsList","mbrGradeCd","mbrNo","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/CouponPopupGoodsInfo"}},"dlvGrpList":{"type":"array","description":"Delivery Group Information","items":{"$ref":"#/components/schemas/PromotionDeliGrpValidationRequest"}},"cpnPopupGbCd":{"type":"string","description":"Coupon Popup Type Code\n 10 : Order Form\n , 20 : Coupon Selection Popup\n","enum":["10","20"]}},"description":"Coupon Selection Popup Request"},"CouponPopupGoodsInfo":{"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"},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"}},"description":"Order Product Information"},"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},"DlvCouponInfo":{"required":["dlvCpnCnt"],"type":"object","properties":{"dlvCpnCnt":{"type":"integer","description":"Number of Available Delivery Fee Coupons","format":"int64"},"dlvGrpInfo":{"type":"array","description":"Delivery Group Information","items":{"$ref":"#/components/schemas/PromotionDeliGrpValidationRequest"}}}},"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"}}}}
```

## Look Up Order Form Coupon List

> \## Function Description\
> \* An API used in the order form coupon selection pop-up.\
> \---\
> \## Detailed Description\
> \* Looks up usable benefit information upon entering the coupon selection pop-up; the lookup content is as follows.\
> &#x20; \* Employee discount: Automatically calculates and returns the single largest benefit among the employee discounts usable per product.\
> &#x20; \* Product instant discount: Automatically calculates and returns the single largest benefit among the product instant discounts usable per product.\
> &#x20; \* Product-level benefit information: Returns coupon information usable per product. Based on this information, the script calculates and displays actual usability.\
> &#x20; \* Cart-level benefit information: Returns coupon information usable at the order-form level. Based on this information, the script calculates and displays actual usability.\
> &#x20; \* Member-held coupon information: Contains information on coupons (excluding delivery fee coupons) held by the member. Based on this information, the script calculates and displays actual usability.\
> &#x20; \* Delivery fee coupon information: Looks up the usable delivery fee coupon information by delivery group, and sets the delivery fee coupon on one delivery group according to the sort order below.\
> &#x20;   \* Delivery fee Desc -> Additional delivery fee Desc -> Delivery group number Asc\
> &#x20; \* Maximum benefit information: Contains the discount information that is the maximum benefit among the usable benefit information.\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: Added employee discount limit management\
> \* Release v2.00\_240509: Added lookup of applicable target - special exhibition information\
> \* Release v2.00\_241205: Fixed an issue where the minimum purchase quantity/minimum purchase amount set on a coupon was always checked based on a single unit regardless of the number of ordered products<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/getCouponPopupData":{"post":{"tags":["Promotion Discount"],"summary":"Look Up Order Form Coupon List","description":"## Function Description\n* An API used in the order form coupon selection pop-up.\n---\n## Detailed Description\n* Looks up usable benefit information upon entering the coupon selection pop-up; the lookup content is as follows.\n  * Employee discount: Automatically calculates and returns the single largest benefit among the employee discounts usable per product.\n  * Product instant discount: Automatically calculates and returns the single largest benefit among the product instant discounts usable per product.\n  * Product-level benefit information: Returns coupon information usable per product. Based on this information, the script calculates and displays actual usability.\n  * Cart-level benefit information: Returns coupon information usable at the order-form level. Based on this information, the script calculates and displays actual usability.\n  * Member-held coupon information: Contains information on coupons (excluding delivery fee coupons) held by the member. Based on this information, the script calculates and displays actual usability.\n  * Delivery fee coupon information: Looks up the usable delivery fee coupon information by delivery group, and sets the delivery fee coupon on one delivery group according to the sort order below.\n    * Delivery fee Desc -> Additional delivery fee Desc -> Delivery group number Asc\n  * Maximum benefit information: Contains the discount information that is the maximum benefit among the usable benefit information.\n---\n## Revision History\n* Release v1.03_231106: Added employee discount limit management\n* Release v2.00_240509: Added lookup of applicable target - special exhibition information\n* Release v2.00_241205: Fixed an issue where the minimum purchase quantity/minimum purchase amount set on a coupon was always checked based on a single unit regardless of the number of ordered products\n","operationId":"getCouponPopupData","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CouponPopupRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CouponPopupResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CouponPopupRequest":{"required":["baseDtm","comGbCd","goodsList","mbrGradeCd","mbrNo","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/CouponPopupGoodsInfo"}},"dlvGrpList":{"type":"array","description":"Delivery Group Information","items":{"$ref":"#/components/schemas/PromotionDeliGrpValidationRequest"}},"cpnPopupGbCd":{"type":"string","description":"Coupon Popup Type Code\n 10 : Order Form\n , 20 : Coupon Selection Popup\n","enum":["10","20"]}},"description":"Coupon Selection Popup Request"},"CouponPopupGoodsInfo":{"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"},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"}},"description":"Order Product Information"},"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},"CouponPopupResponse":{"type":"object","properties":{"executivesDiscountInfo":{"$ref":"#/components/schemas/PromotionSelectedInfo"},"goodsDirectDiscountInfo":{"$ref":"#/components/schemas/PromotionSelectedInfo"},"goodsBenefitInfo":{"type":"array","description":"Product-Level Benefit Information","items":{"$ref":"#/components/schemas/CouponBenefitinfo"}},"basketCouponBenefitinfo":{"type":"array","description":"Cart-Level Benefit Information","items":{"$ref":"#/components/schemas/BasketCouponBenefitinfo"}},"promoList":{"type":"array","description":"Member's Held Coupon Information","items":{"$ref":"#/components/schemas/PromotionInfo"}},"dlvCouponInfo":{"$ref":"#/components/schemas/DlvCouponInfo"},"maxBenefitInfo":{"$ref":"#/components/schemas/BenefitResponse"}},"description":"Coupon Selection Popup Response"},"PromotionSelectedInfo":{"type":"object","properties":{"totalDcAmt":{"type":"integer","description":"Total Discount Amount","format":"int64"},"goodsList":{"type":"array","description":"Discount Amount by Product","items":{"$ref":"#/components/schemas/DiscountGoodsInfo"}}},"description":"Selected Promotion (Discount/Mileage) Information"},"DiscountGoodsInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"},"itmNo":{"type":"string","description":"Item No."},"dcAmt":{"type":"integer","description":"Discount Amount","format":"int64"},"bnfInfo":{"$ref":"#/components/schemas/OrderPromotionInfo"}},"description":"Product Discount Info"},"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"},"CouponBenefitinfo":{"required":["goodsNo","itmNo","promoNoList"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"promoNoList":{"type":"array","items":{"type":"string","description":"Available Benefit No. List"}}},"description":"Product-Level Benefit Information"},"BasketCouponBenefitinfo":{"required":["goodsList","promoNo"],"type":"object","properties":{"promoNo":{"type":"string","description":"Promotion No."},"goodsList":{"type":"array","description":"Available Product List","items":{"$ref":"#/components/schemas/BasketCouponGoodsInfo"}}},"description":"Cart-Level Benefit Information"},"BasketCouponGoodsInfo":{"required":["goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."}},"description":"Available Product List"},"PromotionInfo":{"required":["baseAmt","couponIssuedInfo","entrChrgRate","fixamtFxrtGbCd","goodsNo","itmNo","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"},"couponIssuedInfo":{"type":"array","description":"Coupon Issuance Information List","items":{"$ref":"#/components/schemas/CouponIssuedInfo"}},"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"baseAmt":{"type":"integer","description":"Standard Amount","format":"int64"}},"description":"Member's Held Coupon Information"},"CouponIssuedInfo":{"required":["cpnIsuDtm","cpnIsuNo","cpnNo","mbrNo","useYn","valiEndDtm","valiStrtDtm"],"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"Coupon Issuance No."},"mbrNo":{"type":"string","description":"Member No."},"cpnNo":{"type":"string","description":"Promotion No."},"cpnIsuDtm":{"type":"string","description":"Coupon Issuance Date/Time","format":"date-time"},"valiStrtDtm":{"type":"string","description":"Validity Start Date/Time","format":"date-time"},"valiEndDtm":{"type":"string","description":"Validity End Date/Time","format":"date-time"},"useYn":{"type":"string","description":"Usage Status"}},"description":"Coupon Issuance Information List"},"DlvCouponInfo":{"required":["dlvCpnCnt"],"type":"object","properties":{"dlvCpnCnt":{"type":"integer","description":"Number of Available Delivery Fee Coupons","format":"int64"},"dlvGrpInfo":{"type":"array","description":"Delivery Group Information","items":{"$ref":"#/components/schemas/PromotionDeliGrpValidationRequest"}}}},"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},"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"},"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"}}}}
```

## Look Up Promotion List for Agent Order Form

> \## Function Description\
> \- An API that looks up promotions selectable for an order entered by an agent.\
> \---\
> \## Detailed Description\
> \- Looks up promotions selectable during a BO agent's order process.\
> \---\
> \## Notes\
> \- Identical logic to the getCouponPopupData (promotion discount) API.\
> \- The difference is that the order is created using the member number (mbrNo) in the parameter, and the member number is a required parameter.<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/getCounselorOrderCouponPopupData":{"post":{"tags":["Promotion Discount"],"summary":"Look Up Promotion List for Agent Order Form","description":"## Function Description\n- An API that looks up promotions selectable for an order entered by an agent.\n---\n## Detailed Description\n- Looks up promotions selectable during a BO agent's order process.\n---\n## Notes\n- Identical logic to the getCouponPopupData (promotion discount) API.\n- The difference is that the order is created using the member number (mbrNo) in the parameter, and the member number is a required parameter.\n","operationId":"getCounselorOrderCouponPopupData","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CouponPopupRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CouponPopupResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CouponPopupRequest":{"required":["baseDtm","comGbCd","goodsList","mbrGradeCd","mbrNo","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/CouponPopupGoodsInfo"}},"dlvGrpList":{"type":"array","description":"Delivery Group Information","items":{"$ref":"#/components/schemas/PromotionDeliGrpValidationRequest"}},"cpnPopupGbCd":{"type":"string","description":"Coupon Popup Type Code\n 10 : Order Form\n , 20 : Coupon Selection Popup\n","enum":["10","20"]}},"description":"Coupon Selection Popup Request"},"CouponPopupGoodsInfo":{"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"},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"}},"description":"Order Product Information"},"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},"CouponPopupResponse":{"type":"object","properties":{"executivesDiscountInfo":{"$ref":"#/components/schemas/PromotionSelectedInfo"},"goodsDirectDiscountInfo":{"$ref":"#/components/schemas/PromotionSelectedInfo"},"goodsBenefitInfo":{"type":"array","description":"Product-Level Benefit Information","items":{"$ref":"#/components/schemas/CouponBenefitinfo"}},"basketCouponBenefitinfo":{"type":"array","description":"Cart-Level Benefit Information","items":{"$ref":"#/components/schemas/BasketCouponBenefitinfo"}},"promoList":{"type":"array","description":"Member's Held Coupon Information","items":{"$ref":"#/components/schemas/PromotionInfo"}},"dlvCouponInfo":{"$ref":"#/components/schemas/DlvCouponInfo"},"maxBenefitInfo":{"$ref":"#/components/schemas/BenefitResponse"}},"description":"Coupon Selection Popup Response"},"PromotionSelectedInfo":{"type":"object","properties":{"totalDcAmt":{"type":"integer","description":"Total Discount Amount","format":"int64"},"goodsList":{"type":"array","description":"Discount Amount by Product","items":{"$ref":"#/components/schemas/DiscountGoodsInfo"}}},"description":"Selected Promotion (Discount/Mileage) Information"},"DiscountGoodsInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"},"itmNo":{"type":"string","description":"Item No."},"dcAmt":{"type":"integer","description":"Discount Amount","format":"int64"},"bnfInfo":{"$ref":"#/components/schemas/OrderPromotionInfo"}},"description":"Product Discount Info"},"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"},"CouponBenefitinfo":{"required":["goodsNo","itmNo","promoNoList"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"promoNoList":{"type":"array","items":{"type":"string","description":"Available Benefit No. List"}}},"description":"Product-Level Benefit Information"},"BasketCouponBenefitinfo":{"required":["goodsList","promoNo"],"type":"object","properties":{"promoNo":{"type":"string","description":"Promotion No."},"goodsList":{"type":"array","description":"Available Product List","items":{"$ref":"#/components/schemas/BasketCouponGoodsInfo"}}},"description":"Cart-Level Benefit Information"},"BasketCouponGoodsInfo":{"required":["goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."}},"description":"Available Product List"},"PromotionInfo":{"required":["baseAmt","couponIssuedInfo","entrChrgRate","fixamtFxrtGbCd","goodsNo","itmNo","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"},"couponIssuedInfo":{"type":"array","description":"Coupon Issuance Information List","items":{"$ref":"#/components/schemas/CouponIssuedInfo"}},"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"baseAmt":{"type":"integer","description":"Standard Amount","format":"int64"}},"description":"Member's Held Coupon Information"},"CouponIssuedInfo":{"required":["cpnIsuDtm","cpnIsuNo","cpnNo","mbrNo","useYn","valiEndDtm","valiStrtDtm"],"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"Coupon Issuance No."},"mbrNo":{"type":"string","description":"Member No."},"cpnNo":{"type":"string","description":"Promotion No."},"cpnIsuDtm":{"type":"string","description":"Coupon Issuance Date/Time","format":"date-time"},"valiStrtDtm":{"type":"string","description":"Validity Start Date/Time","format":"date-time"},"valiEndDtm":{"type":"string","description":"Validity End Date/Time","format":"date-time"},"useYn":{"type":"string","description":"Usage Status"}},"description":"Coupon Issuance Information List"},"DlvCouponInfo":{"required":["dlvCpnCnt"],"type":"object","properties":{"dlvCpnCnt":{"type":"integer","description":"Number of Available Delivery Fee Coupons","format":"int64"},"dlvGrpInfo":{"type":"array","description":"Delivery Group Information","items":{"$ref":"#/components/schemas/PromotionDeliGrpValidationRequest"}}}},"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},"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"},"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"}}}}
```

## Look Up Agent Order Accrual Information

> \## Function Description\
> \* Looks up the member's accrual information for an agent order.\
> \---\
> \## Detailed Description\
> \* At order time, there are three types: basic accrual, member-grade additional accrual, and promotion accrual.\
> &#x20; \* Basic accrual: Accrued at the set accrual rate at order time, with no special conditions.\
> &#x20; \* Member-grade additional accrual: Additional accrual at the rate matching the member's grade if the order exceeds the threshold amount.\
> &#x20; \* Promotion accrual: Additional accrual at the accrual rate of the applicable product mileage per product. \*\*However, only one promotion accrual is possible per product.\*\*<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/getCounselorOrderAccumulationInfo":{"post":{"tags":["Promotion Discount"],"summary":"Look Up Agent Order Accrual Information","description":"## Function Description\n* Looks up the member's accrual information for an agent order.\n---\n## Detailed Description\n* At order time, there are three types: basic accrual, member-grade additional accrual, and promotion accrual.\n  * Basic accrual: Accrued at the set accrual rate at order time, with no special conditions.\n  * Member-grade additional accrual: Additional accrual at the rate matching the member's grade if the order exceeds the threshold amount.\n  * Promotion accrual: Additional accrual at the accrual rate of the applicable product mileage per product. **However, only one promotion accrual is possible per product.**\n","operationId":"getCounselorOrderAccumulationInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounselorOrderAccmRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AccmResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CounselorOrderAccmRequest":{"required":["mbrGradeCd","mbrNo"],"type":"object","properties":{"ordGoodsInfoList":{"type":"array","description":"Order Product Information","items":{"$ref":"#/components/schemas/OrdGoodsInfo"}},"benefitOrderPromotionInfo":{"$ref":"#/components/schemas/BenefitOrderPromotionInfo"},"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"]},"mbrNo":{"type":"string","description":"Member No."},"mbrGradeCd":{"type":"string","description":"Member Grade Code"}},"description":"FO Order Accrual Retrieval Request DTO"},"OrdGoodsInfo":{"required":["basketGoods"],"type":"object","properties":{"basketGoods":{"$ref":"#/components/schemas/BasketGoods"},"aplyGoodsBnfInfo":{"$ref":"#/components/schemas/GoodsBenefitResponse"},"aeEvtList":{"type":"array","description":"Gift Promotion Information","nullable":true,"items":{"$ref":"#/components/schemas/AeEvtInfo"}}},"description":"Order Product DTO"},"BasketGoods":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"deliProcTypCd":{"type":"string","description":"PR008 (Delivery Processing Type Code)\n 10: CNTR_DLV (Center Delivery)\n,20: CORP_DLV (Vendor Delivery)\n,30: E_COUPON_DLV (E-Coupon Delivery)\n","enum":["CNTR_DLV","CORP_DLV","E_COUPON_DLV"]},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"deliNo":{"type":"string","description":"Delivery No."},"entrNo":{"type":"string","description":"Vendor No."},"ordQty":{"type":"integer","description":"Order Quantity","format":"int32"},"salePrc":{"type":"integer","description":"Selling Price","format":"int64"},"dcAmt":{"type":"integer","description":"Discounted Price","format":"int64"},"sysModDtm":{"type":"string","description":"System Modification Time","format":"date-time"},"itmNo":{"type":"string","description":"Item No."},"bsketNo":{"type":"integer","description":"Cart No.","format":"int64"},"chlNo":{"type":"string","description":"Channel No."},"chlDtlNo":{"type":"string","description":"Channel Detail No."},"infDispCtgNoGbCd":{"type":"string","description":"Referral Display Category No. Classification Code (OM041)"},"infDispCtgNo":{"type":"string","description":"Referral Display Category No."},"repDispCtgNo":{"type":"string","description":"Main Display Category No."},"conrNo":{"type":"string","description":"Corner No."},"bsketQty":{"type":"integer","description":"Cart Quantity","format":"int32"},"goodsNm":{"type":"string","description":"Product Name"},"stdCtgNo":{"type":"string","description":"Standard Category No."},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001)"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002)"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchase Age Restriction Code"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"saleStrDtm":{"type":"string","description":"Sales Start Date/Time","format":"date-time"},"saleEndDtm":{"type":"string","description":"Sales End Date/Time","format":"date-time"},"buyTypCd":{"type":"string","description":"Purchase Type Code (PR006)"},"taxGbCd":{"type":"string","description":"Tax/Duty-Free Classification Code (PR007)"},"stkMgrYn":{"type":"string","description":"Inventory Management Status"},"buyQtyLmtYn":{"type":"string","description":"Purchase Quantity Limit Status"},"minLmtQty":{"type":"integer","description":"Minimum Limit Quantity","format":"int32"},"maxLmtQty":{"type":"integer","description":"Maximum Limit Quantity","format":"int32"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code (PR030)"},"deliDday":{"type":"integer","description":"Delivery Lead Time","format":"int64"},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"supPcost":{"type":"integer","description":"Supply Cost","format":"int64"},"norPrc":{"type":"integer","description":"Regular Price","format":"int64"},"preSalePrc":{"type":"integer","description":"Previous Selling Price","format":"int64"},"mrgnRate":{"type":"number","description":"Margin Rate","format":"double"},"payMeanInfo":{"type":"string","description":"Payment Method"},"itmNm":{"type":"string","description":"Item Name"},"stkQty":{"type":"integer","description":"Item Quantity","format":"int64"},"prestNm":{"type":"string","description":"Gift Item Name"},"rsvStrtDtm":{"type":"string","description":"Reservation Start Date/Time","format":"date-time"},"rsvEndDtm":{"type":"string","description":"Reservation End Date/Time","format":"date-time"},"fwdidcPrarDy":{"type":"string","description":"Scheduled Shipment Instruction Date","format":"date"},"hsCd":{"type":"string","description":"Item Classification Code"},"wishYn":{"type":"string","description":"Wishlist Status"},"maxDcAmt":{"type":"integer","description":"Maximum Benefit Amount","format":"int64"},"goodsImg":{"type":"string","description":"Product Image"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status Code (PR005)"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"sngGoodsYn":{"type":"string","description":"Single Product Status"},"marketingDisplayNo":{"type":"string","description":"Special Exhibition No."},"entrGoodsNo":{"type":"string","description":"Vendor Product No."},"entrItmNo":{"type":"string","description":"Vendor SKU No."},"ordCnclPsbYn":{"type":"string","description":"Order Cancellation Availability Status"},"wthdYn":{"type":"string","description":"Collection Status"},"frgnDirPurGoodsYn":{"type":"string","description":"Overseas Direct Purchase Product Status"}},"description":"Cart Product DTO"},"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"},"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"},"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"},"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"},"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"}}}}
```

## Process Order Form Coupon Use

> \## Function Description\
> \* Marks the coupons selected in the order as used.\
> \---\
> \## Detailed Description\
> \* \*\*This is a member-only API; non-members cannot use it.\*\*\
> \* Marks the coupons selected in the order as used.\
> \* Only coupons meeting the following conditions can be used.\
> &#x20; \* Coupon period: valid\
> &#x20; \* Usage status: unused<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/cpnUse":{"post":{"tags":["Promotion Discount"],"summary":"Process Order Form Coupon Use","description":"## Function Description\n* Marks the coupons selected in the order as used.\n---\n## Detailed Description\n* **This is a member-only API; non-members cannot use it.**\n* Marks the coupons selected in the order as used.\n* Only coupons meeting the following conditions can be used.\n  * Coupon period: valid\n  * Usage status: unused\n","operationId":"useCpn","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CpnUseRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CpnUseRequest":{"required":["mbrNo","ordNo"],"type":"object","properties":{"mbrNo":{"type":"string","description":"Member No."},"ordNo":{"type":"string","description":"Order No."},"cpnInfo":{"type":"array","description":"Coupon List","items":{"$ref":"#/components/schemas/CpnUseInfo"}},"cpnIsuNoList":{"type":"array","items":{"type":"string"}}},"description":"Used Coupon Info Request DTO"},"CpnUseInfo":{"required":["cpnIsuNo"],"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"Coupon Issuance No."}},"description":"Used Coupon Info DTO"},"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"}}}}
```

## Cancel/Restore Coupon

> \## Function Description\
> \* Cancels/restores a coupon.\
> \---\
> \## Detailed Description\
> \* Order form\
> &#x20; \* When \*\*restoration classification code\*\* is 10\
> &#x20; \* Removes the usage-related information from the existing coupon issuance information.\
> \* Claim/other\
> &#x20; \* When \*\*restoration classification code\*\* is 20 (claim) or 99 (other)\
> &#x20; \* Issues a new coupon using the existing issuance information.\
> &#x20;   \* Coupon number, original coupon issuance number, member notification status, member number\
> &#x20; \* If the validity period of the issued coupon has expired, reissues a coupon valid for \*\*the coupon-restoration validity days of ST001\*\* from the current date.<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/cpnCancel":{"post":{"tags":["Promotion Discount"],"summary":"Cancel/Restore Coupon","description":"## Function Description\n* Cancels/restores a coupon.\n---\n## Detailed Description\n* Order form\n  * When **restoration classification code** is 10\n  * Removes the usage-related information from the existing coupon issuance information.\n* Claim/other\n  * When **restoration classification code** is 20 (claim) or 99 (other)\n  * Issues a new coupon using the existing issuance information.\n    * Coupon number, original coupon issuance number, member notification status, member number\n  * If the validity period of the issued coupon has expired, reissues a coupon valid for **the coupon-restoration validity days of ST001** from the current date.\n","operationId":"cnclCpn","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CpnCnclRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CpnCnclRequest":{"required":["mbrNo","ordNo","restoreGbCd"],"type":"object","properties":{"mbrNo":{"type":"string","description":"Member No."},"ordNo":{"type":"string","description":"Order No."},"restoreGbCd":{"type":"string","description":"Coupon Restoration Type\n 10 : Order Form\n, 20 : Claim\n, 99 : Other\n","enum":["10","20","99"]},"cpnInfo":{"type":"array","description":"Coupon List","items":{"$ref":"#/components/schemas/CpnCnclInfo"}},"cpnIsuNoList":{"type":"array","items":{"type":"string"}}},"description":"Restored Coupon Info Request DTO"},"CpnCnclInfo":{"required":["cpnIsuNo"],"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"Coupon Issuance No."}},"description":"Restored Coupon Info DTO"},"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"}}}}
```

## Search Coupon Count by Member

> \## Function Description\
> \* Retrieves the count of the member's coupons and delivery-related coupons via the BO API.\
> \---\
> \## Detailed Description\
> \* Retrieves the count of unused, currently valid coupons held by the member.<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/mbrCpnCnt":{"get":{"tags":["Promotion Discount"],"summary":"Search Coupon Count by Member","description":"## Function Description\n* Retrieves the count of the member's coupons and delivery-related coupons via the BO API.\n---\n## Detailed Description\n* Retrieves the count of unused, currently valid coupons held by the member.\n","operationId":"getMbrCpnCnt","parameters":[{"name":"mbrNo","in":"query","description":"Member No.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MbrCpnCntResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MbrCpnCntResponse":{"type":"object","properties":{"dlvCnt":{"type":"integer","description":"Free Shipping Coupon Quantity","format":"int32"},"cpnCnt":{"type":"integer","description":"General Coupon Quantity","format":"int32"}},"description":"Coupon Quantity Held by Member"},"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"}}}}
```

## Search Basic Coupon Info

> \## Function Description\
> \* Retrieves the basic information of the given promotion number.\
> \---\
> \## Detailed Description\
> \* Retrieves the basic information of the currently running promotions for the given promotion numbers.\
> \## Revision History\
> \* Release v2.00\_240401: Added applicable media to event coupon lookup<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/cpnInfoList":{"get":{"tags":["Promotion Discount"],"summary":"Search Basic Coupon Info","description":"## Function Description\n* Retrieves the basic information of the given promotion number.\n---\n## Detailed Description\n* Retrieves the basic information of the currently running promotions for the given promotion numbers.\n## Revision History\n* Release v2.00_240401: Added applicable media to event coupon lookup\n","operationId":"getCouponInfo","parameters":[{"name":"promoNoList","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","description":"Promotion Number List"}}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CouponInfoResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CouponInfoResponse":{"required":["aplyTermGbCd","appOnly","dcRateAmt","fixamtFxrtGbCd","maxDcAmt","minBuyAmt","minBuyQty","promoNo","promoStatCd","promoTypCd","valiEndDtm","valiStrtDtm"],"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"]},"promoStatCd":{"type":"string","description":"Promotion Status Code (MK003)\n 10 : In Progress\n, 20 : Suspended\n","enum":["10","20"]},"promoDesc":{"type":"string","description":"Promotion Description"},"aplyTermGbCd":{"type":"string","description":"Applicable Period Type Code (MK015)\n 01 : Period-Based\n , 02 : Issuance-Date-Based\n","enum":["01","02"]},"issuDdStdCpnUseDds":{"type":"integer","description":"Coupon Usage Days from Issuance Date","format":"int32"},"valiStrtDtm":{"type":"string","description":"Validity Start Date/Time","format":"date-time"},"valiEndDtm":{"type":"string","description":"Validity End Date/Time","format":"date-time"},"fixamtFxrtGbCd":{"type":"string","description":"Fixed Amount/Rate Type Code (MK005)\n 01: Fixed Amount\n , 02: Fixed Rate\n","enum":["01","02"]},"dcRateAmt":{"type":"integer","description":"Discount Rate/Amount","format":"int64"},"appOnly":{"type":"boolean","description":"App-Only Status"},"minBuyQty":{"type":"integer","description":"Minimum Purchase Quantity","format":"int32"},"minBuyAmt":{"type":"integer","description":"Minimum Purchase Amount","format":"int64"},"maxDcAmt":{"type":"integer","description":"Maximum Discount Amount","format":"int64"},"mediaCdNmArray":{"type":"string","description":"Applicable Media"}}},"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"}}}}
```