프로모션 적립
기능설명
주문시 회원의 적립정보를 조회합니다.
상세설명
비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.
주문 시점에는 기본적립, 회원 등급 추가적립, 프로모션 적립 3가지가 있습니다.
기본 적립 : 별 다른 조건 없이 주문 시 정해진 적립율만큼 적립.
회원 등급 추가 적립 : 기준금액을 초과하는 경우 회원의 등급에 맞는 적립율만큼 추가 적립.
프로모션 적립 : 상품별로 적용 가능한 상품마일리지의 적립율 만큼 추가 적립. 단, 상품별로 하나의 프로모션 적립만 가능.
수정번호
Release v1.03_231106: 상품별로 마일리지 적용 가능 여부 체크
Release v1.06_231218: 클레임 시 기본 적립 필터 추가
Release v1.06_231218: 클레임 적립 시 클레임 여부 데이터 세팅
Header parameters
AuthorizationanyOptional
Access Token
Body
적립조회 Request
mbrNostringRequiredExample:
회원번호
100000000mbrGradeCdstring · enumRequiredExample:
회원등급코드(ME008) 10 : GREEN , 20 : FAMILY , 30 : GOLD , 40 : VIP , 50 : VVIP
10Possible values: ordMediaCdstring · enumRequiredExample:
주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: baseDtmstring · date-timeRequired
기준일시
Responses
200
성공
*/*
적립정보
totalAccmAmtinteger · int64RequiredExample:
전체적립금액
3000900
업무처리 오류 내용
*/*
post/v1/marketing/promotionAccumulation
POST /api/order/v1/marketing/promotionAccumulation HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 3044
{
"mbrNo": "100000000",
"mbrGradeCd": "10",
"ordMediaCd": "20",
"baseDtm": "2026-01-01T00:00:00.000Z",
"goodsList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"purchaseAmt": 6000,
"stdCtgNo": "EX00000000",
"dispCtgNo": "000",
"brandNo": "100000",
"entrNo": "1000000",
"chlNo": "1000000",
"promoNo": "C1000000'"
}
],
"ordAccmList": [
{
"accmGbCd": "21",
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"rsrvStdAmt": 5000,
"accmRate": 10
}
],
"ordGoodsInfoList": [
{
"basketGoods": {
"goodsNo": "100000001",
"deliProcTypCd": "10",
"deliPolcNo": "1",
"deliNo": "100000021",
"entrNo": "1000001",
"ordQty": 1,
"salePrc": 15000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"itmNo": "001",
"bsketNo": 100000001,
"chlNo": "1",
"chlDtlNo": "1",
"infDispCtgNoGbCd": "01",
"infDispCtgNo": "1",
"repDispCtgNo": "1",
"conrNo": "1",
"bsketQty": 1,
"goodsNm": "상품명",
"stdCtgNo": "1",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"brandNo": "1",
"brandNm": "브랜드명",
"buyrAgeLmtCd": "0",
"dispYn": "Y",
"saleStatCd": "10",
"saleStrDtm": "2026-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"buyTypCd": "10",
"taxGbCd": "10",
"stkMgrYn": "Y",
"buyQtyLmtYn": "Y",
"minLmtQty": 1,
"maxLmtQty": 10,
"safeStkNotiYn": "Y",
"deliGoodsGbCd": "01",
"deliWayCd": "01",
"deliPsbRgnCd": "01",
"deliDday": 1,
"bpckPsbYn": "Y",
"rtnPsbYn": "Y",
"exchPsbYn": "Y",
"supPcost": 10000,
"norPrc": 20000,
"preSalePrc": 20000,
"mrgnRate": 4,
"payMeanInfo": "11,12,32",
"itmNm": "아이템명1>아이템명2>아이템명3",
"stkQty": 999,
"prestNm": "증정품명",
"rsvStrtDtm": "2026-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"hsCd": "1",
"wishYn": "Y",
"maxDcAmt": 1000,
"goodsImg": "files/goods/2023/07/04/img",
"itmSaleStatCd": "10",
"gvgfPsbYn": "Y",
"rglrDeliGoodsYn": "Y",
"sngGoodsYn": "Y",
"marketingDisplayNo": "1",
"entrGoodsNo": "100042110583831",
"entrItmNo": "100042110583831001",
"ordCnclPsbYn": "N",
"wthdYn": "N",
"frgnDirPurGoodsYn": "text"
},
"aplyGoodsBnfInfo": {
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000,
"benefitList": [
{
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"dcAmtPerCnt": 2500,
"cpnIsuNo": "100000"
}
]
},
"aeEvtList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"aeNo": "C1000000",
"addEvtTypCd": "20",
"aeStrDtm": "2026-01-01T00:00:00.000Z",
"aeEndDtm": "2026-01-01T00:00:00.000Z",
"payStrDt": "20231201",
"payEndDt": "20231231",
"tmEvtYn": "N",
"aplyStrTm": "0800",
"aplyEndTm": "2359",
"aeDesc": "사은행사 설명",
"aeNm": "사은행사 명",
"aeGoodsList": [
{
"aeFvrSeq": "1",
"aplyMinAmt": 5000,
"aplyMaxAmt": 10000,
"aeGoodsNm": "사은품 명",
"aeGoodsNo": "10000001",
"aeGoodsItmNo": "001",
"aeGoodsImgPath": "/path/image001.png"
}
]
}
]
}
],
"benefitOrderPromotionInfo": {
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"dcRateAmt": 5000,
"minBuyAmt": 1000,
"maxDcAmt": 5000,
"isMaxYn": "Y",
"dcAmt": 5000,
"cpnIsuNo": "100000",
"goods": [
{
"goodsNo": "10000001",
"itmNo": "001",
"dcAmt": 5000
}
]
}
}{
"totalAccmAmt": 3000,
"accmList": [
{
"accmGbCd": "21",
"accmRate": 10,
"accmAmt": 3000,
"promoNo": "C1000000",
"promoNm": "프로모션 명",
"promoTypCd": "40",
"ourChrgRate": 100,
"entrChrgRate": 0,
"fixamtFxrtGbCd": "01",
"rsrvStdAmt": 5000,
"goodsAccmList": [
{
"goodsNo": "10000001",
"itmNo": "001",
"accmAmt": 3000
}
]
}
]
}마지막 업데이트