> 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/back-office/goods-bo/undefined-1.md).

# 상품관리

상품관리는 상품에 대한 종합적인 관리를 지원하는데, 상품 검색, 홍보문구 관리, 상품 승인, 상품 수정 이력 등의 기능을 제공합니다. 검색조건을 통한 효율적인 검색과 함께 상품 수정 시 이력을 관리하여 변경 내용을 추적할 수 있습니다.

***

## 주요 기능

* **상품 정보 관리**
  * 상품을 다양한 조건으로 검색할 수 있으며, 판매상태, 상품유형, 홍보문구, 표준카테고리 등의 필터링이 가능합니다.
* **홍보 문구 관리**
  * 상품 상세 팝업에서 조회 및 등록/수정이 가능하며, 중복 기간 등록에 대한 체크를 수행합니다.
  * 상품별 홍보문구 그리드의 홍보문구 CUD정보를 처리합니다.
* **상품 수정 이력**
  * 상품 정보가 수정될 때마다 수정 이력을 남기며, 수정 이력 조회 기능을 통해 변경 내용을 상세히 확인할 수 있습니다.
  * 수정 이력에는 수정 항목, 수정 전, 수정 후, 수정자, 수정일시 등의 정보가 포함됩니다.
* **상품 승인 관리**
  * 승인 상태, 상품 구성, 협력사, 담당MD, 상품명 등의 다양한 조건으로 상품 승인목록을 조회할 수 있습니다.
  * 승인 및 반려 기능을 제공하며, 반려된 상품은 재승인을 요청할 수 있습니다.

***

## 프로세스 정의 — 상품 정보 관리

<figure><img src="/files/bCDmO9I0EEJ9yQtYrhRO" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 상품 목록 조회

여러 조건으로 상품을 조회할 수 있게 기능 제공\
상품 조회결과로 상품기본정보, 상품컨텐츠정보, 브랜드정보, 협력사기본정보를 목록에 노출
{% endstep %}

{% step %}

### 홍보문구 목록 조회

입력한 적용일시, 상품명, 상품번호, 사용여부, 홍보문구에 해당하는 홍보문구를 조회\
조회 목록 결과정보로 상품번호, 상품명, 홍보문구, 적용시작일시, 적용종료일시, 사용여부 제공
{% endstep %}

{% step %}

### 홍보문구 수정

상품별 홍보문구 그리드 CUD정보를 처리하는 기능 제공\
적용시작일시, 적용종료일시가 중복되지 않게 검증 기능 제공
{% endstep %}

{% step %}

### 상품정보 수정이력 목록 조회

수정항목들의 수정정보 조회 기능 제공\
\
조회조건으로 수정일자, 수정항목, 상품명, 상품번호 제공\
\
수정항목 예시: 안전인증대상여부, 구입자나이제한, 전시여부, 판매상태, 재고관리여부, 구매수량제한여부, 최소제한수량, 최대제한수량, 배송상품구분, 단품품절알림여부, 배송정책번호, 가격비교노출여부, 판매방식, 안전재고알림여부, 마일리지적립가능여부, 선물하기가능여부 등
{% endstep %}

{% step %}

### 수정상품 정보 조회

상품별 상세 수정항목 내용 조회\
상품의 수정항목들의 현재 속성값을 제공
{% endstep %}

{% step %}

### 상품 승인 목록 조회

여러 조건으로 상품을 조회할 수 있게 기능 제공\
\
승인요청상품 조회조건: 승인요청일자, 승인상태, 상품구성, 상품유형, 판매방식, 매입형태, 협력사, 담당MD, 상품명, 상품번호 제공\
\
조회결과로 승인상태, 반려사유, 상품구성, 상품유형, 판매방식, 담당MD, 상품번호, 상품명, 모델명, 과/면세구분, 매입형태, 정상가, 판매가, 마진율, 협력사, 브랜드, 배송처리유형, 상품등록일시, 상품승인일자 목록에 노출
{% endstep %}

{% step %}

### 상품승인

승인 시 판매중 상품으로 상태 변경 처리\
승인요청 시 판매중 처리 전에 검증을 거쳐 실패할 경우 오류 내용 전달
{% endstep %}

{% step %}

### 상품반려사유저장

상품의 반려사유 항목들 중 한 개를 선택하여 반려 처리\
반려된 상품은 재승인 가능
{% endstep %}
{% endstepper %}

***

## 프로세스 정의 — 홍보 문구 관리

