# 이벤트 제공
## 사은품 배송지 저장
> \## 기능 설명\
> \- 이벤트 사은품 배송을 위해 배송지를 등록, 수정합니다.\
> \---\
> \## 상세 설명\
> \- \*\*기타사은품배송지번호\*\*가 없을 경우 배송지 등록\
> \- \*\*기타사은품배송지번호\*\*가 있을 경우 배송지 수정\
> \- 수정 시 배송지 정보만 변경 가능합니다.\
> \- \*(수취인, 수취인 전화번호, 배송지, 배송지상세 등)\*\
> \- 등록, 수정 완료 시 \*\*기타사은품배송지번호\*\*는 필수로 전달합니다.
```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 조건으로 조회합니다.
```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"}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/store-front-api/order-api/undefined-17.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.