> 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"}}}}}}
```