프로모션 검증

프로모션 정보 검증

post

기능설명

• 주문 생성시 사용자가 선택/사용한 프로모션 정보가 실제로 사용 가능한지 검증합니다.

---

상세설명

• 비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.

• 사용자가 선택한 정보를 기반으로 다시 한번 계산/검증 하여 계산 결과가 동일한지 비교합니다.

• 만약, 결과가 다른 경우에는 주문을 생성할 수 없습니다.

• 검증내용

  • 할인정보

  • 배송비쿠폰정보

  • 사은행사 정보

  • 적립 정보

---

수정번호

• Release v1.03_231106: 임직원 할인 한도 관리 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

프로모션 주문 생성 검증 Request

mbrNostringRequired

회원번호

Example: 100000000

mbrGradeCdstring · enumRequired

회원등급코드(ME008) 10 : GREEN , 20 : FAMILY , 30 : GOLD , 40 : VIP , 50 : VVIP

Example: 10Possible values:

comGbCdstringRequired

회사구분코드(ME038)

Example: P00

stafYnstringRequired

임직원여부

Example: Y

ordMediaCdstring · enumRequired

주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문

Example: 20Possible values:

baseDtmstring · date-timeRequired

기준일시

Responses

200

성공

*/*

booleanOptional

900

업무처리 오류 내용

*/*

post

/v1/marketing/validatePromotionInfo

HTTPcURLJavaScriptPython

POST /api/order/v1/marketing/validatePromotionInfo HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 2041

{
  "mbrNo": "100000000",
  "mbrGradeCd": "10",
  "comGbCd": "P00",
  "stafYn": "Y",
  "ordMediaCd": "20",
  "baseDtm": "2026-02-27T18:08:01.207Z",
  "goodsList": [
    {
      "goodsNo": "10000001",
      "itmNo": "001",
      "supPcost": 5000,
      "salePrc": 7000,
      "stdCtgNo": "EX00000000",
      "dispCtgNo": "000",
      "brandNo": "100000",
      "entrNo": "1000000",
      "chlNo": "1000000",
      "marketingDisplayNo": "1000000",
      "cnt": 1
    }
  ],
  "bnfResponse": {
    "totalDcAmt": 10000,
    "goodsBenefitList": [
      {
        "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"
          }
        ]
      }
    ],
    "orderBenefitList": [
      {
        "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
          }
        ]
      }
    ]
  },
  "dlvResponse": {
    "deliNo": "100000001",
    "entrNo": "1000000",
    "benefitInfo": {
      "promoNo": "C1000000",
      "promoNm": "프로모션 명",
      "promoTypCd": "11",
      "ourChrgRate": 100,
      "entrChrgRate": 0,
      "cpnIsuNo": "100000",
      "ordCostGbCd": "10"
    }
  },
  "accmResponse": {
    "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
          }
        ]
      }
    ]
  },
  "aeEvtListResponse": [
    {
      "goodsNo": "10000001",
      "itmNo": "001",
      "aeNo": "C1000000",
      "addEvtTypCd": "20",
      "aeStrDtm": "2026-02-27T18:08:01.207Z",
      "aeEndDtm": "2026-02-27T18:08:01.207Z",
      "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"
        }
      ]
    }
  ]
}

true