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

# Promotion Accumulation

## Look Up Promotion Accrual Information

> \## Function Description\
> \* Looks up the member's accrual information at order time.\
> \---\
> \## Detailed Description\
> \* \*\*This is a member-only API; non-members cannot use it.\*\*\
> \* At order time, there are three types: basic accrual, member-grade additional accrual, and promotion accrual.\
>   \* Basic accrual: Accrued at the set accrual rate at order time, with no special conditions.\
>   \* Member-grade additional accrual: Additional accrual at the rate matching the member's grade if the order exceeds the threshold amount.\
>   \* Promotion accrual: Additional accrual at the accrual rate of the applicable product mileage per product. \*\*However, only one promotion accrual is possible per product.\*\*\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: Checks whether mileage is applicable per product\
> \* Release v1.06\_231218: Added basic accrual filter for claims\
> \* Release v1.06\_231218: Sets claim status data for claim accrual<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/promotionAccumulation":{"post":{"tags":["Promotion Accumulation"],"summary":"Look Up Promotion Accrual Information","description":"## Function Description\n* Looks up the member's accrual information at order time.\n---\n## Detailed Description\n* **This is a member-only API; non-members cannot use it.**\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---\n## Revision History\n* Release v1.03_231106: Checks whether mileage is applicable per product\n* Release v1.06_231218: Added basic accrual filter for claims\n* Release v1.06_231218: Sets claim status data for claim accrual\n","operationId":"getAccumulationInfo_1","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccmRequest"}}},"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":{"AccmRequest":{"required":["baseDtm","goodsList","mbrGradeCd","mbrNo","ordMediaCd"],"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"]},"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":"Product List","items":{"$ref":"#/components/schemas/AccmGoodsInfo"}},"ordAccmList":{"type":"array","description":"Order Mileage Accrual Information","items":{"$ref":"#/components/schemas/OrderAccmInfo"}},"ordGoodsInfoList":{"type":"array","description":"Order Product Information","items":{"$ref":"#/components/schemas/OrdGoodsInfo"}},"benefitOrderPromotionInfo":{"$ref":"#/components/schemas/BenefitOrderPromotionInfo"}},"description":"Retrieve Accrual Request"},"AccmGoodsInfo":{"required":["brandNo","chlNo","dispCtgNo","entrNo","goodsNo","itmNo","purchaseAmt","stdCtgNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"purchaseAmt":{"type":"integer","description":"Purchase Amount","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."},"promoNo":{"type":"string","description":"Accrual Promotion No."}},"description":"Product List"},"OrderAccmInfo":{"required":["accmGbCd","accmRate","entrChrgRate","fixamtFxrtGbCd","ourChrgRate","promoNm","promoNo","rsrvStdAmt"],"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"]},"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name"},"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"},"accmRate":{"type":"number","description":"Accrual Rate","format":"double"}},"description":"Order Mileage Accrual Information"},"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"}}}}
```