이벤트 사은품 배송관리

이벤트 사은품 배송관리 저장

post

기능 설명

• 이벤트 사은품 배송 처리를 진행합니다.

---

상세 내용

• 이벤트 사은품 배송관리 화면에서 이벤트 사은품 배송 처리를 진행합니다.

• 이벤트 사은품 출고완료, 배송완료 처리를 진행합니다.

• 이벤트 사은품 배송관리 수정 대상 리스트는 필수값입니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

이벤트사은품배송관리 수정 요청 DTO

Responses

200

이벤트 사은품 배송관리 저장 성공

No content

900

업무처리 오류 내용

*/*

post

/v1/delivery/eventEtcGiftDeliveryMgmt/saveEventEtcGiftDeliveryProcess

HTTPcURLJavaScriptPython

POST /api/bo/v1/delivery/eventEtcGiftDeliveryMgmt/saveEventEtcGiftDeliveryProcess HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "eventEtcGiftDeliverySaveInfoList": [
    {
      "etcGftDlvpNo": 11,
      "etcGftStatCd": 10,
      "invNo": 123456789,
      "hdcCd": 10
    }
  ]
}

No content

이벤트 사은품 배송관리 조회

get

기능 설명

• 이벤트 사은품 배송관리 목록을 조회 합니다.

---

상세 설명

• 이벤트 사은품 배송 관리 화면의 이벤트 사은품 목록을 조회합니다.

• 기타사은품상태코드(LO013)가 출고지시(20), 출고완료(30), 배송완료(40)인 건만 조회합니다.

• 조회기간구분, 조회시작일, 조회종료일, 주문내역상태(기타사은품상태)는 필수값입니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

searchPeriodTypeStringRequired

조회기간 구분

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

eventInfoTypeStringOptional

이벤트 정보 구분

eventInfoStringOptional

이벤트 정보

etcGftStatCdStringRequired

주문내역상태

goodsNoStringOptional

상품번호

qryGbCdStringOptional

조회구분(UR014)

indInfoQryCausStringOptional

개인정보조회사유

Responses

200

이벤트 사은품 배송관리 조회 성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/delivery/eventEtcGiftDeliveryMgmt/getEventEtcGiftDeliveryInfoList

HTTPcURLJavaScriptPython

GET /api/bo/v1/delivery/eventEtcGiftDeliveryMgmt/getEventEtcGiftDeliveryInfoList?eventEtcGiftDeliveryRequest=[object+Object]&searchPeriodType=null&startDate=null&endDate=null&etcGftStatCd=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "etcGftDlvpNo": 11,
      "etcGftIssuSubCd": 10,
      "etcGftIssuSubNo": 1,
      "etcGftIssuSubDtlNo": 1,
      "etcGftStatCd": 10,
      "etcGftStatNm": "출고지시",
      "mbrNo": 100001311,
      "goodsNo": 10002042,
      "rcvmnNm": "홍길동",
      "zipNo": "05836",
      "zipAddr": "서울 송파구 법원로9길 26",
      "dtlAddr": "101동",
      "cellSctNo": "010",
      "cellTxnoNo": 1234,
      "cellEndNo": 5678,
      "deliMsg": "부재시 문앞에 두고 가주세요",
      "comnFrdrEtcMethod": "자유 출입 가능",
      "comnFrdrPwd": 123456,
      "hdcCd": 10,
      "invNo": 123456789,
      "evtNo": 15132,
      "evtNm": "출석체크 이벤트",
      "goodsNm": "상품명",
      "loginId": "login",
      "mbrNm": "홍길동",
      "shipFnshDtm": "yyyy-MM-dd HH:mm:ss",
      "deliFnshDtm": "yyyy-MM-dd HH:mm:ss",
      "fullAddr": "서울 송파구 동남로 99 1층",
      "shipIndiDtm": "yyyy-MM-dd HH:mm:ss"
    }
  ]
}

이벤트 사은품 배송관리 대량 데이터 엑셀 다운로드 조회

get

기능 설명

• 대량 데이터 엑셀 다운로드 목록을 조회 합니다.

---

상세 내용

• 이벤트 사은품 배송관리 화면에서 대량 데이터 엑셀로 다운로드합니다.

• 조회기간구분, 조회시작일, 조회종료일, 주문내역상태(기타사은품상태)는 필수값입니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

searchPeriodTypeStringRequired

조회기간 구분

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

eventInfoTypeStringOptional

이벤트 정보 구분

eventInfoStringOptional

이벤트 정보

etcGftStatCdStringRequired

주문내역상태

goodsNoStringOptional

상품번호

qryGbCdStringOptional

조회구분(UR014)

indInfoQryCausStringOptional

개인정보조회사유

Responses

200

이벤트 사은품 배송관리 대량 데이터 엑셀 다운로드 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v1/delivery/eventEtcGiftDeliveryMgmt/getEventEtcGiftDeliveryExcelData

HTTPcURLJavaScriptPython

GET /api/bo/v1/delivery/eventEtcGiftDeliveryMgmt/getEventEtcGiftDeliveryExcelData?eventEtcGiftDeliveryRequest=[object+Object]&searchPeriodType=null&startDate=null&endDate=null&etcGftStatCd=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T18:20:39.093Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

사은품 출고완료 일괄등록 유효성 검사 대상 데이터 조회

get

기능 설명

• 사은품 출고완료 일괄등록 유효성 검사 시 대상 데이터를 조회합니다.

---

상세 내용

• 이벤트 사은품 배송 관리 >> 일괄등록 팝업 화면에서 엑셀 일괄 업로드시 유효성 검사를 위한 상세 목록을 조회합니다.

• 사은품 배송번호 목록은 필수값입니다.

---

수정번호

• Release v2.00_240829 : 기본주소 마스킹 추가

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

etcGftDlvpNoListListRequired

사은품 배송번호 리스트

Responses

200

사은품 출고완료 일괄등록 유효성 검사 대상 데이터 조회 성공

*/*

