> 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/event-api/undefined-2.md).
# 이벤트 공통
## 회원 기본 배송지 병합 처리
> \## 기능 설명\
> \* 회원 기본 배송지 병합하는 API 입니다.\
> \---\
> \## 상세 설명\
> \* order DB 의 회원 배송지 정보를 event DB의 회원 배송지 정보와 동기화합니다.\
> \* 회원 배송지 정보 컬럼에 대한 모든 파라미터를 필요로합니다.\
> \* API-BO , API-MEMBER , event BATCH 에서 호출합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/common/mergeMbrDlvp":{"post":{"tags":["이벤트 공통"],"summary":"회원 기본 배송지 병합 처리","description":" ## 기능 설명\n * 회원 기본 배송지 병합하는 API 입니다.\n ---\n ## 상세 설명\n * order DB 의 회원 배송지 정보를 event DB의 회원 배송지 정보와 동기화합니다.\n * 회원 배송지 정보 컬럼에 대한 모든 파라미터를 필요로합니다.\n * API-BO , API-MEMBER , event BATCH 에서 호출합니다.\n","operationId":"mergeMbrDlvp","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EtMbrDlvpInfoRequest"}}},"required":true},"responses":{"200":{"description":"회원 기본 배송지 병합 성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"회원 기본 배송지 병합 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EtMbrDlvpInfoRequest":{"type":"object","description":"회원 배송 정보 Request","properties":{"mbrNo":{"type":"string","description":"회원번호"},"etMbrDlvpInfo":{"type":"array","description":"회원 배송 정보 List","items":{"$ref":"#/components/schemas/EtMbrDlvpInfo"}}}},"EtMbrDlvpInfo":{"type":"object","description":"회원 배송 정보","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrDlvpSeq":{"type":"string","description":"회원배송지순번"},"dlvpGbCd":{"type":"string","description":"배송지구분코드(ME044)"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"baseDlvpYn":{"type":"string","description":"기본배송지여부"},"zipNoSeq":{"type":"integer","format":"int32","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":"휴대폰끝번호"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039)"},"deliMsg":{"type":"string","description":"배송메시지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"useYn":{"type":"string","description":"사용여부"},"userSortSeq":{"type":"integer","format":"int32","description":"사용자정렬순서"},"emailAddr":{"type":"string","description":"이메일"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}}}
```
## 회원 기본 정보 병합 처리
> \## 기능 설명\
> \* 회원 정보를 동기화 처리하는 API 입니다.\
> \---\
> \## 상세 설명\
> \* order DB 의 회원정보를 event DB의 회원정보와 동기화합니다.\
> \* 회원정보 컬럼에 대한 모든 파라미터를 필요로합니다.\
> \* api-member , event batch 에서 호출합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/common/mergeMbrBase":{"post":{"tags":["이벤트 공통"],"summary":"회원 기본 정보 병합 처리","description":" ## 기능 설명\n * 회원 정보를 동기화 처리하는 API 입니다.\n ---\n ## 상세 설명\n * order DB 의 회원정보를 event DB의 회원정보와 동기화합니다.\n * 회원정보 컬럼에 대한 모든 파라미터를 필요로합니다.\n * api-member , event batch 에서 호출합니다.\n","operationId":"mergeMbrBase","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EtMbrBaseRequest"}}},"required":true},"responses":{"200":{"description":"회원 기본 정보 병합 성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"회원 기본 정보 병합 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EtMbrBaseRequest":{"type":"object","description":"회원 정보 Request","properties":{"etMbrBase":{"$ref":"#/components/schemas/EtMbrBase","description":"회원 정보"}}},"EtMbrBase":{"type":"object","description":"회원 정보","properties":{"siteNo":{"type":"string","description":"가입사이트번호"},"sysRegDtm":{"type":"string","format":"date-time","description":"등록일시"},"sysRegId":{"type":"string","description":"등록자ID"},"sysModDtm":{"type":"string","format":"date-time","description":"수정일시"},"sysModId":{"type":"string","description":"수정자ID"},"mbrNo":{"type":"string","description":"회원번호"},"mbrGbCd":{"type":"string","description":"회원구분코드 (ME001 - 10:정회원, 99:비회원)"},"mbrMgrCd":{"type":"string","description":"회원관리코드 (ME002 - 10:통합회원, 20:일반회원, 30:소셜회원, 99:비회원)"},"mbrStatCd":{"type":"string","description":"회원상태코드(ME003 - 10:정상회원, 20:휴면회원, 30:탈퇴회원)"},"lgcMbrNo":{"type":"string","description":"기간계회원번호"},"lgcMbrYn":{"type":"string","description":"기간계회원여부"},"lgcWdraTgtYn":{"type":"string","description":"기간계탈퇴대상여부"},"cmbnMbspMbrNo":{"type":"string","description":"통합멤버쉽회원번호"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"pwd":{"type":"string","description":"비밀번호"},"mbrGradeCd":{"type":"string","description":"회원등급코드(ME008 - 10:GREEN, 20:FAMILY, 30:GOLD, 40:VIP, 50:VVIP)"},"solarYn":{"type":"string","description":"양력여부"},"brth":{"type":"string","description":"생년월일"},"sexGbCd":{"type":"string","description":"성별구분코드 (ME017 - M:남, F:여)"},"nafrGbCd":{"type":"string","description":"내외국인구분코드 (ME018 - 10:내국인, 20:외국인)"},"joinGbCd":{"type":"string","description":"가입구분코드(ME029)"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"frgnTelNo":{"type":"string","description":"해외전화번호"},"emailAddr":{"type":"string","description":"이메일주소"},"zipNoSeq":{"type":"integer","format":"int32","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"stafYn":{"type":"string","description":"임직원여부"},"empNo":{"type":"string","description":"사원번호"},"comGbCd":{"type":"string","description":"회사구분코드(ME038)"},"adlCertiYn":{"type":"string","description":"성인인증여부"},"adlCertiDtm":{"type":"string","format":"date-time","description":"성인인증일시"},"mbrJoinDtm":{"type":"string","format":"date-time","description":"회원가입일시"},"frstOrdDtm":{"type":"string","format":"date-time","description":"최초주문일시"},"lstOrdDtm":{"type":"string","format":"date-time","description":"최종주문일시"},"frstLoginDtm":{"type":"string","format":"date-time","description":"최초로그인일시"},"lstLoginDtm":{"type":"string","format":"date-time","description":"최종로그인일시"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"rcntPayWayCd":{"type":"string","description":"최근결제수단코드(OM013)"},"stafMgrNo":{"type":"string","description":"임직원관리번호"},"stafRegDt":{"type":"string","description":"임직원등록일자"},"stafRvcDt":{"type":"string","description":"임직원해제일자"},"cmbnMbspLoginId":{"type":"string","description":"통합멤버쉽로그인ID"},"payNo":{"type":"string","description":"결제번호"},"smpctAcctIntrlckGbCd":{"type":"string","description":"간편계정연동구분코드(ME052)"},"bmanRegNo":{"type":"string","description":"사업자등록번호"},"bmanRegDt":{"type":"string","description":"사업자등록일자"},"rpstmnNm":{"type":"string","description":"대표자명"},"repTelSctNo":{"type":"string","description":"대표전화지역번호"},"repTelTxnoNo":{"type":"string","description":"대표전화국번번호"},"repTelEndNo":{"type":"string","description":"대표전화끝번호"},"joinSgtStatCd":{"type":"string","description":"가입승인상태코드(ME058)"},"aprvRtrnCaus":{"type":"string","description":"승인반려사유"},"aprvRtrnDtm":{"type":"string","format":"date-time","description":"처리일시"},"mbrJoinReqDtm":{"type":"string","format":"date-time","description":"가입요청일시"},"bmanNm":{"type":"string","description":"사업체명"},"sysProcId":{"type":"string","description":"처리자"},"bplcZipNo":{"type":"string","description":"사업자등록증 우편번호"},"bplcZipAddr":{"type":"string","description":"사업자등록증 우편주소"},"bplcDtlAddr":{"type":"string","description":"사업자등록증 상세주소"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}}}
```
## 나의 참여 이벤트 목록 조회 (BO)
> \## 기능 설명\
> \* 나의 참여 이벤트 목록 조회(BO) 기본 API입니다.\
> \---\
> \## 상세 설명\
> \* 로그인 필수입니다.\
> \* 진행 중인 참여 이벤트 + 종료된 참여 이벤트(응모 이후 7일까지) + 종료된 사은 이벤트(응모 이후 7일까지)\
> \* \*\*회원번호(mbrNo)\*\*는 필수값입니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getParticipationEvent":{"get":{"tags":["이벤트 공통"],"summary":"나의 참여 이벤트 목록 조회 (BO)","description":"## 기능 설명\n* 나의 참여 이벤트 목록 조회(BO) 기본 API입니다.\n---\n## 상세 설명\n* 로그인 필수입니다.\n* 진행 중인 참여 이벤트 + 종료된 참여 이벤트(응모 이후 7일까지) + 종료된 사은 이벤트(응모 이후 7일까지)\n* **회원번호(mbrNo)**는 필수값입니다.\n","operationId":"getParticipationEvent","parameters":[{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string","description":"string"}},{"name":"mbrNo","in":"query","description":"회원 번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"나의 참여 이벤트 목록 조회 성공(BO)","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ParticipationEventResponse"}}}},"900":{"description":"나의 참여 이벤트 목록 조회 실패(BO)","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ParticipationEventResponse":{"type":"object","properties":{"evtNo":{"type":"string","description":"이벤트 번호"},"evtNm":{"type":"string","description":"이벤트 명"},"aplyDt":{"type":"string","description":"응모일자"},"strDt":{"type":"string","description":"이벤트 시작일"},"endDt":{"type":"string","description":"이벤트 종료일"},"evtPrgsStatCd":{"type":"string","description":"관리상태(EV005)"},"evtPrgsStatNm":{"type":"string","description":"진행중 상태 명"},"winDt":{"type":"string","description":"당첨일자"},"winYn":{"type":"string","description":"당첨여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}}}
```
## 나의 참여 이벤트 건수 조회
> \## 기능 설명\
> \* 나의 참여 이벤트 목록 수 조회(BO) 기본 API입니다.\
> \---\
> \## 상세 설명\
> \* 로그인 필수입니다.\
> \* 진행 중인 참여 이벤트 + 종료된 참여 이벤트(응모 이후 7일까지) + 종료된 사은 이벤트(응모 이후 7일까지)\
> \* \*\*회원번호(mbrNo)\*\*는 필수값입니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getParticipationEventCount":{"get":{"tags":["이벤트 공통"],"summary":"나의 참여 이벤트 건수 조회","description":"## 기능 설명\n* 나의 참여 이벤트 목록 수 조회(BO) 기본 API입니다.\n---\n## 상세 설명\n* 로그인 필수입니다.\n* 진행 중인 참여 이벤트 + 종료된 참여 이벤트(응모 이후 7일까지) + 종료된 사은 이벤트(응모 이후 7일까지)\n* **회원번호(mbrNo)**는 필수값입니다.\n","operationId":"getParticipationEventCount","parameters":[{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string","description":"string"}},{"name":"mbrNo","in":"query","description":"회원 번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"나의 참여 이벤트 목록 수 조회 성공(BO)","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ParticipationEventResponse"}}}},"900":{"description":"나의 참여 이벤트 목록 수 조회 실패(BO)","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ParticipationEventResponse":{"type":"object","properties":{"evtNo":{"type":"string","description":"이벤트 번호"},"evtNm":{"type":"string","description":"이벤트 명"},"aplyDt":{"type":"string","description":"응모일자"},"strDt":{"type":"string","description":"이벤트 시작일"},"endDt":{"type":"string","description":"이벤트 종료일"},"evtPrgsStatCd":{"type":"string","description":"관리상태(EV005)"},"evtPrgsStatNm":{"type":"string","description":"진행중 상태 명"},"winDt":{"type":"string","description":"당첨일자"},"winYn":{"type":"string","description":"당첨여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}}}
```
## 이벤트 회원 기본 배송지 조회
> \## 기능 설명\
> \* 이벤트 DB 회원 기본 배송지 조회 기본 API입니다.\
> \---\
> \## 상세 설명\
> \* 회원 번호를 파라미터로 받아 기본배송지 조회합니다.\
> \* 해당 회원의 기본배송지 조회(EVENT DB)\
> \* \*\*회원번호(mbrNo)\*\*는 필수값입니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getEtMbrDlvpInfo":{"get":{"tags":["이벤트 공통"],"summary":"이벤트 회원 기본 배송지 조회","description":"## 기능 설명\n* 이벤트 DB 회원 기본 배송지 조회 기본 API입니다.\n---\n## 상세 설명\n* 회원 번호를 파라미터로 받아 기본배송지 조회합니다.\n* 해당 회원의 기본배송지 조회(EVENT DB)\n* **회원번호(mbrNo)**는 필수값입니다.\n","operationId":"getMbrDlvpInfo","parameters":[{"name":"mbrNo","in":"query","description":"회원 번호","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"회원 기본 배송지 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EtMbrDlvpInfo"}}}},"900":{"description":"회원 기본 배송지 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EtMbrDlvpInfo":{"type":"object","description":"회원 배송 정보","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrDlvpSeq":{"type":"string","description":"회원배송지순번"},"dlvpGbCd":{"type":"string","description":"배송지구분코드(ME044)"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"baseDlvpYn":{"type":"string","description":"기본배송지여부"},"zipNoSeq":{"type":"integer","format":"int32","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":"휴대폰끝번호"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039)"},"deliMsg":{"type":"string","description":"배송메시지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"useYn":{"type":"string","description":"사용여부"},"userSortSeq":{"type":"integer","format":"int32","description":"사용자정렬순서"},"emailAddr":{"type":"string","description":"이메일"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://tech.x2bee.com/api/store-front-api/event-api/undefined-2.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.