> 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-2/undefined.md).

# 상품 상세 페이지

이커머스 웹사이트 또는 애플리케이션에서 개별 상품에 대한 상세 정보를 제공하고 관리하는 데 사용되는 인터페이스입니다. 사용자에게 특정 상품에 대한 다양한 정보를 효과적으로 전달하고 구매 프로세스를 원활하게 진행할 수 있습니다.

***

{% columns %}
{% column %}

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

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

{% column %}

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

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

***

## 상품 상세보기 <a href="#plus" id="plus"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109881/%EC%83%81%ED%92%88%EC%83%81%EC%84%B8%20fo-2.drawio.png" alt=""></p>

### 1. 상품 정보 조회 <a href="#id-1" id="id-1"></a>

해당 상품의 기본정보 및 상세 정보를 조회할 수 있습니다.

* **상품상세정보 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8/seltProductDetailInfo))\
  상품상세페이지에서 상품정보를 상세 조회하기 위한 API입니다.
  * 전시여부가 Y이고, 판매상태가 판매중/품절이고, 판매기간에 해당하는 상품을 조회함
  * 상품의 기본/단품/브랜드/이미지/가격/결제수단/연관상품/묶음상품/배송비정책/프로모션/증정품/리뷰별점통계 정보가 조회됨

```
GET /v1/detail/goodsDetail 
```

**1.1 브랜드**

**\[브랜드]**&#xB97C; 클릭하면 해당 브랜드 메인으로 이동합니다.

### 2. 상품이미지 상세 <a href="#id-2" id="id-2"></a>

**\[상품이미지]**&#xB97C; 클릭하면 해당 상품에 대한 상품이미지를 모아서 볼 수 있는 팝업이 나타납니다.

**2.1 상품이미지 상세 팝업**

해당 상품에 등록된 이미지들을 보여 줍니다. 하단 이미지를 클릭하여 팝업 상단에서 크게 볼 수 있습니다.

상품이미지에 대한 API는 상품 상세 문서에서 **1.상품 정보 조회하기**의 내용을 참고해주세요.

### 3. 할인 내역 <a href="#id-3" id="id-3"></a>

가격정보 우측의 **\[?]** 아이콘을 클릭하면 해당 상품에 대한 할인내역 팝업이 나타납니다.

**3.1 할인 내역 팝업**

정상가, 판매가, 최대 할인 가격이 적용된 정보를 제공합니다.

상품이미지에 대한 API는 상품상세 문서에서 **1.상품 정보 조회하기**의 내용을 참고해주세요.

### 4. 사이즈가이드 <a href="#id-4" id="id-4"></a>

**\[사이즈 가이드]**&#xB97C; 클릭하면 해당 상품에 대한 사이즈 가이드 팝업이 나타납니다.

**\[사이즈 가이드]** 버튼은 의류 카테고리에 포함한 상품만 나타납니다.

**4.1 사이즈가이드 팝업**

여성/남성/아동/유아 카테고리의 상품에 대해 국가별 사이즈 정보를 제공합니다.

상품이미지에 대한 API는 상품상세 문서에서 **1.상품 정보 조회하기**의 내용을 참고해주세요.

### 5. 할인혜택 & 쿠폰받기 <a href="#id-5.-and" id="id-5.-and"></a>

로그인 사용자가 **\[할인혜택]** 클릭 시 나타나는 할인혜택 & 쿠폰받기 팝업이 나타납니다.

발급 가능 쿠폰과 보유한 사용 가능 쿠폰 정보를 조회 할 수 있고, 발급이 가능한 쿠폰을 다운로드 할 수 있습니다.

**5.1 쿠폰 목록 조회**

* **상품상세 다운로드 가능 쿠폰조회 (**[🔗 API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%BF%A0%ED%8F%B0%20%EB%B0%9C%EA%B8%89/getCpnListForGoodsDetail))
  * 발급 가능쿠폰 : 로그인한 사용자가 발급 가능한 쿠폰 목록를 조회함
  * 보유한 쿠폰 : 로그인한 사용자가 보유한 쿠폰 목록를 조회함

```
POST /v1/marketing/goodsDetailCpnList 
```

**5.2 쿠폰 다운로드**

* **쿠폰다운로드(FO) (**[🔗 API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%BF%A0%ED%8F%B0%20%EB%B0%9C%EA%B8%89/cpnDownFo))
  * 쿠폰 전체받기 : 발급 가능한 쿠폰 전체 다운로드
  * 다운로드 : 클릭 된 쿠폰 다운로드

