> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/store-front-api/undefined-3/undefined.md).

# 장바구니

사용자가 제품을 선택하고 장바구니에 담는 기능을 관리하고, 주문 프로세스를 시작하기 위한 필수 요소입니다.

사용자는 선택한 제품을 장바구니에 추가, 수정, 삭제하며 주문할 제품을 관리할 수 있도록 API를 제공합니다.

{% columns %}
{% column %}

<p align="center"><strong>PC</strong></p>

<figure><img src="/files/kSoWrmKLqL9wPUtejnMR" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<p align="center"><strong>Mobile</strong></p>

<figure><img src="/files/BuENlHS1NDevKBeCeGXQ" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## 장바구니 조회 영역 <a href="#plus" id="plus"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266110356/ShoppingBag.drawio.png" alt=""></p>

&#x20;

### 1. 장바구니 조회 <a href="#id-1" id="id-1"></a>

장바구니 담기로 선택한 상품들의 목록을 조회합니다.

1\) 회원 : 회원번호로 장바구니를 조회합니다.

2\) 비회원 : 비회원은 장바구니 최초 등록 시 세션번호가 생성되어 쿠키에 저장되며, 이후 세션번호를 쿠키에서 가져와 조회합니다.<br>

* **장바구니 조회** ([🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=getBasket))\
  회원번호 및 비회원의 쿠키 세션번호로 조회하여 구성 정보를 출력합니다.

```
GET /v1/basket/getBasket
```

### 2. 고객알림리스트 조회 <a href="#id-2" id="id-2"></a>

BO 시스템의 **공지사항 관리 > 고객 알림 관리**에 등록하여 나타나는 상단 공지사항을 조회합니다.​

* **화면 고객알림 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=common\&depth=%EA%B3%B5%ED%86%B5\&path=getContsList))\
  고객알림리스트를 조회합니다.

```
GET /v1/common/getContsList 
```

### 3. 무이자 할부 안내 목록 조회 <a href="#id-3" id="id-3"></a>

장바구니 하단 텍스트를 클릭 시, 무이자할부 안내 관리에 등록된 행사 정보를 호출하여 나타냅니다.

* **무이자 할부 안내 목록 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EA%B2%B0%EC%A0%9C%EC%A0%95%EB%B3%B4/getInterestFreeList))\
  신용카등의 무이자할부 안내 목록을 조회합니다.

```
GET /v1/payment/getInterestFreeList  
```

***

## 장바구니 삭제 <a href="#plus" id="plus"></a>

![](https://tech.x2bee.com/download/attachments/266110356/%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88_%EC%83%81%ED%92%88%EC%82%AD%EC%A0%9C.drawio.png)

### 1. 장바구니 삭제 <a href="#id-1" id="id-1"></a>

품절 상품 혹은 선택된 상품을 장바구니 목록 화면에서 삭제 합니다.

* **장바구니 삭제 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=deleteBasket))\
  장바구니 상품 목록에서 선택된 상품을 삭제 합니다.

```
PUT /v1/basket/deleteBasket 
```

***

## 장바구니 옵션변경 <a href="#plus" id="plus"></a>

![](https://tech.x2bee.com/download/attachments/266110356/%EC%87%BC%ED%95%91%EB%B0%B1%20%EC%83%81%ED%92%88%20%EC%98%B5%EC%85%98%EB%B3%80%EA%B2%BD.drawio.png)

### 1. 장바구니 옵션변경 <a href="#id-1" id="id-1"></a>

장바구니에서 대상 상품을 선택하여 ‘옵션변경’을 클릭하면, 변경 옵션을 옵션 및 수량 변경 팝업이 나타납니다. 수량을 변경하고 \[선택완료]를 클릭하면, 변경된 수량으로 저장됩니다.

* **장바구니 옵션변경 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=optionChangeBasket))\
  ‘선택완료’ 버튼 클릭 시, 장바구니 상품옵션 변경 API를 호출합니다.

```
PUT /v1/basket/optionChange 
```

***

## 상품상세 사은행사 목록 <a href="#plus" id="plus"></a>

![](https://tech.x2bee.com/download/attachments/266110356/%EC%87%BC%ED%95%91%EB%B0%B1%20%EC%82%AC%EC%9D%80%ED%96%89%EC%82%AC%EC%A1%B0%ED%9A%8C.drawio.png)

### 1. 상품상세 사은행사 목록 <a href="#id-1" id="id-1"></a>

장바구니 목록의 상품 중에서 상세정보에 존재하는 사은행사 정보 리스트를 조회하여 출력하는 화면입니다.사은품 영역 클릭 시 사은행사 정보를 조회하여 모달을 호출합니다.<br>

* **상품상세 사은행사 목록 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EC%82%AC%EC%9D%80%ED%96%89%EC%82%AC/getAeEvtList_2))\
  비회원은 해당 사항이 없는 회원 전용 API 입니다.

```
POST/v1/marketing/aeEvtList 
```

***

## 주문가능 유효성 검사 <a href="#plus" id="plus"></a>

![](https://tech.x2bee.com/download/attachments/266110356/FO%20API_%EC%A3%BC%EB%AC%B8%EA%B0%80%EB%8A%A5%20%EC%9C%A0%ED%9A%A8%EC%84%B1%20%EA%B2%80%EC%82%AC.drawio.png)

### 1. 장바구니 상품주문 유효성 검사 <a href="#id-1" id="id-1"></a>

주문서 진입 전 유효성 검사를 진행합니다. 유효성 검사 ‘성공 시’ 주문서로 이동하며, ‘실패 시’ 실패 메시지를 노출 합니다.

* **장바구니 상품 주문가능여부 체크 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=validateBasket))\
  장바구니에서 ‘바로구매’ 또는 ‘주문하기’ 클릭 시, 선택한 상품의 주문가능 여부를 검사하는 API 입니다.

```
POST /v1/basket/validateBasket 
```

***

## 장바구니 병합 <a href="#plus" id="plus"></a>

![](https://tech.x2bee.com/download/attachments/266110356/FO%20API_%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88%20%EB%B3%91%ED%95%A9.drawio.png)

### 1. 장바구니 병합 <a href="#id-1" id="id-1"></a>

비회원으로 담았던 장바구니 상품들을 회원 로그인 시 기존 회원의 장바구니 상품과 결합하여 나타냅니다.

* **장바구니 병합 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=combineBsket))\
  비회원 장바구니 데이터를 최신 데이터로 간주하여 정렬 시에 장바구니 상단에 비회원 데이터가 먼저 나타납니다.

```
POST /v1/basket/combineBasket 
```

<br>