이벤트 참여내역 기능은 로그인한 회원이 ‘마이페이지 – 참여내역＇에서 이벤트 응모내역을 확인 할 수 있습니다.
이벤트 참여내역에는 ‘이벤트 참여’ , ‘구매 사은 응모’ 으로 나뉘어지며 ＇구매 사은 응모’탭에서는 구매 사은 이벤트 응모 내역만 확인할 수 있습니다.
리워드가 경품/사은품 인 경우, Default 배송지는 회원 기본 배송지로 들어가며, 이벤트 배송지 저장 API 를 통해 변경이 가능합니다.
주요 기능
X2BEE 쇼핑몰에서 회원이 참여한 이벤트 내역을 조회합니다.
본인이 참여한 이벤트 목록을 조회합니다.( 구매 사은 이벤트 제외)
기간 검색 구분 코드( 1주, 1개월, 3개월 ) 을 받아 해당 기간 내의 이벤트 참여내역을 조회합니다.
필터링 구분코드( 당첨 , 진행중, 종료) 를 받아 조건에 해당하는 이벤트 참여내역을 조회합니다.
본인이 참여한 구매 사은 이벤트 목록을 조회합니다.
기간 검색 구분 코드 ( 1주, 1개월, 3개월 ) 을 받아 해당 기간 내의 구매 사은 이벤트 참여내역을 조회합니다.
필터링 구분코드( 당첨, 진행중, 종료 ) 를 받아 조건에 해당하는 구매 사은 이벤트 참여내역을 조회합니다.
이벤트 배송지 정보를 변경하여 저장합니다.
경품/사은품의 배송지는 회원 기본 배송지가 Default로서 들어갑니다.
수정 시, 이벤트 리워드 배송지(경품/사은품)가 수정한 주소로 변경됩니다.
프로세스 정의
번호 | 구분 | 설명 |
|---|---|---|
1 | 마이페이지 이동 | 회원이 마이페이지에 접근할 때 로그인 상태일 시 회원의 정보를 노출시켜주고 비로그인 상태일 시 로그인 페이지로 이동됩니다. |
2 | 이벤트 참여내역 | 참여내역 접근 시, 기본 Default값으로 1주 내에 있는 이벤트 참여내역을 조회합니다. 기간 검색 코드 값과 필터링 값(진행중, 종료, 당첨)을 통해 조회 조건을 바꿔 조회가 가능합니다. |
3 | 이벤트 배송지 저장 | 지급이 되지 않았으며, 리워드가 사은품/경품인 경우 수령지 변경 선택을 하여 이벤트 배송지 변경하여 저장할 수 있습니다. |
API 기능 목록
API | 설명 | Server | 매소드 | 비고 |
|---|---|---|---|---|
이벤트 참여내역 조회 | 로그인한 회원의 참여내역을 조회합니다. | Event | GET | |
이벤트 구매 사은 응모 내역 조회 | 로그인한 회원의 구매 사은 응모 내역을 조회합니다. | Event | GET | 주문정보 조회 상품요약정보 조회 : /api/goods/v1/detail/summary |
이벤트 배송지 저장 | 응모한 회원의 이벤트 배송지를 변경 후 저장합니다. | Event | POST |
용어 정의
명칭 | 설명 | 비고 |
|---|---|---|
전시기간 | 이벤트가 이벤트 목록에서 전시되는 기간을 말합니다. 전시기간이 끝난 이벤트는 상세 진입이 안됩니다. | |
응모기간(행사기간) | 이벤트 상세 화면에서 응모 버튼 눌렀을때, 응모 할 수 있는 기간을 말합니다. | |
구매기간 | 이벤트에 적용되는 상품을 구매할 수 있는 기간을 말합니다. | |
추첨이벤트 | 기업에서 소비자들에게 사은품, 마일리지, 쿠폰 등 다양한 상품을 제공하기 위해 추첨을 통해 선발하는 이벤트를 말합니다 | |
비추첨이벤트 | 참여자들이 특정 조건을 만족하거나 특별한 활동을 수행함으로써 혜택(쿠폰,마일리지)을 지급하는 이벤트를 말합니다. | |
이벤트리워드 | 이벤트에 참여한 사람들에게 주어지는 보상이나 혜택을 나타냅니다. |
기타 참고사항
이벤트 참여 내역 / 구매 사은 응모 내역 조회
이벤트 참여내역 및 구매 사은 응모 내역 조회에는 기간 검색 구분 코드( periodGb ) 와 필터링 구분 값( filteringGb ) 을 조회 조건으로 받아 조회합니다.
기간 검색 구분 코드 ( periodGb )
0 : 1주일
1 : 1개월
2 : 3개월
3 : 기간검색
필터링 구분 코드 ( filteringGb )
Default : 전체
1 : 당첨된 이벤트
2 : 진행중 이벤트
3 : 종료된 이벤트
이벤트 배송지 저장
이벤트 배송지 저장은 리워드가 사은품/경품 일때만 가능합니다.
이벤트 배송지 저장은 아래의 경우’수령지 변경’버튼이 노출이 안되어 저장이 불가합니다.
지급여부 Y
지급일시 존재
기타사은품배송지번호 존재
이벤트 진행상태(EV005). : 경품발송완료(07)
기타사은품상태코드(LO013) : 배송완료(40)
이벤트 배송지는 CC_EVT_TRGMN_INFO 의 응모자 테이블의 주소 정보가 UPDATE 됩니다.