이벤트 참여내역

이벤트 참여내역 조회 기능은 로그인한 회원이 '마이페이지 - 참여내역'에서 참여한 이벤트 응모내역을 확인할 수 있습니다. 참여내역은 '이벤트 참여'와 '구매 사은 응모'로 나뉘어지며, '구매 사은 응모'에서는 해당 이벤트 응모 내역만 확인할 수 있습니다.

---

주요 기능

• 이벤트 참여내역 조회

  • 로그인한 회원이 참여한 이벤트 목록을 조회합니다.

  • 구매 사은 이벤트 제외한 이벤트 참여내역을 확인합니다.

  • 기간 검색 구분 코드(1주, 1개월, 3개월)로 해당 기간 내의 이벤트 참여내역을 조회합니다.

  • 필터링 구분 코드(당첨, 진행중, 종료)를 받아 해당 조건에 해당하는 이벤트 참여내역을 조회합니다.

• 구매 사은 이벤트 참여내역 조회

  • 로그인한 회원이 참여한 구매 사은 이벤트 목록을 조회합니다.

  • 기간 검색 구분 코드(1주, 1개월, 3개월)로 해당 기간 내의 구매 사은 이벤트 참여내역을 조회합니다.

  • 필터링 구분 코드(당첨, 진행중, 종료)를 받아 해당 조건에 해당하는 구매 사은 이벤트 참여내역을 조회합니다.

• 이벤트 배송지 정보 변경

  • 리워드가 경품/사은품인 경우, Default 배송지는 회원의 기본 배송지로 들어갑니다.

  • 이벤트 배송지 저장 API를 통해 변경이 가능하며, 수정 시 리워드 배송지(경품/사은품)가 변경된 주소로 저장됩니다.

프로세스 정의

1

마이페이지 이동

회원이 마이페이지에 접근할 때 로그인 상태일 시 회원의 정보를 노출시켜주고 비로그인 상태일 시 로그인 페이지로 이동됩니다.

2

이벤트 참여내역

참여내역 접근 시, 기본 Default값으로 1주 내에 있는 이벤트 참여내역을 조회합니다. 기간 검색 코드 값과 필터링 값(진행중, 종료, 당첨)을 통해 조회 조건을 바꿔 조회가 가능합니다.

3

이벤트 배송지 저장

지급이 되지 않았으며, 리워드가 사은품/경품인 경우 수령지 변경 선택을 하여 이벤트 배송지 변경하여 저장할 수 있습니다.

API 기능 목록

API	설명	Server	메소드	비고
이벤트 참여내역 조회	로그인한 회원의 참여내역을 조회합니다.	Event	GET	🔗API 확인하기 >
이벤트 구매 사은 응모 내역 조회	로그인한 회원의 구매 사은 응모 내역을 조회합니다.	Event	GET	🔗API 확인하기 > 주문정보 조회: /api/order/v1/event/evtOrdList 상품요약정보 조회: /api/goods/v1/detail/summary
이벤트 배송지 저장	응모한 회원의 이벤트 배송지를 변경 후 저장합니다.	Event	POST	🔗API 확인하기 >

용어 정의

명칭	설명
전시기간​	이벤트가 이벤트 목록에서 전시되는 기간을 말합니다.​ 전시기간이 끝난 이벤트는 상세 진입이 안됩니다.​
응모기간(행사기간)​	이벤트 상세 화면에서 응모 버튼 눌렀을때, 응모 할 수 있는 기간을 말합니다.​
구매기간​	이벤트에 적용되는 상품을 구매할 수 있는 기간을 말합니다.​
추첨이벤트​	기업에서 소비자들에게 사은품, 마일리지, 쿠폰 등 다양한 상품을 제공하기 위해 추첨을 통해 선발하는 이벤트를 말합니다​.
비추첨이벤트​	참여자들이 특정 조건을 만족하거나 특별한 활동을 수행함으로써 혜택(쿠폰,마일리지)을 지급하는 이벤트를 말합니다.​ (추첨이 아닌 즉시지급-출석, 구매사은 등)​
이벤트리워드​	이벤트에 참여한 사람들에게 주어지는 보상이나 혜택을 나타냅니다. ​ 이벤트 당첨 시, 제공하는 혜택 정보에는 사은품, 경품, 마일리지, 쿠폰 등이 있습니다.​

기타 참고사항

• 이벤트 참여 내역 / 구매 사은 응모 내역 조회

  이벤트 참여내역 및 구매 사은 응모 내역 조회에는 기간 검색 구분 코드( 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 됩니다.