<figure><img src="/files/m96uRFZGwz5Qr9RU40rk" alt=""><figcaption></figcaption></figure>

***

## 프로세스 정의 — 상품 수정 이력

<figure><img src="/files/Q84PHh1zf0LiwGQ0t5nR" alt=""><figcaption></figcaption></figure>

***

## 프로세스 정의 — 상품 승인 관리

<figure><img src="/files/Sj3107WpkCOqevmBWGSQ" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 상품 승인 목록 조회

여러 조건으로 상품을 조회할 수 있게 기능 제공\
\
승인요청상품 조회조건: 승인요청일자, 승인상태, 상품구성, 상품유형, 판매방식, 매입형태, 협력사, 담당MD, 상품명, 상품번호 제공\
\
조회결과로 승인상태, 반려사유, 상품구성, 상품유형, 판매방식, 담당MD, 상품번호, 상품명, 모델명, 과/면세구분, 매입형태, 정상가, 판매가, 마진율, 협력사, 브랜드, 배송처리유형, 상품등록일시, 상품승인일자 목록에 노출
{% endstep %}

{% step %}

### 상품승인

승인 시 판매중 상품으로 상태 변경 처리\
승인요청 시 판매중 처리 전에 검증을 거쳐 실패할 경우 오류 내용 전달
{% endstep %}

{% step %}

### 상품반려사유저장

상품의 반려사유 항목들 중 한 개를 선택하여 반려 처리\
반려된 상품은 재승인 가능
{% endstep %}
{% endstepper %}

***

## API 기능 목록

<table><thead><tr><th width="100.111083984375">API</th><th width="413.2222900390625">설명</th><th width="96.8887939453125">Server</th><th width="89.111083984375">메소드</th><th>비고</th></tr></thead><tbody><tr><td>상품 목록 조회</td><td><ul><li>상품 검색 조건에 따라 상품 리스트를 조회합니다.</li><li>검색조건 중 상품 번호를 입력한 경우 상품 등록기간 조건을 무시하고 조회합니다.</li><li>검색조건으로 등록일/최종수정일 조회기간, 판매상태, 담당MD, 상품명, 브랜드, 협력사, 상품번호(시작, 포함, 같음, 멀티, 범위, 포함(멀티)) 조건으로 조회합니다.</li></ul></td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getGoodsList">🔗API 확인하기 ></a></td></tr><tr><td>홍보문구 목록 조회</td><td><ul><li>입력한 적용일시, 상품명, 상품번호, 사용여부, 홍보문구에 해당하는 홍보문구를 조회합니다.</li><li>최근 수정일시 순으로 조회합니다.</li></ul></td><td>BO</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=common&#x26;depth=%EC%95%8C%EB%A6%BC%EB%A9%94%EC%8B%9C%EC%A7%80&#x26;path=sendMessage">🔗API 확인하기 ></a></td></tr><tr><td>홍보문구 수정</td><td><ul><li>그리드의 홍보문구 CUD정보를 받아서 상품별 홍보문구 정보를 추가/수정/삭제를 합니다.</li><li>적용일시에 중복되는 홍보문구가 있는지 검증합니다.</li></ul></td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%ED%99%8D%EB%B3%B4%EB%AC%B8%EA%B5%AC%EA%B4%80%EB%A6%AC&#x26;path=saveAdvertisingWordList">🔗API 확인하기 ></a></td></tr><tr><td>상품 승인 목록 조회</td><td><ul><li>판매상태가 승인대기/반려인 상품만 조회합니다.</li><li>입력한 승인요청일자, 승인상태, 상품구성, 상품유형, 판매방식, 매입형태, 협력사 번호/명, 담당 MD, 상품명, 상품번호에 맞는 상품을 조회합니다.</li><li>상품 등록일 역순으로 조회합니다</li></ul></td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getGoodsList">🔗API 확인하기 ></a></td></tr><tr><td>상품승인</td><td><ul><li>판매상태가 승인대기인 상품만 승인이 가능합니다.</li><li>상품과 상품에 해당하는 단품의 판매상태를 승인대기에서 판매중으로 변경합니다.</li><li>상품기본 수정로그, 상품기준 판매상태이력, 단품 추가 가격이력, 단품기본ML 테이블의 신규데이터를 생성합니다.</li></ul></td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%20%EC%8A%B9%EC%9D%B8%20%EA%B4%80%EB%A6%AC&#x26;path=approveGoods">🔗API 확인하기 ></a></td></tr><tr><td>상품반려사유저장</td><td><ul><li>판매상태가 승인대기인 상품만 반려가 가능합니다.</li><li>반려사유, 반려사유상세 내용을 저장하고, 상품의 판매상태를 승인대기에서 반려로 변경합니다.</li></ul></td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%20%EC%8A%B9%EC%9D%B8%20%EA%B4%80%EB%A6%AC&#x26;path=returnGoodsapibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%20%EA%B3%B5%ED%86%B5&#x26;path=getDisplayCategoryListByStandardCategory">🔗API 확인하기 ></a></td></tr><tr><td>상품정보 수정이력 목록 조회</td><td><ul><li>입력한 수정일자, 수정항목, 상품명, 상품번호에 맞는 상품을 조회합니다.</li><li>최근 등록된 상품정보 수정이력 순으로 조회합니다</li></ul></td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%EC%A0%95%EB%B3%B4%20%EC%88%98%EC%A0%95%EC%9D%B4%EB%A0%A5&#x26;path=getGoodsInfoModificationHistoryList">🔗API 확인하기 ></a></td></tr><tr><td>수정상품 정보 조회</td><td><ul><li>상품정보 수정이력에서 선택된 상품의 정보를 조회합니다</li></ul></td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%83%81%ED%92%88%EC%A0%95%EB%B3%B4%20%EC%88%98%EC%A0%95%EC%9D%B4%EB%A0%A5&#x26;path=getModifiedGoodsInfoList">🔗API 확인하기 ></a></td></tr></tbody></table>