```
POST /v1/marketing/cpnDown 
```

### 6. 사은품 안내 <a href="#id-6" id="id-6"></a>

고객이 상품 구매 시 증정되는 사은품은 로그인한 고객에게만 나타납니다.

사은행사 상품을 클릭 시 사은품 안내 팝업이 나타납니다.

**6.1 사은품 안내 팝업**

진행중인 사은행사 정보를 제공합니다.

* **상품상세 사은행사 조회 (**[🔗 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  
```

### 7. 마일리지 적립 안내 <a href="#id-7" id="id-7"></a>

추가혜택에서 **\[마일리지 적립 안내]**&#xB97C; 클릭하면 마일리지 적립 팝업이 나타납니다.

**7.1 마일리지 적립 팝업**

받을 수 있는 최대 마일리지 정보를 제공합니다.

### 8. 무이자 할부 안내 <a href="#id-8" id="id-8"></a>

추가혜택에서 **\[무이자 할부 안내]**&#xB97C; 클릭하면 카드 행사 혜택 안내 팝업이 나타납니다.

**8.1 무이자 할부 팝업**

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

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

### 9. 배송상세정보 <a href="#id-9" id="id-9"></a>

배송정보에서 \[더보기]를 클릭하면 배송상세정보 팝업이 나타납니다.

**9.1 배송상세정보 팝업**

예약정보와 배송정보를 보다 상세하게 제공합니다.

배송정보에 대한 API는 상품상세 문서에서 **1.상품 정보 조회하기**의 내용을 참고해주세요.

상품 상세 페이지내 상품정보고시와 배송/교환/반품에 대한 정보를 제공할 수 있습니다.

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109881/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0%20-%20%EC%83%81%ED%92%88%EC%83%81%EC%84%B8%EC%A0%95%EB%B3%B4%ED%8C%9D%EC%97%85.drawio.png" alt=""></p>

### 10. 상품고시정보 <a href="#id-10" id="id-10"></a>

**\[상품고시정보]**&#xB97C; 클릭하면 해당 상품에 대한 상품고시정보 팝업이 나타납니다.

**10.1 상품고시정보 팝업**

상품의 상품정보제공고시, 품질보증기준, AS 책임자 / 전화번호를 제공합니다.

상품정보고시에 대한 API는 상품상세 문서에서 1.상품 정보 조회하기의 내용을 참고해주세요.

### 11. 교환/반품/환불 안내 <a href="#id-11" id="id-11"></a>

\[교환/반품안내]을 클릭하면 해당 상품에 대한 교환/반품/환불 안내 팝업이 나타납니다.

**11.1 교환/반품/환불 안내 팝업**

상품의 교환/반품/환불에 대한 절차 및 배송비, 불가사유 정보를 제공합니다.

* **상품별 배송교환반품 정보 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8%20%EB%B0%B0%EC%86%A1%EC%A0%95%EB%B3%B4/getPdReturnOrChangeInfo))\
  상품번호 값으로 사용이 매칭 된 배송정책 및 협력사 배송지 정보 리스트를 조회합니다.

```
GET /v1/delivery/pd/{goodsNo} 
```

&#x20;

***

## 하단 네비게이션 버튼바 <a href="#plus" id="plus"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109881/%EC%83%81%ED%92%88%EC%83%81%EC%84%B8%20fo-3.drawio.png" alt=""></p>

### 1. 하단 네비게이션 버튼바 <a href="#id-1" id="id-1"></a>

상품 기본정보 스크롤 다운 후 상품을 구매를 위한 버튼이 나타납니다.

**1.1 판매상태가 판매중인 경우**

구매하기 버튼이 나타납니다. 상품 기본정보에 따라 선물하기, 정기주문 버튼이 나타납니다.

\[**선물하기], \[정기주문], \[구매하기]** 버튼이 나타나며 클릭하면 상품 옵션 선택 레이어가 나타납니다.

**1.2 판매상태가 품절인 경우**

**\[재입고알림 신청]** 버튼이 나타나며 클릭하면 재입고알림 신청 팝업이 나타납니다.

### 2. 상품 옵션 선택 레이어 <a href="#id-2" id="id-2"></a>

상품 등록시 설정한 상품에 대한 단품 옵션 정보를 조회합니다.

* **옵션정보 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8/seltProductOptionInfo))\
  상품의 옵션 정보와 각 단품에 대한 금액, 재고 정보를 조회합니다.
  * 묶음상품을 조회하는 경우 해당 묶음상품의 대표 상품의 옵션목록이 조회됩니다.

```
GET /v1/detail/goodsOptionInfo 
```

**2.1 장바구니**

해당 상품의 옵션을 선택하고 **\[장바구니]** 버튼을 클릭하면 장바구니에 담고 장바구니 이동 안내 팝업이 나타납니다.

* **장바구니 등록 (**[🔗 API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88/registerBasket))\
  상품을 장바구니에 등록합니다. 비회원이고 최초 등록이라면 세션번호가 생성되어 쿠키에 저장됩니다.

```
POST /v1/basket/registerBasket  
```

**2.2 선물하기**

해당 상품의 옵션을 선택하고 **\[선물하기]** 버튼을 클릭하면 선물하기 화면으로 이동합니다.

**2.3 정기주문 신청하기**

해당 상품의 옵션을 선택하고 **\[정기주문 신청하기]** 버튼을 클릭하면 정기 주문 신청 화면으로 이동합니다.

**2.4 바로 구매하기**

해당 상품의 옵션을 선택하고 **\[바로 구매하기]** 버튼을 클릭하면 주문/결제 화면으로 이동합니다.

### 3. 재입고알림 신청 <a href="#id-3" id="id-3"></a>

로그인 사용자가 **\[재입고알림 신청]** 버튼을 클릭하면 재입고알립 신청 팝업이 나타납니다.

**3.1 알림신청**

알림유형과 알림을 받을 정보를 입력하여, 선택한 단품이 재입고 시 알림을 받을 수 있도록 신청합니다.

* **재입고 알림 신청 (** [🔗 API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%20%EC%9E%AC%EC%9E%85%EA%B3%A0/replenishApply))\
  로그인 사용자의 정보로 상품을 재입고 알림을 신청합니다.

```
POST /v1/replenish/replenishApply 
```

***

## 상품평 <a href="#plus" id="plus"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109881/%EC%83%81%ED%92%88%EC%83%81%EC%84%B8%20fo-4.drawio.png" alt=""></p>

### 1. 상품평 요약정보 <a href="#id-1" id="id-1"></a>

해당 상품에 등록된 전체 리뷰들의 정보를 확인할 수 있습니다.

* **상품별 상품평 요약정보 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%20%EB%A6%AC%EB%B7%B0%20%EA%B4%80%EB%A6%AC\&path=getReviewSummary))\
  상품리뷰 총 갯수, 평점, 평가통계, 평가통계등 상세한 리뷰의 정보를 조회합니다.

```
GET /v1/review/adv/goods/{goodsNo}/summary 
```

### 2. 상품평 사진/동영상 썸네일 <a href="#id-2" id="id-2"></a>

해당 상품에 등록된 리뷰의 이미지/동영상 썸네일을 조회합니다.

* **상품평 사진/동영상 썸네일 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%20%EB%A6%AC%EB%B7%B0%20%EA%B4%80%EB%A6%AC/getReviewRepresentThumbnailList))\
  작성된 상품리뷰의 사진과 동영상의 썸네일을 조회합니다.

```
GET /v1/review/adv/goods/{goodsNo}/represent/thumbnails
```

**2.1 더보기**

**\[더보기]** 버튼을 클릭하면 사진&동영상 모음 팝업이 나타납니다.

### 3. 상품평 목록 <a href="#id-3" id="id-3"></a>

* **상품별 상품평 정보 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%20%EB%A6%AC%EB%B7%B0%20%EA%B4%80%EB%A6%AC/getGoodsInfoAndReviewList))\
  상품별로 작성된 상품 리뷰의 정보를 조회합니다.

```
GET /v1/review/adv/goods/{goodsNo} 
```

**3.1 사진/동영상**

리뷰의 사진/동영상을 클릭하면 사진&동영상 팝업이 나타납니다

**3.2 상품평 도움돼요**

* **상품리뷰 도움돼요 등록 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%20%EB%A6%AC%EB%B7%B0%20%EA%B4%80%EB%A6%AC/updateAndGetReviewHelpful))\
  상품 리뷰에 등록된 도움 돼요 기능을 등록하고 등록된 총 개수를 조회합니다.

```
POST /v1/review/adv/helpful/{revNo} 
```

**3.3 상품평 신고**

리뷰에 **\[신고]** 버튼을 클릭하면 상품평 신고하기 팝업이 나타납니다.

### 4. 사진&동영상 모음 팝업 <a href="#id-4.-and" id="id-4.-and"></a>

해당 상품에 등록된 리뷰의 모든 사진과 동영상을 보여주는 팝업입니다.

**4.1 사진/동영상**

리뷰의 사진/동영상을 클릭하면 사진&동영상 팝업이 나타납니다.

### 5. 사진&동영상 팝업 <a href="#id-5.-and" id="id-5.-and"></a>

선택한 리뷰의 상세 내용을 보여주는 팝업입니다.

**5.1 전체보기**

**\[전체보기**] 버튼을 클릭하면 사진&동영상 모음 팝업이 나타납니다.

### 6. 상품평 신고하기 팝업 <a href="#id-6" id="id-6"></a>

상품평을 신고하는 팝업입니다

**6.1 신고하기**

\[신고하기] 버튼을 클릭하여 상품평 신고를 등록합니다.

* **상품평 신고 (** [🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%20%EB%A6%AC%EB%B7%B0%20%EA%B4%80%EB%A6%AC/insertReviewDeclaration))\
  상품평 신고를 등록합니다.

```
POST /v1/review/adv/declaration/{revNo}
```

***

## 상품 Q\&A  <a href="#plus-q-and-a" id="plus-q-and-a"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109881/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EC%83%81%ED%92%88%20QnA%EC%A1%B0%ED%9A%8C%ED%95%98%EA%B8%B0.drawio.png" alt=""></p>

&#x20;

### 1. 상품 Q\&A <a href="#id-1.-q-and-a" id="id-1.-q-and-a"></a>

* **상품별 Q\&A정보 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%20Q%26A%20%EA%B4%80%EB%A6%AC/getQnaAndGoods))\
  상품별 Q\&A 정보를 조회합니다.

```
GET /v1/qna/adv/goods/{goodsNo} 
```

### 2. 문의하기 <a href="#id-2" id="id-2"></a>

로그인한 고객이 **\[문의하기]** 버튼을 클릭하면 해당 상품에 대한 상품 Q\&A 작성을 위한 문의하기 팝업이 나타납니다.

**2.1 문의하기 팝업**

문의하기 작성을 위한 양식이 나타납니다.

**2.2 문의하기 버튼**

* **상품 Q\&A 등록 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%20Q%26A%20%EA%B4%80%EB%A6%AC/insertQna))\
  상품QnA를 등록합니다.

```
POST /v1/qna/adv 
```

***

## 묶음상품 상세보기  <a href="#plus" id="plus"></a>

X2BEE BO에서 묶음 상품으로 등록된 상품을 전시할 수 있습니다.

{% hint style="info" %}
**묶음 상품이란?**

2가지 이상의 제품을 단일가격에 판매하는 상품으로 판매촉진을 위한 판매 방법을 뜻하며,&#x20;

번들링이라고도 합니다.

상품을 묶음으로 판매하기도 하지만 개별적으로 분리하여 각 상품을 판매를 할 수 있습니다.
{% endhint %}

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109881/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EB%AC%B6%EC%9D%8C%EC%83%81%ED%92%88%20%EC%A1%B0%ED%9A%8C%ED%95%98%EA%B8%B0.drawio.png" alt=""></p>

### 1. 묶음 상품 요약 정보 <a href="#id-1" id="id-1"></a>

* **전시상품정보(전시상품요약) 조회 (**[🔗 API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8/seltProductSmryInfo))\
  상품의 요약된 정보 조회 API로 이미지는 상품의 대표이미지를 제공합니다.

```
POST /v1/detail/summary 
```

**1.1 상품 상세 보기 팝업**

묶음 상품의 상세정보에서 묶음상품 중 상품을 하나 클릭하면, 해당 상품의 상품 상세내용을 조회합니다.

팝업 내 상단 묶음상품 연관상품 이미지를 클릭하면 다른 상품의 상세내용을 조회합니다.

상품 상세 정보를 조회하는 API는 상품 상세 문서의 1. 상품 정보 조회하기를 참고해 주세요.

### 2. 상품평/상품 Q\&A <a href="#id-2.-q-and-a" id="id-2.-q-and-a"></a>

상품 상세 보기 팝업과 같이, 상품평/상품 Q\&A 상단에 묶음상품 연관상품이 나타납니다.

상품을 선택하여 상품평/상품 Q\&A를 상품별로 수 있도록 조회합니다.

&#x20;

<br>