LogoLogo
  • 샵바이 스킨 알아보기
    • 샵바이 스킨 설명서
    • 오로라 리액트(통합형) 스킨 개발 가이드
    • 오로라 리액트(통합형) 릴리즈 노트
    • 오로라 바닐라(개별형) 릴리즈 노트
    • 1:1 문의하기
  • 오로라 개별형 스킨 개발 가이드
    • 개발 프로세스
      • 등록
      • 개발
        • 개발 환경 구성하기
        • 스킨 디렉토리 구조
      • 설치
    • 기본 API 이해하기
      • 샵바이 API 호출 가이드
        • OAuth 2.0 적용 가이드
      • 외부 스크립트 호출 가이드
    • 화면별 API 활용 가이드
      • 공통 영역
        • 공통 상단
        • 공통 하단
        • 디자인 팝업
        • 슬라이드 메뉴 (모바일 전용)
        • 최근 본 상품
      • 메인 화면
        • 배너 영역
        • 상품진열 영역
        • 인스타그램 연동
      • 회원가입
      • 로그인
      • 간편 로그인
      • 휴대폰 본인인증
      • 상품 리스트
      • 상품 상세
        • 상품 기본 정보
        • 상품 상세 배너 (모바일 전용)
        • 상품 상세정보 (탭)
        • 배송/반품/교환 안내 (탭)
        • 상품후기 (탭)
        • 상품문의 (탭)
        • 관련상품
      • 장바구니
      • 주문서
      • 마이페이지 > 쇼핑정보
        • 주문목록/배송조회
        • 취소/반품/교환 내역
        • 주문 상세
        • 좋아요
      • 마이페이지 > 혜택관리
        • 쿠폰
        • 적립금
      • 마이페이지 > 회원정보
        • 회원정보 수정
        • 회원탈퇴
        • 배송지 관리
      • 마이페이지 > 나의 게시글
        • 1:1 문의
        • 상품문의
        • 상품후기
      • 상품후기 게시판
      • 일반 게시판
      • 기획전
    • KCP 휴대폰 본인인증 연동 (iOS/AOS)
  • 앱 개발 가이드
    • [샵바이] 웹훅(webhook) 가이드
    • [고도몰] 웹훅(webhook) 가이드
  • 추천 콘텐츠
    • 추천 콘텐츠
      • [간편 로그인] SNS 연동 기능 개발 가이드
      • [공통] 마이페이 API 화면가이드
      • [엔터프라이즈] 선물하기 기능 (배송지 나중입력)
      • [엔터프라이즈] 카카오 싱크 신청 가이드
      • [엔터프라이즈] 카카오 싱크 회원가입 API 화면가이드
      • [엔터프라이즈] 이니렌탈(렌탈결제) API 화면가이드
      • [엔터프라이즈] 외부 회원 연동 가이드
      • [엔터프라이즈] 외부 적립금 전환 가이드
      • [엔터프라이즈] 외부 적립금 연동가이드
      • [엔터프라이즈] 사은품 API 화면가이드
      • [엔터프라이즈] PG신청 가이드 (2024/4/1 업데이트)
      • [엔터프라이즈] 카카오 픽셀 설치 가이드
      • [엔터프라이즈]정기결제(배송) API 화면가이드
      • [프로/엔터프라이즈] 쇼핑몰에 인스타그램 위젯을 적용해보세요!
      • [베이직/프로] 카카오싱크 신청 가이드
      • [웹훅 추가] 주문정보 웹훅(Webhook)이란?
      • [웹훅 추가] 회원정보 변경 및 회원탈퇴
      • [웹훅 추가] 앱 설치 및 삭제
      • shop by API, POSTMAN에 추가하기
      • [글로벌] 글로벌 기능 가이드
        • 사용 프로세스
          • 엑심베이 PG 계약
          • 개발 환경 세팅
          • shop by 어드민 세팅
          • 쇼핑몰 스킨 개발
            • 언어/통화 설정
            • 상품/전시 설정
            • 주문서 조회
            • 주문 예약하기
            • 회원 등록
        • 글로벌 주문/환불 프로세스
    • FAQ
      • 에러코드_ (1) 주문
      • 에러코드_ (2) 프로모션
      • 에러코드_ (3) 클레임
      • 쿠폰 코드 API 에러메시지 안내
      • 장바구니/주문결제 에러코드 안내
      • 배송타입 및 택배사코드 안내
      • 파트너어드민 매출내역 조회기준
      • shop api error response 안내
      • server API로 주문의 외부 유입경로 집계 방법
      • 은행코드 안내
      • 7/15 스킨 에디터 업데이트 주의사항
        • 모바일_업데이트 전 템플릿 코드
        • PC_업데이트 전 템플릿 코드
        • 업데이트 후/전 템플릿 코드 비교
      • [샵바이 엔터프라이즈] server API 호출방법
      • [샵바이 엔터프라이즈] 파트너 어드민에서 상품 노출은 미리 해두고, 판매 기간은 미래시점으로 설정할 수 있는 기능이 있을까요?
      • [샵바이 엔터프라이즈] 파트너사 담당MD 일괄변경 어떻게하나요?
