Promotion Validation

Validate Promotion Information

post

Function Description

• Validates whether the promotion information selected/used by the user when creating an order is actually usable.

---

Detailed Description

• This is a member-only API; non-members cannot use it.

• Recalculates/re-validates based on the information selected by the user and compares whether the calculation result matches.

• If the result differs, the order cannot be created.

• Validation content

  • Discount information

  • Delivery fee coupon information

  • Gift event information

  • Accrual information

---

Revision History

• Release v1.03_231106: Added employee discount limit management

Header parameters

AuthorizationanyOptional

Access Token

Body

Promotion Order Creation Validation Request

mbrNostringRequired

Member No.

Example: 100000000

mbrGradeCdstring · enumRequired

Member Grade Code (ME008) 10 : GREEN , 20 : FAMILY , 30 : GOLD , 40 : VIP , 50 : VVIP

Example: 10Possible values:

comGbCdstringRequired

Company Classification Code (ME038)

Example: P00

stafYnstringRequired

Employee Status

Example: Y

ordMediaCdstring · enumRequired

Order Channel Code (OM007) 10 : Phone Consultation (CC) , 20 : PC , 30 : Mobile Web , 40 : Android App , 50 : iOS App , 60 : Subscription Order

Example: 20Possible values:

baseDtmstring · date-timeRequired

Reference Date/Time

Responses

200

Success

*/*

booleanOptional

900

Business processing error details

*/*

post/v1/marketing/validatePromotionInfo

POST /api/order/v1/marketing/validatePromotionInfo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 2038

{
  "mbrNo": "100000000",
  "mbrGradeCd": "10",
  "comGbCd": "P00",
  "stafYn": "Y",
  "ordMediaCd": "20",
  "baseDtm": "2026-01-01T00:00:00.000Z",
  "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-01-01T00:00:00.000Z",
      "aeEndDtm": "2026-01-01T00:00:00.000Z",
      "payStrDt": "20231201",
      "payEndDt": "20231231",
      "tmEvtYn": "N",
      "aplyStrTm": 800,
      "aplyEndTm": "2359",
      "aeDesc": "사은행사 설명",
      "aeNm": "사은행사 명",
      "aeGoodsList": [
        {
          "aeFvrSeq": "1",
          "aplyMinAmt": 5000,
          "aplyMaxAmt": 10000,
          "aeGoodsNm": "사은품 명",
          "aeGoodsNo": "10000001",
          "aeGoodsItmNo": "001",
          "aeGoodsImgPath": "/path/image001.png"
        }
      ]
    }
  ]
}

true