이벤트 제공

사은품 배송지 저장

post

기능 설명

• 이벤트 사은품 배송을 위해 배송지를 등록, 수정합니다.

---

상세 설명

• 기타사은품배송지번호가 없을 경우 배송지 등록

• 기타사은품배송지번호가 있을 경우 배송지 수정

• 수정 시 배송지 정보만 변경 가능합니다.

  • (수취인, 수취인 전화번호, 배송지, 배송지상세 등)

• 등록, 수정 완료 시 기타사은품배송지번호는 필수로 전달합니다.

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject[]

application/json

사은품 배송지 등록/수정 Request

etcGftDlvpNostring · enum · nullableOptional

기타사은품배송지번호

Example: 등록 시 null, 수정 시 기타사은품배송지번호Possible values:

etcGftIssuSubCdstring · enum · nullableOptional

기타사은품발급주체코드(MK022)(등록 시 필수)

Example: 10Possible values:

etcGftIssuSubNostring · nullableOptional

기타사은품발급주체번호

Example: 1

etcGftIssuSubDtlNostring · nullableOptional

기타사은품발급주체상세번호

Example: 1

etcGftNmstring · nullableOptional

사은품명

Example: 10

mbrNostring · nullableOptional

고객번호

Example: 100000631

mbrNmstring · nullableOptional

고객명

Example: 홍길동

loginIdstring · nullableOptional

회원ID

Example: honggildong

goodsNostring · nullableOptional

상품번호

Example: 100000001

goodsNmstring · nullableOptional

상품명

Example: 상품명

rcvmnNmstringOptional

수취인명

Example: 홍길동

zipNostringOptional

우편번호

Example: 55221

zipAddrstringOptional

우편주소

Example: 서울특별시 송파구 법원로10길 H비지니스파크

dtlAddrstringOptional

상세주소

Example: 6층

cellSctNostringOptional

휴대폰구분번호

Example: 010

cellTxnoNostringOptional

휴대폰국번번호

Example: 1111

cellEndNostringOptional

휴대폰끝번호

Example: 2222

deliMsgstring · nullableOptional

배송메시지

Example: 10

comnFrdrEtcMethodstring · nullableOptional

공동현관기타방법

Example: 기타 방법입니다.

comnFrdrPwdstring · nullableOptional

공동현관비밀번호

Example: 1234

sysRegIdstringOptional

등록자ID

Example: admin

winRnkinteger · int32 · nullableOptional

당첨자등수

Example: 1

comnFrdrCogoMethodCdstring · enum · nullableOptional

공동현관출입방법코드(ME040)

Example: 10Possible values:

Responses

200

성공

*/*

사은품 배송지 등록/수정 Request

etcGftDlvpNostringOptional

기타사은품배송지번호

Example: 1

etcGftIssuSubNostring · nullableOptional

기타사은품발급주체번호

Example: 1

etcGftIssuSubDtlNostring · nullableOptional

기타사은품발급주체상세번호

Example: 1

winRnkinteger · int32 · nullableOptional

당첨자등수

Example: 1

900

업무처리 오류 내용

*/*

post

/v1/event/registModifyEtcGftDlvp

HTTPcURLJavaScriptPython

POST /api/order/v1/event/registModifyEtcGftDlvp HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 598

[
  {
    "etcGftDlvpNo": "등록 시 null, 수정 시 기타사은품배송지번호",
    "etcGftIssuSubCd": "10",
    "etcGftIssuSubNo": "1",
    "etcGftIssuSubDtlNo": "1",
    "etcGftNm": "10",
    "mbrNo": "100000631",
    "mbrNm": "홍길동",
    "loginId": "honggildong",
    "goodsNo": "100000001",
    "goodsNm": "상품명",
    "rcvmnNm": "홍길동",
    "zipNo": "55221",
    "zipAddr": "서울특별시 송파구 법원로10길 H비지니스파크",
    "dtlAddr": "6층",
    "cellSctNo": "010",
    "cellTxnoNo": "1111",
    "cellEndNo": "2222",
    "deliMsg": "10",
    "comnFrdrEtcMethod": "기타 방법입니다.",
    "comnFrdrPwd": "1234",
    "sysRegId": "admin",
    "winRnk": 1,
    "comnFrdrCogoMethodCd": "10"
  }
]

[
  {
    "etcGftDlvpNo": "1",
    "etcGftIssuSubNo": "1",
    "etcGftIssuSubDtlNo": "1",
    "winRnk": 1
  }
]

이벤트 대상 금액 조회

post

기능 설명

• 회원의 요청 기간 내 요청 기준에 부합하는 주문 금액 목록을 조회합니다.

---

상세 설명

• 취소나 반품을 진행한 주문 금액은 차감 또는 제외합니다.

• 요청 내의 필드 기준들은 AND 조건으로 조회하고 필드 기준 내의 정보(목록 안의 값)들은 OR 조건으로 조회합니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

이벤트 대상 금액 조회 Request

mbrNostringRequired

고객번호

Example: 100000001

buyStrDtmstring · date-timeRequired

구매기간시작일시

buyEndDtmstring · date-timeRequired

구매기간종료일시

siteListstring[]Optional

사이트 리스트(적용대상)

Example: ["1"]

categoryListstring[]Optional

카테고리 리스트(적용대상)

Example: ["10000002"]

exCategoryListstring[]Optional

카테고리 리스트(제외대상)

Example: ["10000003"]

mkDisplayListstring[]Optional

기획전 리스트(적용대상)

Example: ["19865"]

brandListstring[]Optional

브랜드 리스트(적용대상)

Example: ["100003"]

goodsListstring[]Optional

상품 리스트(적용대상)

Example: ["10002632"]

exGoodsListstring[]Optional

상품 리스트(제외대상)

Example: ["10002634"]

channelListstring[]Optional

채널 리스트(적용대상)

Example: ["1"]

Responses

200

성공

*/*

이벤트 대상 금액 조회 Response

totOrdAmtinteger · int64Optional

주문내역 총 주문금액

Example: 3110

900

업무처리 오류 내용

*/*

post

/v1/event/evtOrdList

HTTPcURLJavaScriptPython

POST /api/order/v1/event/evtOrdList HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 295

{
  "mbrNo": "100000001",
  "buyStrDtm": "2026-02-27T18:08:01.207Z",
  "buyEndDtm": "2026-02-27T18:08:01.207Z",
  "siteList": [
    "1"
  ],
  "categoryList": [
    "10000002"
  ],
  "exCategoryList": [
    "10000003"
  ],
  "mkDisplayList": [
    "19865"
  ],
  "brandList": [
    "100003"
  ],
  "goodsList": [
    "10002632"
  ],
  "exGoodsList": [
    "10002634"
  ],
  "channelList": [
    "1"
  ]
}

{
  "orderList": [
    {
      "ordNo": "20230809O007055",
      "ordDtm": "2026-02-27T18:08:01.207Z",
      "ordAmt": 3110
    }
  ],
  "totOrdAmt": 3110
}