이벤트사은품배송조회 응답 DTO

etcGftDlvpNostringOptional

사은품배송번호

Example: 11

etcGftIssuSubCdstringOptional

사은품발급주체코드(MK022)

Example: 10

etcGftIssuSubNostringOptional

사은품발급주체번호

Example: 1

etcGftIssuSubDtlNostringOptional

사은품발급주체상세번호

Example: 1

etcGftStatCdstringOptional

주문내역상태코드(LO013)

Example: 10

etcGftStatNmstringOptional

주문내역상태명

Example: 출고지시

mbrNostringOptional

회원번호

Example: 100001311

goodsNostringOptional

상품번호

Example: 10002042

rcvmnNmstringOptional

수취인명

Example: 홍길동

zipNostringOptional

우편번호

Example: 05836

zipAddrstringOptional

우편주소

Example: 서울 송파구 법원로9길 26

dtlAddrstringOptional

상세주소

Example: 101동

cellSctNostringOptional

휴대폰구분번호

Example: 010

cellTxnoNostringOptional

휴대폰국번번호

Example: 1234

cellEndNostringOptional

휴대폰끝번호

Example: 5678

deliMsgstringOptional

배송메시지

Example: 부재시 문앞에 두고 가주세요

comnFrdrEtcMethodstringOptional

공동현관기타방법

Example: 자유 출입 가능

comnFrdrPwdstringOptional

공동현관비밀번호

Example: 123456

hdcCdstringOptional

택배사코드

Example: 10

invNostringOptional

송장번호

Example: 123456789

evtNostringOptional

이벤트번호

Example: 15132

evtNmstringOptional

이벤트명

Example: 출석체크 이벤트

goodsNmstringOptional

상품명

Example: 상품명

loginIdstringOptional

로그인ID

Example: login

mbrNmstringOptional

회원명

Example: 홍길동

shipFnshDtmstring · date-timeOptional

출고완료일시

Example: yyyy-MM-dd HH:mm:ss

deliFnshDtmstring · date-timeOptional

배송완료일시

Example: yyyy-MM-dd HH:mm:ss

fullAddrstringOptional

주소

Example: 서울 송파구 동남로 99 1층

shipIndiDtmstring · date-timeOptional

출고지시일시

Example: yyyy-MM-dd HH:mm:ss

900

업무처리 오류 내용

*/*

get

/v1/delivery/eventEtcGiftDeliveryMgmt/getEventEtcGiftBatchRegisterValidList

HTTPcURLJavaScriptPython

GET /api/bo/v1/delivery/eventEtcGiftDeliveryMgmt/getEventEtcGiftBatchRegisterValidList?eventEtcGiftBatchRegisterValidRequest=[object+Object]&etcGftDlvpNoList=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "etcGftDlvpNo": 11,
    "etcGftIssuSubCd": 10,
    "etcGftIssuSubNo": 1,
    "etcGftIssuSubDtlNo": 1,
    "etcGftStatCd": 10,
    "etcGftStatNm": "출고지시",
    "mbrNo": 100001311,
    "goodsNo": 10002042,
    "rcvmnNm": "홍길동",
    "zipNo": "05836",
    "zipAddr": "서울 송파구 법원로9길 26",
    "dtlAddr": "101동",
    "cellSctNo": "010",
    "cellTxnoNo": 1234,
    "cellEndNo": 5678,
    "deliMsg": "부재시 문앞에 두고 가주세요",
    "comnFrdrEtcMethod": "자유 출입 가능",
    "comnFrdrPwd": 123456,
    "hdcCd": 10,
    "invNo": 123456789,
    "evtNo": 15132,
    "evtNm": "출석체크 이벤트",
    "goodsNm": "상품명",
    "loginId": "login",
    "mbrNm": "홍길동",
    "shipFnshDtm": "yyyy-MM-dd HH:mm:ss",
    "deliFnshDtm": "yyyy-MM-dd HH:mm:ss",
    "fullAddr": "서울 송파구 동남로 99 1층",
    "shipIndiDtm": "yyyy-MM-dd HH:mm:ss"
  }
]