이벤트 제공

사은품 배송지 저장

post

기능 설명

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

상세 설명

기타사은품배송지번호가 없을 경우 배송지 등록
기타사은품배송지번호가 있을 경우 배송지 수정
수정 시 배송지 정보만 변경 가능합니다.
- (수취인, 수취인 전화번호, 배송지, 배송지상세 등)
등록, 수정 완료 시 기타사은품배송지번호는 필수로 전달합니다.

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject · EtcGftDlvpRequest[]

사은품 배송지 등록/수정 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

POST /api/order/v1/event/registModifyEtcGftDlvp HTTP/1.1
Host: api-order.x2bee.com/
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

이벤트 대상 금액 조회 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

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

{
  "mbrNo": "100000001",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "siteList": [
    "1"
  ],
  "categoryList": [
    "10000002"
  ],
  "exCategoryList": [
    "10000003"
  ],
  "mkDisplayList": [
    "19865"
  ],
  "brandList": [
    "100003"
  ],
  "goodsList": [
    "10002632"
  ],
  "exGoodsList": [
    "10002634"
  ],
  "channelList": [
    "1"
  ]
}

{
  "orderList": [
    {
      "ordNo": "20230809O007055",
      "ordDtm": "2026-01-01T00:00:00.000Z",
      "ordAmt": 3110
    }
  ],
  "totOrdAmt": 3110
}

이전쿠폰 발급

다음회수

마지막 업데이트 3개월 전