프로모션 사은행사

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

post

기능설명

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

---

상세설명

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

• 선택한 사은행사가 실제 적용조건에 부합하는지 체크합니다.

• 현재 구매한 상품에 혜택을 적용한 금액이 선택한 사은행사의 금액 조건에 부합하는지 체크합니다.

---

특이사항

연관된 API 목록

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

---

수정번호

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

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

사은행사 선택 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

HTTPcURLJavaScriptPython

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

{
  "ordMediaCd": "20",
  "baseDtm": "2026-02-27T18:08:09.407Z",
  "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-02-27T18:08:09.407Z",
      "aeEndDtm": "2026-02-27T18:08:09.407Z",
      "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

application/json

사은행사 선택 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

HTTPcURLJavaScriptPython

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

{
  "ordMediaCd": "20",
  "baseDtm": "2026-02-27T18:08:09.407Z",
  "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-02-27T18:08:09.407Z",
      "aeEndDtm": "2026-02-27T18:08:09.407Z",
      "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

application/json

사은행사 선택 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

HTTPcURLJavaScriptPython

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

{
  "ordMediaCd": "20",
  "baseDtm": "2026-02-27T18:08:09.407Z",
  "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-02-27T18:08:09.407Z",
      "aeEndDtm": "2026-02-27T18:08:09.407Z",
      "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"
        }
      ]
    }
  ]
}