> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/store-front-api/order-api/undefined-12.md).

# 프로모션 적립

## 프로모션 적립정보 조회

> \## 기능설명\
> \* 주문시 회원의 적립정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.\*\*\
> \* 주문 시점에는 기본적립, 회원 등급 추가적립, 프로모션 적립 3가지가 있습니다.\
>   \* 기본 적립 : 별 다른 조건 없이 주문 시 정해진 적립율만큼 적립.\
>   \* 회원 등급 추가 적립 : 기준금액을 초과하는 경우 회원의 등급에 맞는 적립율만큼 추가 적립.\
>   \* 프로모션 적립 : 상품별로 적용 가능한 상품마일리지의 적립율 만큼 추가 적립. \*\*단, 상품별로 하나의 프로모션 적립만 가능.\*\*\
> \---\
> \## 수정번호\
> \* Release v1.03\_231106: 상품별로 마일리지 적용 가능 여부 체크\
> \* Release v1.06\_231218: 클레임 시 기본 적립 필터 추가\
> \* Release v1.06\_231218: 클레임 적립 시 클레임 여부 데이터 세팅<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":["프로모션 적립"],"summary":"프로모션 적립정보 조회","description":"## 기능설명\n* 주문시 회원의 적립정보를 조회합니다.\n---\n## 상세설명\n* **비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.**\n* 주문 시점에는 기본적립, 회원 등급 추가적립, 프로모션 적립 3가지가 있습니다.\n  * 기본 적립 : 별 다른 조건 없이 주문 시 정해진 적립율만큼 적립.\n  * 회원 등급 추가 적립 : 기준금액을 초과하는 경우 회원의 등급에 맞는 적립율만큼 추가 적립.\n  * 프로모션 적립 : 상품별로 적용 가능한 상품마일리지의 적립율 만큼 추가 적립. **단, 상품별로 하나의 프로모션 적립만 가능.**\n---\n## 수정번호\n* Release v1.03_231106: 상품별로 마일리지 적용 가능 여부 체크\n* Release v1.06_231218: 클레임 시 기본 적립 필터 추가\n* Release v1.06_231218: 클레임 적립 시 클레임 여부 데이터 세팅\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":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AccmResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"AccmRequest":{"required":["baseDtm","goodsList","mbrGradeCd","mbrNo","ordMediaCd"],"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrGradeCd":{"type":"string","description":"회원등급코드(ME008)\n 10 : GREEN\n, 20 : FAMILY\n, 30 : GOLD\n, 40 : VIP\n, 50 : VVIP\n","enum":["10","20","30","40","50"]},"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"]},"baseDtm":{"type":"string","description":"기준일시","format":"date-time"},"goodsList":{"type":"array","description":"상품 리스트","items":{"$ref":"#/components/schemas/AccmGoodsInfo"}},"ordAccmList":{"type":"array","description":"주문적립정보","items":{"$ref":"#/components/schemas/OrderAccmInfo"}},"ordGoodsInfoList":{"type":"array","description":"주문상품정보","items":{"$ref":"#/components/schemas/OrdGoodsInfo"}},"benefitOrderPromotionInfo":{"$ref":"#/components/schemas/BenefitOrderPromotionInfo"}},"description":"적립조회 Request"},"AccmGoodsInfo":{"required":["brandNo","chlNo","dispCtgNo","entrNo","goodsNo","itmNo","purchaseAmt","stdCtgNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"purchaseAmt":{"type":"integer","description":"구매금액","format":"int64"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"brandNo":{"type":"string","description":"브랜드번호"},"entrNo":{"type":"string","description":"협력사번호"},"chlNo":{"type":"string","description":"채널번호"},"promoNo":{"type":"string","description":"적립 프로모션 번호"}},"description":"상품 리스트"},"OrderAccmInfo":{"required":["accmGbCd","accmRate","entrChrgRate","fixamtFxrtGbCd","ourChrgRate","promoNm","promoNo","rsrvStdAmt"],"type":"object","properties":{"accmGbCd":{"type":"string","description":"자산적립사용사유코드(ME020)\n 21 : 주문적립\n , 22 : 회원등급적립\n , 23 : 예약상품적립\n , 24 : 프로모션적립\n , 50 : 주문사용\n , 58 : 배송비사용\n , 29 : 환불적립\n","enum":["21","22","23","24","50","58","29"]},"promoNo":{"type":"string","description":"프로모션 번호"},"promoNm":{"type":"string","description":"프로모션명"},"ourChrgRate":{"type":"integer","description":"자사분담률","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담률","format":"int32"},"fixamtFxrtGbCd":{"type":"string","description":"정액정률구분코드"},"rsrvStdAmt":{"type":"integer","description":"적립기준금액","format":"int64"},"accmRate":{"type":"number","description":"적립율","format":"double"}},"description":"주문적립정보"},"OrdGoodsInfo":{"required":["basketGoods"],"type":"object","properties":{"basketGoods":{"$ref":"#/components/schemas/BasketGoods"},"aplyGoodsBnfInfo":{"$ref":"#/components/schemas/GoodsBenefitResponse"},"aeEvtList":{"type":"array","description":"사은행사정보","nullable":true,"items":{"$ref":"#/components/schemas/AeEvtInfo"}}},"description":"주문상품 DTO"},"BasketGoods":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"deliProcTypCd":{"type":"string","description":"PR008(배송처리유형코드)\n 10: CNTR_DLV(센터배송)\n,20: CORP_DLV(업체배송)\n,30: E_COUPON_DLV(e-쿠폰배송)\n","enum":["CNTR_DLV","CORP_DLV","E_COUPON_DLV"]},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliNo":{"type":"string","description":"배송번호"},"entrNo":{"type":"string","description":"협력사번호"},"ordQty":{"type":"integer","description":"주문수량","format":"int32"},"salePrc":{"type":"integer","description":"판매가","format":"int64"},"dcAmt":{"type":"integer","description":"할인가","format":"int64"},"sysModDtm":{"type":"string","description":"시스템수정시간","format":"date-time"},"itmNo":{"type":"string","description":"단품번호"},"bsketNo":{"type":"integer","description":"장바구니번호","format":"int64"},"chlNo":{"type":"string","description":"채널번호"},"chlDtlNo":{"type":"string","description":"채널상세번호"},"infDispCtgNoGbCd":{"type":"string","description":"유입전시카테고리번호구분코드(OM041)"},"infDispCtgNo":{"type":"string","description":"유입전시카테고리번호"},"repDispCtgNo":{"type":"string","description":"대표전시카테고리번호"},"conrNo":{"type":"string","description":"코너번호"},"bsketQty":{"type":"integer","description":"장바구니 수량","format":"int32"},"goodsNm":{"type":"string","description":"상품명"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구매연령제한코드"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"saleStrDtm":{"type":"string","description":"판매시작일시","format":"date-time"},"saleEndDtm":{"type":"string","description":"판매종료일시","format":"date-time"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","description":"최소제한수량","format":"int32"},"maxLmtQty":{"type":"integer","description":"최대제한수량","format":"int32"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드(PR030)"},"deliDday":{"type":"integer","description":"배송기일","format":"int64"},"bpckPsbYn":{"type":"string","description":"합포장가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"supPcost":{"type":"integer","description":"공급원가","format":"int64"},"norPrc":{"type":"integer","description":"정상가","format":"int64"},"preSalePrc":{"type":"integer","description":"종전판매가","format":"int64"},"mrgnRate":{"type":"number","description":"마진율","format":"double"},"payMeanInfo":{"type":"string","description":"결제수단"},"itmNm":{"type":"string","description":"단품명"},"stkQty":{"type":"integer","description":"단품수량","format":"int64"},"prestNm":{"type":"string","description":"증정품명"},"rsvStrtDtm":{"type":"string","description":"예약시작일시","format":"date-time"},"rsvEndDtm":{"type":"string","description":"예약종료일시","format":"date-time"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자","format":"date"},"hsCd":{"type":"string","description":"품목분류코드"},"wishYn":{"type":"string","description":"위시리스트 여부"},"maxDcAmt":{"type":"integer","description":"최대혜택금액","format":"int64"},"goodsImg":{"type":"string","description":"상품이미지"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005)"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"sngGoodsYn":{"type":"string","description":"단일상품여부"},"marketingDisplayNo":{"type":"string","description":"기획전번호"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"entrItmNo":{"type":"string","description":"협력사단품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"}},"description":"장바구니 상품 DTO"},"GoodsBenefitResponse":{"required":["benefitList","dcAmt","goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"dcAmt":{"type":"integer","description":"전체할인금액","format":"int64"},"benefitList":{"type":"array","description":"혜택정보리스트","items":{"$ref":"#/components/schemas/OrderPromotionInfo"}}},"description":"상품혜택정보","nullable":true},"OrderPromotionInfo":{"required":["dcAmt","dcAmtPerCnt","entrChrgRate","fixamtFxrtGbCd","ourChrgRate","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"자사분담률","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담률","format":"int32"},"fixamtFxrtGbCd":{"type":"string","description":"정액정률구분코드","enum":["01","02"]},"dcRateAmt":{"type":"integer","description":"할인률/금액","format":"int64"},"minBuyAmt":{"type":"integer","description":"최소구매금액","format":"int64"},"maxDcAmt":{"type":"integer","description":"최대할인금액","format":"int64"},"isMaxYn":{"type":"string","description":"최대혜택여부"},"dcAmt":{"type":"integer","description":"할인금액","format":"int64"},"dcAmtPerCnt":{"type":"integer","description":"개수별할인금액","format":"int64"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"}},"description":"혜택정보리스트"},"AeEvtInfo":{"required":["addEvtTypCd","aeDesc","aeEndDtm","aeGoodsList","aeNm","aeNo","aeStrDtm","goodsNo","itmNo","tmEvtYn"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"aeNo":{"type":"string","description":"사은행사번호"},"addEvtTypCd":{"type":"string","description":"사은행사 유형 코드(MK012)\n 10 : 구매금액사은품\n , 20 : 상품사은품\n","enum":["10","20"]},"aeStrDtm":{"type":"string","description":"사은행사시작일시","format":"date-time"},"aeEndDtm":{"type":"string","description":"사은행사종료일시","format":"date-time"},"payStrDt":{"type":"string","description":"지급시작일자"},"payEndDt":{"type":"string","description":"지급종료일자"},"tmEvtYn":{"type":"string","description":"타임행사여부","nullable":true},"aplyStrTm":{"type":"string","description":"적용시작시간","nullable":true},"aplyEndTm":{"type":"string","description":"적용종료시간","nullable":true},"aeDesc":{"type":"string","description":"사은행사설명"},"aeNm":{"type":"string","description":"사은행사명"},"aeGoodsList":{"type":"array","description":"사은품리스트","items":{"$ref":"#/components/schemas/AeFvrInfo"}}},"description":"사은행사정보","nullable":true},"AeFvrInfo":{"required":["aeFvrSeq","aeGoodsNm","aeGoodsNo","aplyMaxAmt","aplyMinAmt"],"type":"object","properties":{"aeFvrSeq":{"type":"string","description":"사은행사순번"},"aplyMinAmt":{"type":"integer","description":"적용최소금액","format":"int64"},"aplyMaxAmt":{"type":"integer","description":"적용최대금액","format":"int64"},"aeGoodsNm":{"type":"string","description":"사은품상품명"},"aeGoodsNo":{"type":"string","description":"사은품상품번호"},"aeGoodsItmNo":{"type":"string","description":"사은품단품번호"},"aeGoodsImgPath":{"type":"string","description":"사은품이미지경로"}},"description":"사은품리스트"},"BenefitOrderPromotionInfo":{"required":["dcAmt","entrChrgRate","fixamtFxrtGbCd","goods","ourChrgRate","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"자사분담률","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담률","format":"int32"},"fixamtFxrtGbCd":{"type":"string","description":"정액정률구분코드","enum":["01","02"]},"dcRateAmt":{"type":"integer","description":"할인률/금액","format":"int64"},"minBuyAmt":{"type":"integer","description":"최소구매금액","format":"int64"},"maxDcAmt":{"type":"integer","description":"최대할인금액","format":"int64"},"isMaxYn":{"type":"string","description":"최대혜택여부"},"dcAmt":{"type":"integer","description":"할인금액","format":"int64"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"goods":{"type":"array","description":"상품정보 리스트","items":{"$ref":"#/components/schemas/OrderBenefitGoodsInfo"}}},"description":"주문프로모션정보"},"OrderBenefitGoodsInfo":{"required":["dcAmt","goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"dcAmt":{"type":"integer","description":"할인금액","format":"int64"}},"description":"상품정보 리스트"},"AccmResponse":{"required":["accmList","totalAccmAmt"],"type":"object","properties":{"totalAccmAmt":{"type":"integer","description":"전체적립금액","format":"int64"},"accmList":{"type":"array","description":"적립 정보 리스트","items":{"$ref":"#/components/schemas/AccmPromotionInfo"}}},"description":"적립정보","nullable":true},"AccmPromotionInfo":{"required":["accmAmt","accmGbCd","accmRate","fixamtFxrtGbCd","promoNm","promoNo"],"type":"object","properties":{"accmGbCd":{"type":"string","description":"자산적립사용사유코드(ME020)\n 21 : 주문적립\n , 22 : 회원등급적립\n , 23 : 예약상품적립\n , 24 : 프로모션적립\n , 50 : 주문사용\n , 58 : 배송비사용\n , 29 : 환불적립\n","enum":["21","22","23","24","50","58","29"]},"accmRate":{"type":"number","description":"적립율","format":"double"},"accmAmt":{"type":"integer","description":"적립금액","format":"int64"},"promoNo":{"type":"string","description":"프로모션 번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션유형","nullable":true,"enum":["40"]},"ourChrgRate":{"type":"integer","description":"자사분담률","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담률","format":"int32"},"fixamtFxrtGbCd":{"type":"string","description":"정액정률구분코드"},"rsrvStdAmt":{"type":"integer","description":"적립기준금액","format":"int64"},"goodsAccmList":{"type":"array","description":"상품적립정보 리스트","items":{"$ref":"#/components/schemas/AccmInfo"}}},"description":"적립 정보 리스트"},"AccmInfo":{"required":["accmAmt","goodsNo","itmNo"],"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"accmAmt":{"type":"integer","description":"적립금액","format":"int64"}},"description":"상품적립정보 리스트"},"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"}}}}
```