Powered by GitBook
On this page
  • 🅐 장바구니 리스트
  • ㉠ 장바구니 목록 조회
  • ㉡ 장바구니 옵션/수량 변경
  • ㉢ 장바구니 삭제
  • 🅑 금액 정보
  • 🅒 주문 버튼

Was this helpful?

  1. 오로라 개별형 스킨 개발 가이드
  2. 화면별 API 활용 가이드

장바구니

장바구니 화면을 소개합니다

Previous관련상품Next주문서

Last updated 1 year ago

Was this helpful?

  • 🅐 (장바구니 리스트 및 금액, 옵션 변경, 삭제)

  • 🅑 (상품 선택에 따른 금액계산)

  • 🅒


🅐 장바구니 리스트

㉠ 장바구니 목록 조회

장바구니 목록 정보를 조회하여, 해당 금액을 합산해 화면에 노출합니다. 장바구니에 담긴 상품의 정보는 장바구니에 추가된 시점이 아닌 현재 시점 기준으로 출력됩니다.

로그인 여부에 따라 회원과 비회원 장바구니 목록을 조회하는 API가 상이하나, 응답 값 (Responses)형식은 동일합니다.

◼︎ 회원 (member)

► 장바구니 목록 조회하기 로그인 회원의 장바구니 목록을 조회합니다.

회원의 장바구니 목록 내 상품 정보와 합배송 상품의 합산 금액 정보를 조회합니다.

  • deliveryGroups

    • 실제 구매 가능한 장바구니 목록입니다.

    • 장바구니 관련 아래 소개 드릴 API에서 파라미터로 자주 활용되는 cartNo (장바구니 번호)의 경우, 스키마 내 orderProductOptions에서 상품 옵션 별로 확인 가능합니다.

    • 동일 배송지별 합배송을 하기 위해서, 배송지 그룹 deliveryGroups > 주문 상품 orderProducts > 주문 상품 옵션 orderProductOptions 기준으로 매핑되어 3depth 배열로 응답 값이 나열됩니다.

    • '옵션'과 '텍스트 옵션'이 모두 동일한 상품일 경우, orderProductOptions 에서 optionNo와 optionInputs값을 비교하여 '중복 상품' 이라는 안내 라벨을 화면에 노출합니다.

  • price

    • 장바구니 가격 정보입니다.

    • 실제 구매 가능한 장바구니 리스트 deliveryGroups 를 모두 합산한 가격을 노출합니다. (총 합계금액 = 총 상품금액 - 총 할인금애 + 총 배송비)

    • 배송비

      • 만약 합배송이라서 동일한 배송비가 묶여서 적용되는 경우 열을 병합하여 배송비를 표기합니다.

      • 묶음 기준은 어드민의 배송비 템플릿 '묶음 배송 불가' 상품입니다.

    • 예상 적립금

      • accumulationAmtWhenBuyConfirm 을 호출하여 노출할 수 있으며, '(판매가 - 즉시할인금액 ± 옵션가)x수량' 으로 계산됩니다.

      • 단, 어드민에서 '구매 적립금 기준 금액'에 따라 선택되지 않은 금액은 계산 시 제외됩니다.

  • invalidProducts

    • 장바구니에 추가한 상품 중, 구매 불가능한 장바구니 리스트입니다.

    • 구매 불가능 상품 invalidProducts > 주문 상품 옵션 orderProductOptions 기준으로 매핑(mapping)되어 2depth 배열로 응답 데이터가 나타납니다.

    • invalidProducts인 경우 '구매 제한 상품' 처리하여 화면에 노출하며 합산 가격에서는 해당 가격을 제외합니다.

◼︎ 비회원 (guest)

► 비회원 장바구니 목록 조회하기 로그인 하지 않은 비회원의 장바구니 목록을 조회합니다.

로그인 하지 않은 비회원의 장바구니 금액 및 합배송 상품을 계산하여 장바구니 목록을 조회합니다.

비회원의 경우, 장바구니 데이터를 샵바이 DB 서버에 따로 저장하지 않고, localStorage에 저장하므로

