주문서 기본 조회영역
1. 주문서 진입 검증하기
주문서 진입 시, 사용자 검증(필수정보 존재 및 회원 여부, 나이 등)을 진행하여 주문서가 나타납니다.
주문서 진입 검증
POST api/order/v1/orderSheet/validateOrderSheet 🔗API 확인하기 >
주문서 진입 검증에 실패할 경우, 예외 상황 별 코드와 메시지를 반환합니다.
2. 주문서 조회 및 결제 수단 입력하기
회원 및 비회원의 주문서 생성 및 조회 시, 해당 주문서의 상세 정보가 나타납니다. 결제 수단 선택을 등록할 수 있으며, 배송지/마일리지(보조결제)/쿠폰 및 혜택 값에 따라 최종 결제 금액이 산정됩니다.
회원
- “주문자, 이메일, 비밀번호, 비밀번호 확인” 정보는 미 출력합니다.
- 회원의 기본 배송지를 디폴트로 노출합니다.비회원
- “쿠폰 및 혜택, 보유 마일리지, 적립 예정 마일리지” 정보는 미 출력합니다.
- 배송지 등록 버튼을 노출합니다.
결제 수단 선택 화면은 다음과 같은 상황에 따라 결제 수단이 다르게 노출 됩니다.
상품 등록 시 가격정보의 결제수단에 따라 보유 마일리지와 결제수단 노출정보가 나타납니다.
애플페이와 삼성페이는 OS 및 브라우저에 따라 노출 정보가 다르게 나타납니다.
- 애플페이 : IOS, Safari 인 경우
- 삼성페이 : IOS가 아닌 경우
3. 주문서에서 사용하는 공통코드 목록 조회
4. 주문서 상단 공지사항 조회
화면 고객알림 조회
GET api/common/v1/common/getContsList 🔗API 확인하기 >
주문서, 비회원 주문서 상단에 표시 될 고객알림 목록을 조회합니다.
알림 목록이 없는 경우 고객알림 영역 미 노출합니다.
5. 사은행사 조회
주문서 사은행사 조회
POST api/order/v1/orderSheet/aeEvtList 🔗API 확인하기 >
주문한 상품에 진행 중인 사은행사가 존재하는지 조회합니다.
사은행사 상품 선택은 결제 버튼을 클릭 시 노출되는 사은행사 모달팝업에서 선택 가능합니다.
6. 회원정보 조회
비회원은 조회 할 배송지가 없기 때문에 조회하지 않습니다.
회원정보 조회(미 마스킹)
GET api/member/v1/front/memberInfo 🔗API 확인하기 >
마스킹 되지 않은 회원의 정보를 조회하여, 회원의 기본배송지를 노출합니다.
7. 주문서 쿠폰목록 조회
비회원은 쿠폰 사용이 불가능하기 때문에 조회하지 않습니다.
주문서 쿠폰목록 조회
POST api/order/v1/marketing/getCouponPopupData 🔗API 확인하기 >
주문서의 최대 해택 적용값을 조회하여 쿠폰의 개수와 할인 금액을 노출합니다.
8. 주문서 적립정보 조회
비회원은 적립이 불가능하기 때문에 조회하지 않습니다.
주문서 적립정보 조회
POST api/order/v1/orderSheet/accumulationInfo 🔗API 확인하기 >
주문 정보에 맞는 적립 정보를 조회하여, 구매 회원의 적립 예정 마일리지를 보여줍니다.
주문서 배송지 추가/변경 및 배송비 계산
1. 배송지 목록 조회
주문서에서 사용자의 배송지 정보 변경 및 배송지 추가 시 배송지 변경 팝업을 호출합니다.
2. 배송그룹별 배송비 조회
주문서에서 사용자의 배송지 정보 변경 및 배송지 추가 또는 상품의 수량 변경 시 호출됩니다.
배송그룹 배송비 조회
POST /api/order/v1/delivery/deliveryGroupAmountList 🔗API 확인하기 >
배송그룹 각각의 배송비를 조회하며, 요청한 배송그룹의 우편번호가 도서산간 지역일 경우 추가 배송비가 부과됩니다.
3. 최대 배송비 해택 조회
주문서에서 사용자의 배송지 정보 변경 및 배송지 추가 또는 상품의 수량 변경 시 배송비 쿠폰 중 최대 해택이 적용되는 쿠폰 정보를 조회합니다.
최대배송비 해택 조회
POST /api/order/v1/marketing/getMaxBenefitDeliveryCoupon🔗API 확인하기 >
배송 그룹 별로 사용 가능한 배송비 쿠폰 정보를 조회하고, 조건에 맞는 하나의 배송 그룹에 배송비 쿠폰을 세팅합니다.
주문서 할인 혜택 상세 조회 및 변경
1. 할인 혜택 상세 조회
주문서에서 혜택 변경 버튼을 클릭하면, 해당 주문에 사용 가능한 혜택정보를 조회하고 해당 내역을 팝업창에 표시합니다.
기본적으로 최대 할인 혜택 정보를 표시하고, 상단의 최대 할인 적용 체크박스를 통해 언제라도 최대 할인 정보를 세팅/해제할 수 있습니다.
비회원 주문은 할인 혜택을 적용 받을 수 없기 때문에 주문서에 쿠폰 및 혜택 영역이 표시되지 않습니다.
할인 혜택은 각 단계별로 한개씩만 선택할 수 있습니다.
1차 할인 : 판매가 할인(상품에서 세팅하는 영역. 선택 불가.)
2차 할인 : 임직원 할인 / 상품즉시할인 / 상품할인쿠폰
3차 할인 : 장바구니쿠폰 / 중복할인쿠폰
기타 : 배송비 쿠폰
예시1) 하나의 주문에 상품할인쿠폰과 장바구니쿠폰, 그리고 배송비 쿠폰을 동시에 사용할 수 있습니다.
예시2) 하나의 주문에 상품즉시할인과 상품할인쿠폰을 동시에 사용할 수 없습니다.
2차 할인에서 임직원 할인을 선택하면, 3차 할인 선택이 불가능합니다.
2. 할인 혜택 적용
할인 혜택 조회 팝업에서 할인 혜택을 선택한 후 하단의 적용하기 버튼을 클릭하면, 선택한 할인 혜택 정보를 주문에 적용하고 쿠폰 및 혜택 영역과 결제 영역에 해당 정보를 표시합니다.
선물하기
1. 선물하기 주문 유효성 검사하기
장바구니 페이지에서 해당 상품의 선물하기 버튼을 클릭하면 선물하기 주문서 진입을 위한 주문 상품의 유효성 검사를 진행합니다.
상품 주문이 가능한것으로 판단되면 선물하기 주문서 페이지가 나타납니다.
해당 API는 장바구니 문서의 주문 가능 유효성 검사를 참고해 주세요.
2. 선물하기 주문서 조회 및 결제 정보 입력하기
선물하기 주문서 생성 및 조회 시, 해당 주문서의 상세 정보가 나타납니다. 해당 API는 주문서 문서의 주문서 조회 및 결제 정보 입력하기를 참고해 주세요.
선물하기 주문서는 일반 주문서와 다르게 다음과 같은 기능을 제공합니다.
비회원은 선물하기 기능을 이용할 수 없음
선물하기 메시지, 카드 선택, 받는 사람 정보 입력 기능을 제공
배송지와 배송메시지 입력 항목을 제공하지 않음
받은/보낸 선물 관리하기
선물을 받거나 보낸 선물에 대한 내역 조회 및 관리에 대한 설명은 마이메뉴 > 선물함 문서를 확인해 주세요.