프로모션 사은행사

사은행사 적용가능여부 확인

post

기능설명

선택한 사은행사가 실제 사용 가능한 사은행사인지 확인합니다.

상세설명

비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.
선택한 사은행사가 실제 적용조건에 부합하는지 체크합니다.
현재 구매한 상품에 혜택을 적용한 금액이 선택한 사은행사의 금액 조건에 부합하는지 체크합니다.

특이사항

연관된 API 목록

단품 상세조회: /api/goods/v1/detail/goods

수정번호

Release v1.06_231218 : 사은행사 중복 조회 수정

Header parameters

AuthorizationanyOptional

Access Token

Body

사은행사 선택 Request

ordMediaCdstring · enumRequired

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

Example: 20Possible values:

baseDtmstring · date-timeOptional

기준일시

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post/v1/marketing/orderAeEvtList

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

{
  "ordMediaCd": "20",
  "baseDtm": "2026-01-01T00:00:00.000Z",
  "goodsInfo": [
    {
      "goodsNo": "10000001",
      "itmNo": "001",
      "salePrc": 7000,
      "cnt": 1,
      "aeNo": "C1000000",
      "aeGoodsNo": "10000001",
      "aeGoodsItmNo": "001"
    }
  ]
}

{
  "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"
        }
      ]
    }
  ]
}

주문서 사은행사 조회

post

기능설명

현재 주문에서 선택할 수 있는 사은행사 목록을 조회합니다.

상세설명

비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.
여러 상품에 동일한 사은행사가 적용이 가능하다면, 하나의 상품에만 적용됩니다.
상품을 선택하는 기준은 아래와 같습니다.
- 판매가 : 내림차순
- 상품번호 : 올림차순
- 단품번호 : 올림차순

Header parameters

AuthorizationanyOptional

Access Token

Body

사은행사 선택 Request

ordMediaCdstring · enumRequired

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

Example: 20Possible values:

baseDtmstring · date-timeOptional

기준일시

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post/v1/marketing/chooseAeEvtList

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

{
  "ordMediaCd": "20",
  "baseDtm": "2026-01-01T00:00:00.000Z",
  "goodsInfo": [
    {
      "goodsNo": "10000001",
      "itmNo": "001",
      "salePrc": 7000,
      "cnt": 1,
      "aeNo": "C1000000",
      "aeGoodsNo": "10000001",
      "aeGoodsItmNo": "001"
    }
  ]
}

{
  "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"
        }
      ]
    }
  ]
}

상품상세 사은행사 조회

post

기능설명

상품 상세에서 사용가능한 사은행사 리스트를 조회합니다.

상세설명

비회원은 해당 API를 사용할 수 없는 회원 전용 API입니다.
상품에 선택 가능한 사은행사 정보를 조회합니다.
선택 가능한 사은행사 중 사은품이 아래 조건에 맞는 사은행사만 조회됩니다.
- 재고 : 존재
- 사은품 상태 : 판매중
- 배송유형 : 합배송

Header parameters

AuthorizationanyOptional

Access Token

Body

사은행사 선택 Request

ordMediaCdstring · enumRequired

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

Example: 20Possible values:

baseDtmstring · date-timeOptional

기준일시

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post/v1/marketing/aeEvtList

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

{
  "ordMediaCd": "20",
  "baseDtm": "2026-01-01T00:00:00.000Z",
  "goodsInfo": [
    {
      "goodsNo": "10000001",
      "itmNo": "001",
      "salePrc": 7000,
      "cnt": 1,
      "aeNo": "C1000000",
      "aeGoodsNo": "10000001",
      "aeGoodsItmNo": "001"
    }
  ]
}

{
  "ANY_ADDITIONAL_PROPERTY": [
    {
      "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"
        }
      ]
    }
  ]
}

이전프로모션 할인

다음쿠폰 발급

마지막 업데이트 2개월 전