***

## 용어 정의

<table><thead><tr><th width="138.4444580078125">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>상품</td><td>• 상거래 채널을 통해 판매의 대상이 되는 모든 재화를 의미합니다. <br>• 상품을 전시하는 기본 단위이며 상품 상세 화면을 구성하는 기본 단위가 됩니다. • 상품은 가격을 관리하는 단위입니다.</td><td></td></tr><tr><td>단품</td><td>• 상품 하위의 최소 관리 단위로 상품 재고 및 판매의 최소 단위, 즉 고객이 구입하게 되는 단위입니다. <br>• 고객의 선택 옵션에 따른, 주문 상품 정보를 관리하는 단위입니다. <br>• 재고를 관리하는 단위입니다. (솔루션에서 재고는 ‘웹재고’를 의미합니다.) <br>• 옵션의 조합으로 단품 정보가 생성됩니다. (예) 단품A : 컬러-블랙/사이즈-260 / 단품B : 컬러-블랙/사이즈-250</td><td></td></tr><tr><td>옵션</td><td>• 상품을 베리에이션하는 기본 단위입니다. <br>• ‘컬러’, ‘사이즈’ 등의 항목을 옵션명이라 하며 ‘블랙’, ‘XL’등을 옵션값이라 합니다. • 옵션 유형은 성별, 색상, 크기, 중량, 용량, 지역 등 대부분의 커머스에 사용하는 유형이 존재하며 사이트별 필요시 추가하여 사용할 수 있습니다.</td><td></td></tr><tr><td>일반상품 (구분)</td><td>• 일반적인 배송이 이루어지는 모든 재화 상품을 의미합니다.</td><td></td></tr><tr><td>사은품 (구분)</td><td>•  프로모션이나 이벤트 등을 통해 특정 상품 구매 혹은 특정한 액수 이상 구매 등과 같이 일정한 조건을 충족하는 고객에 한하여, 추가 비용 없이 지급하는 상품을 의미합니다.</td><td></td></tr><tr><td>일반상품</td><td>• 단품에 상품의 옵션을 코드화에서 관리하는 상품을 의미합니다. <br>• 재고 차감은 단품 단위로 이루어 집니다.</td><td></td></tr><tr><td>묶음상품</td><td>• 할인 여부와 상관없이 전시 활용을 위한 묶음 상품을 의미합니다. <br>• 옵션 구성 상품을 일부 선택하여 구매합니다.</td><td></td></tr><tr><td>예약상품</td><td>• 일정 기간 동안 사전 주문하여 배송안내일에 일괄 배송하는 상품을 의미합니다. <br>• 예약상품은 판매단위인 단품 단위로 선택하여 등록합니다. 예약상품 정보의 전시기간이 상품의 전시기간에 포함되는 경우만 단품 조회 및 선택 가능합니다.</td><td></td></tr></tbody></table>

***