> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/store-front-api/order-api/undefined-16.md).

# 이벤트 제공

## 사은품 배송지 저장

> \## 기능 설명\
> \- 이벤트 사은품 배송을 위해 배송지를 등록, 수정합니다.\
> \---\
> \## 상세 설명\
> \- \*\*기타사은품배송지번호\*\*가 없을 경우 배송지 등록\
> \- \*\*기타사은품배송지번호\*\*가 있을 경우 배송지 수정\
> \- 수정 시 배송지 정보만 변경 가능합니다.\
>     \- \*(수취인, 수취인 전화번호, 배송지, 배송지상세 등)\*\
> \- 등록, 수정 완료 시 \*\*기타사은품배송지번호\*\*는 필수로 전달합니다.<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/event/registModifyEtcGftDlvp":{"post":{"tags":["이벤트 제공"],"summary":"사은품 배송지 저장","description":"## 기능 설명\n- 이벤트 사은품 배송을 위해 배송지를 등록, 수정합니다.\n---\n## 상세 설명\n- **기타사은품배송지번호**가 없을 경우 배송지 등록\n- **기타사은품배송지번호**가 있을 경우 배송지 수정\n- 수정 시 배송지 정보만 변경 가능합니다.\n    - *(수취인, 수취인 전화번호, 배송지, 배송지상세 등)*\n- 등록, 수정 완료 시 **기타사은품배송지번호**는 필수로 전달합니다.\n","operationId":"registModifyEtcGftDlvp","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EtcGftDlvpRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EtcGftDlvpResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EtcGftDlvpRequest":{"type":"object","properties":{"etcGftDlvpNo":{"type":"string","description":"기타사은품배송지번호","nullable":true,"enum":["null","기타사은품배송지번호"]},"etcGftIssuSubCd":{"type":"string","description":"기타사은품발급주체코드(MK022)(등록 시 필수)","nullable":true,"enum":["10"]},"etcGftIssuSubNo":{"type":"string","description":"기타사은품발급주체번호","nullable":true},"etcGftIssuSubDtlNo":{"type":"string","description":"기타사은품발급주체상세번호","nullable":true},"etcGftNm":{"type":"string","description":"사은품명","nullable":true},"mbrNo":{"type":"string","description":"고객번호","nullable":true},"mbrNm":{"type":"string","description":"고객명","nullable":true},"loginId":{"type":"string","description":"회원ID","nullable":true},"goodsNo":{"type":"string","description":"상품번호","nullable":true},"goodsNm":{"type":"string","description":"상품명","nullable":true},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"deliMsg":{"type":"string","description":"배송메시지","nullable":true},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법","nullable":true},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호","nullable":true},"sysRegId":{"type":"string","description":"등록자ID"},"winRnk":{"type":"integer","description":"당첨자등수","format":"int32","nullable":true},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040)","nullable":true,"enum":["10","20","30"]}},"description":"사은품 배송지 등록/수정 Request"},"EtcGftDlvpResponse":{"type":"object","properties":{"etcGftDlvpNo":{"type":"string","description":"기타사은품배송지번호"},"etcGftIssuSubNo":{"type":"string","description":"기타사은품발급주체번호","nullable":true},"etcGftIssuSubDtlNo":{"type":"string","description":"기타사은품발급주체상세번호","nullable":true},"winRnk":{"type":"integer","description":"당첨자등수","format":"int32","nullable":true}},"description":"사은품 배송지 등록/수정 Request"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```

## 이벤트 대상 금액 조회

> \## 기능 설명\
> \- 회원의 요청 기간 내 요청 기준에 부합하는 주문 금액 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \- 취소나 반품을 진행한 주문 금액은 차감 또는 제외합니다.\
> \- 요청 내의 필드 기준들은 AND 조건으로 조회하고 필드 기준 내의 정보(목록 안의 값)들은 OR 조건으로 조회합니다.<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/event/evtOrdList":{"post":{"tags":["이벤트 제공"],"summary":"이벤트 대상 금액 조회","description":"## 기능 설명\n- 회원의 요청 기간 내 요청 기준에 부합하는 주문 금액 목록을 조회합니다.\n---\n## 상세 설명\n- 취소나 반품을 진행한 주문 금액은 차감 또는 제외합니다.\n- 요청 내의 필드 기준들은 AND 조건으로 조회하고 필드 기준 내의 정보(목록 안의 값)들은 OR 조건으로 조회합니다.\n","operationId":"getMemberEventOrderAmtList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderAmtRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderAmtInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrderAmtRequest":{"required":["buyEndDtm","buyStrDtm","mbrNo"],"type":"object","properties":{"mbrNo":{"type":"string","description":"고객번호"},"buyStrDtm":{"type":"string","description":"구매기간시작일시","format":"date-time"},"buyEndDtm":{"type":"string","description":"구매기간종료일시","format":"date-time"},"siteList":{"type":"array","description":"사이트 리스트(적용대상)","items":{"type":"string","description":"사이트 리스트(적용대상)"}},"categoryList":{"type":"array","description":"카테고리 리스트(적용대상)","items":{"type":"string","description":"카테고리 리스트(적용대상)"}},"exCategoryList":{"type":"array","description":"카테고리 리스트(제외대상)","items":{"type":"string","description":"카테고리 리스트(제외대상)"}},"mkDisplayList":{"type":"array","description":"기획전 리스트(적용대상)","items":{"type":"string","description":"기획전 리스트(적용대상)"}},"brandList":{"type":"array","description":"브랜드 리스트(적용대상)","items":{"type":"string","description":"브랜드 리스트(적용대상)"}},"goodsList":{"type":"array","description":"상품 리스트(적용대상)","items":{"type":"string","description":"상품 리스트(적용대상)"}},"exGoodsList":{"type":"array","description":"상품 리스트(제외대상)","items":{"type":"string","description":"상품 리스트(제외대상)"}},"channelList":{"type":"array","description":"채널 리스트(적용대상)","items":{"type":"string","description":"채널 리스트(적용대상)"}}},"description":"이벤트 대상 금액 조회 Request"},"OrderAmtInfoResponse":{"type":"object","properties":{"orderList":{"type":"array","description":"주문내역","items":{"$ref":"#/components/schemas/OrderAmtInfo"}},"totOrdAmt":{"type":"integer","description":"주문내역 총 주문금액","format":"int64"}},"description":"이벤트 대상 금액 조회 Response"},"OrderAmtInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordDtm":{"type":"string","description":"주문일시","format":"date-time"},"ordAmt":{"type":"integer","description":"주문금액","format":"int64"}},"description":"주문정보"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```