장바구니 등록

고객이 상품 상세 페이지에서 바로 구매하지 않고 장바구니에 상품을 담아두고 필요한 조작을 할 수 있는 기능을 제공합니다. 이를 통해 고객은 편리하게 주문을 관리하고 결제를 완료할 수 있습니다.

---

주요 기능

• 장바구니 등록 기능

  • 고객이 상품 상세 페이지에서 원하는 상품을 바로 구매하는 대신 장바구니에 담을 수 있습니다.

• 장바구니 내 조작 기능

  • 장바구니에서는 옵션 변경, 수량 조절, 상품 삭제 등 다양한 조작을 할 수 있습니다.

• 장바구니 상태 관리 기능

  • 장바구니에 등록된 상품의 총 수량을 조회하고, 주문 가능 여부를 유효성 검사할 수 있습니다.

• 비회원과 회원 장바구니 병합 기능

  • 비로그인 상태에서 등록된 장바구니 상품은 회원 로그인 시 자동으로 병합되어 통합된 장바구니를 제공합니다.

• 자동 삭제 기능

  • 장바구니는 최대 보관 기간까지만 유지되며, 해당 기간을 초과할 경우 배치 프로그램에 의해 자동으로 삭제됩니다.

프로세스 정의

1

장바구니 등록

사용자는 상품 상세 페이지를 통하여 상품의 옵션 정보를 선택하여 장바구니에 등록할 수 있습니다. 등록 시 상품정보 등을 조회하여 등록 가능한 상품만 장바구니에 등록됩니다.

2

장바구니 조회

장바구니 진입 시 장바구니에 담겨있는 상품을 조회합니다. 장바구니에 담겨 있는 상품 리스트를 통하여 각 상품의 정보(단품정보, 가격정보, 배송정보 등)를 조회하여 출력합니다.

3

장바구니 총 수량 조회

장바구니에 등록되어 있는 총 개수의 수량을 조회합니다.

4

옵션 변경

사용자는 장바구니에 등록되어 있는 상품의 수량, 옵션(사이즈, 컬러 등)을 선택하여 변경할 수 있습니다.

5

장바구니 삭제

사용자는 장바구니에 등록되어 있는 상품을 삭제할 수 있습니다.

6

장바구니 병합

비회원이 로그인 시 로그인 전에 장바구니에 담았던 상품들은 로그인한 회원의 장바구니에 합쳐서 보여줍니다.

7

장바구니 유효성 검사

바로 구매, 주문하기 시 주문서로 넘기기 전 선택한 장바구니 상품의 데이터가 주문 가능(상품판매상태, 구매가능수량, 재고, 성인상품인증여부, 구매제한회원여부 등)한지 검사합니다.

8

장바구니 자동 삭제

배치 프로그램에 의해서 장바구니 최대 보관 기간을 넘긴 상품들은 삭제됩니다.

API 기능 목록

API	설명	Server	메소드	비고
장바구니 조회	장바구니에 담겨있는 상품을 조회합니다. 회원은 회원번호, 비회원은 세션번호를 기준으로 조회합니다. 주문완료여부 ‘N’인 데이터만 조회합니다.	Order	GET	🔗API 확인하기> 상품 API 호출 (상품별 단품정보 조회(장바구니전용), 배송정책번호별 배송비 조회)
장바구니 총 수량 조회	장바구니에 담겨있는 총 수량을 조회합니다.	Order	GET	🔗API 확인하기>
장바구니 등록	상품을 장바구니에 등록합니다. 바로구매, 장바구니 담기 시 호출됩니다. 호출시 아래 사항들을 검증합니다. - 공통:상품 판매상태, 구매 가능 수량 - 바로구매: 상품재고, 예약상품가능일시, 비회원성인상품구매불가, 성인 상품 인증 여부, 배송비 정책, 주문자 구매제한여부/연령 - 장바구니: 배송비 정책, 장바구니 최대 수량 초과 여부	Order	POST	🔗API 확인하기> 상품 API 호출 (상품별 단품정보 조회(장바구니전용))
장바구니 옵션 변경	선택한 상품의 수량, 옵션(사이즈, 컬러 등)을 변경합니다.	Order	PUT	🔗API 확인하기> 상품 API 호출 (상품별 단품정보 조회(장바구니전용))
장바구니 삭제	선택한 상품을 장바구니에서 삭제합니다. 논리 삭제로 주문완료여부를 ‘Y’로 업데이트 합니다. 쇼핑백 삭제 배치에서 물리삭제합니다.	Order	PUT	🔗API 확인하기>
장바구니 병합	로그인 시에 비회원일때 담았던 장바구니 상품들을 로그인한 회원 장바구니로 병합합니다.	Order	POST	🔗API 확인하기>
장바구니 상품 주문가능 여부 체크	장바구니에서 바로구매 클릭 시 주문서로 넘어가기 전 선택한 장바구니 상품 데이터가 주문가능한지 검사합니다. - 상품: 상품 판매 상태, 구매 가능 수량, 재고, 예약상품 가능일시, 비회원 성인상품 구매 불가, 성인상품 인증 여부 - 주문자: 구매제한회원 확인, 연령확인	Order	POST	🔗API 확인하기>

용어 정의

용어 명칭	설명	비고
옵션변경	장바구니에 담긴 상품의 구매 수량, 상품 옵션을 변경	옵션변경
바로구매	주문하고자 하는 상품을 즉시 주문서 상품페이지로 이동하여 구매하게 하는 경우	바로구매
선물하기	주문하고자 하는 상품을 본인 또는 타인에게 선물하는 주문 기능	선물하기

기타 참고 사항

• 회원은 회원번호, 비회원은 세션번호로 장바구니를 구분합니다.

• 장바구니 최대 수량은 공통코드로 관리합니다. (ST002: 장바구니 담기 최대 수량 참조)

• 장바구니 보관 기간은 공통코드로 관리합니다. (ST003: 장바구니 보관 기간 참조)

• 장바구니 삭제 배치는 매일 1회 실행됩니다. 장바구니 삭제 배치 경로: /batch/mbod/jobs/basketExpirationJob

---