아래 문서의 ㉡ 장바구니 옵션/수량 변경, ㉢ 장바구니 삭제, 🅑 금액 정보에 대한 API가 별도로 존재하지 않고

모두 해당 POST/ guest/cart를 호출하여 조회/수정/계산 합니다.

㉡ 장바구니 옵션/수량 변경

장바구니 화면 내에서 상품의 옵션 및 수량 변경이 가능합니다.

상품 이미지 하단에 [옵션/수량 변경] 버튼이 출력되며, 클릭 시 옵션 별로 옵션 및 수량 정보를 수정할 수 있습니다. 구매 불가 상품의 경우 해당 버튼이 노출되지 않습니다.

상품을 구매하는 기준은 '상품 단위'가 아닌 '옵션 단위' 입니다.

◼︎ Step 1. [옵션/수량 변경] 버튼 클릭

► 상품 옵션 조회하기 해당 상품번호(productNo)에 대한 옵션 정보를 조회합니다.

장바구니에서 상품의 '옵션을 변경' 한다는 것은 기존 항목을 삭제하고 새로운 항목을 추가하는 프로세스 입니다. 따라서, (step 2-1) 옵션 변경이 포함된 경우와 (step 2-2) 옵션을 변경하지 않고 수량만 변경하는 경우에 각각 호출하는 API가 상이합니다.

◼︎ Step 2-1. 옵션 변경 및 옵션과 수량을 함께 변경하는 경우

'변경 완료' 버튼 클릭 시 아래 2가지 API를 호출하여 DELETE /cart 로 기존 장바구니 옵션을 삭제하고, POST /cart 로 새로운 장바구니 옵션을 등록합니다.

► 장바구니 삭제하기 로그인 회원의 장바구니를 삭제합니다.

► 장바구니 등록하기 로그인 회원의 장바구니 구매 수량과 옵션을 등록합니다.

Request Body OptionInputs 을 통해 텍스트 옵션도 수정 가능합니다.

◼︎ Step 2-2. 옵션을 변경하지 않고, 장바구니 수량만 변경하는 경우

◼︎ Step 3. 이후 단계

㉠ 장바구니 리스트를 다시 호출하여 화면에 노출합니다.

㉢ 장바구니 삭제

장바구니 리스트에서 특정 상품만 선택하여 삭제할 수 있습니다.

► 장바구니 삭제하기 로그인 회원의 장바구니를 삭제합니다.


🅑 금액 정보

장바구니 리스트에서 체크박스에 '체크 된 항목이 변경될 때마다' 실시간으로 금액 정보를 계산합니다.

주문 금액을 계산하는 로직은 아래 GET /cart/calculate 단일 API만 사용하시길 바랍니다.

► 장바구니에서 선택된 상품금액 계산하기 장바구니에서 선택된 상품(cartNo) 금액을 게산합니다.

선택된 상품의 가격정보를 포함하여 예상 적립금도 함께 계산하여 노출됩니다. cartNo은 GET /cart API 내 상품 옵션 별로 orderProductOptions 에서 확인 가능합니다.


🅒 주문 버튼

  • PC

    • 상품 체크 박스 선택 후 [선택 상품 주문] 버튼 클릭 시 선택한 상품 옵션에 대한 주문서를 생성합니다.

    • [전체 상품 주문] 버튼 클릭 시, 장바구니 리스트 전체 상품 옵션에 대한 주문서를 생성합니다.

  • 모바일

    • 상품 체크박스 선택 후 [주문하기] 버튼 클릭 시, 선택한 상품 옵션에 대한 주문서를 생성합니다.

► 주문서 생성 요청하기 선택한 상품의 옵션에 대한 주문서를 생성합니다.

주문서를 생성하는 API로 주문서 화면으로 이동하기 전 단계에서 호출해야 합니다. 해당 API에서 응답 값으로 획득한 주문서 번호 orderSheetsNo 를 주문서 화면으로 전달합니다.

비회원 주문인 경우 accessToken을 null로 보냅니다.

에서 소개한 GET /products/{productNo}/options 을 호출하여 해당 상품의 모든 옵션 정보를 불러와 select-box 구현합니다.

► 장바구니 수정하기 로그인 회원의 장바구니 구매 수량을 수정합니다.

GET /cart
POST /guest/cart
상품 상세화면
GET /product/{productNo}/options
DELETE /cart
POST /cart
PUT /cart
DELETE /cart
GET /cart/calculate
POST /order-sheets
장바구니 리스트
금액 정보
주문 버튼