> 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/api-guides-en/back-office/goods-bo/product-management.md).

# Product Management

Product Management supports comprehensive management of products, providing functions such as product search, promotional message management, product approval, and product modification history. It enables efficient searching through search conditions, and manages history when a product is modified so that changes can be tracked.

***

## Key Features

* **Product Information Management**
  * You can search products by various conditions, and filter by sale status, product type, promotional message, standard category, and so on.
* **Promotional Message Management**
  * You can look up and register/modify from the product detail popup, and duplicate period registration is checked.
  * Processes the CUD information of the promotional message grid per product.
* **Product Modification History**
  * A modification history is kept each time product information is modified, and the modification history lookup function lets you check the details of changes.
  * The modification history includes the modified item, before/after values, the modifier, and the modification date/time.
* **Product Approval Management**
  * You can look up the product approval list using various conditions such as approval status, product composition, partner, responsible MD, and product name.
  * Provides approval and rejection functions, and a rejected product can be requested for re-approval.

***

## Process Definition — Product Information Management

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FIGLNpN9RbU76yUnBvnUO%2F%E1%84%89%E1%85%A1%E1%86%BC%E1%84%91%E1%85%AE%E1%86%B7%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B5.png?alt=media&#x26;token=28433317-7621-4508-bc36-44fbbfce3794" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Product List Lookup

Provides functionality to look up products by various conditions\
The product lookup results display the product basic information, product content information, brand information, and partner basic information in the list
{% endstep %}

{% step %}

### Promotional Message List Lookup

Looks up promotional messages matching the entered application date/time, product name, product number, use status, and promotional message\
The lookup result list provides the product number, product name, promotional message, application start date/time, application end date/time, and use status
{% endstep %}

{% step %}

### Promotional Message Modification

Provides functionality to process the CUD information of the promotional message grid per product\
Provides validation to ensure the application start date/time and application end date/time do not overlap
{% endstep %}

{% step %}

### Product Information Modification History List Lookup

Provides functionality to look up the modification information of modified items\
\
Search conditions provided: modification date, modified item, product name, product number\
\
Example modified items: safety certification target status, purchaser age restriction, display status, sale status, stock management status, purchase quantity restriction status, minimum quantity limit, maximum quantity limit, shipping product classification, SKU out-of-stock notification status, shipping policy number, price comparison exposure status, sale method, safety stock notification status, mileage accumulation availability, gift availability, and so on
{% endstep %}

{% step %}

### Modified Product Information Lookup

Looks up the detailed modified item content per product\
Provides the current attribute values of the product's modified items
{% endstep %}

{% step %}

### Product Approval List Lookup

Provides functionality to look up products by various conditions\
\
Approval request product search conditions: approval request date, approval status, product composition, product type, sale method, purchase type, partner, responsible MD, product name, product number\
\
The lookup result list shows approval status, rejection reason, product composition, product type, sale method, responsible MD, product number, product name, model name, tax/tax-exempt status, purchase type, list price, sale price, margin rate, partner, brand, shipping processing type, product registration date/time, and product approval date
{% endstep %}

{% step %}

### Product Approval

Upon approval, changes the status to On Sale\
Upon approval request, validation is performed before changing to On Sale, and error content is delivered if it fails
{% endstep %}

{% step %}

### Save Product Rejection Reason

Select one of the rejection reason items for a product to process rejection\
A rejected product can be re-approved
{% endstep %}
{% endstepper %}

***

## Process Definition — Promotional Message Management

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FFIr88av4P3VaUggCoSAm%2F%E1%84%92%E1%85%A9%E1%86%BC%E1%84%87%E1%85%A9%E1%84%86%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AE%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B5.png?alt=media&#x26;token=45ca4df1-ae41-4e63-aa2f-0184bdfbb5f0" alt=""><figcaption></figcaption></figure>

***

## Process Definition — Product Modification History

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2F5q9ndCJVZDolKetOejnQ%2F%E1%84%89%E1%85%A1%E1%86%BC%E1%84%91%E1%85%AE%E1%86%B7%E1%84%8C%E1%85%A5%E1%86%BC%E1%84%87%E1%85%A9%20%E1%84%89%E1%85%AE%E1%84%8C%E1%85%A5%E1%86%BC%E1%84%8B%E1%85%B5%E1%84%85%E1%85%A7%E1%86%A8.png?alt=media&#x26;token=68fcd46b-e360-487a-873e-711f630a2e69" alt=""><figcaption></figcaption></figure>

***

## Process Definition — Product Approval Management

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FtdwaaNu4IqGjUWdLZD5E%2F%E1%84%89%E1%85%A1%E1%86%BC%E1%84%91%E1%85%AE%E1%86%B7%E1%84%89%E1%85%B3%E1%86%BC%E1%84%8B%E1%85%B5%E1%86%AB%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B5.png?alt=media&#x26;token=0d1ecff7-4b1c-44a6-8e97-a5844c22465a" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Product Approval List Lookup

Provides functionality to look up products by various conditions\
\
Approval request product search conditions: approval request date, approval status, product composition, product type, sale method, purchase type, partner, responsible MD, product name, product number\
\
The lookup result list shows approval status, rejection reason, product composition, product type, sale method, responsible MD, product number, product name, model name, tax/tax-exempt status, purchase type, list price, sale price, margin rate, partner, brand, shipping processing type, product registration date/time, and product approval date
{% endstep %}

{% step %}

### Product Approval

Upon approval, changes the status to On Sale\
Upon approval request, validation is performed before changing to On Sale, and error content is delivered if it fails
{% endstep %}

{% step %}

### Save Product Rejection Reason

Select one of the rejection reason items for a product to process rejection\
A rejected product can be re-approved
{% endstep %}
{% endstepper %}

***

## API Function List

<table><thead><tr><th width="100.111083984375">API</th><th width="413.2222900390625">Description</th><th width="96.8887939453125">Server</th><th width="89.111083984375">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Product List Lookup</td><td><ul><li>Looks up the product list according to the product search conditions.</li><li>If a product number is entered among the search conditions, ignores the product registration period condition and looks up.</li><li>Looks up using the search conditions of registration date/last modified date lookup period, sale status, responsible MD, product name, brand, partner, and product number (starts with, contains, equals, multi, range, contains (multi)).</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">🔗View API ></a></td></tr><tr><td>Promotional Message List Lookup</td><td><ul><li>Looks up promotional messages matching the entered application date/time, product name, product number, use status, and promotional message.</li><li>Looked up in order of most recent modification date/time.</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">🔗View API ></a></td></tr><tr><td>Promotional Message Modification</td><td><ul><li>Adds/modifies/deletes the promotional message information per product, based on the grid's promotional message CUD information.</li><li>Validates that there is no overlapping promotional message at the application date/time.</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">🔗View API ></a></td></tr><tr><td>Product Approval List Lookup</td><td><ul><li>Looks up only products with sale status Pending Approval/Rejected.</li><li>Looks up products matching the entered approval request date, approval status, product composition, product type, sale method, purchase type, partner number/name, responsible MD, product name, and product number.</li><li>Looks up in reverse order of product registration date</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">🔗View API ></a></td></tr><tr><td>Product Approval</td><td><ul><li>Only products with sale status Pending Approval can be approved.</li><li>Changes the sale status of the product and its SKUs from Pending Approval to On Sale.</li><li>Creates new data in the product basic modification log, product-level sale status history, SKU additional price history, and SKU basic ML tables.</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">🔗View API ></a></td></tr><tr><td>Save Product Rejection Reason</td><td><ul><li>Only products with sale status Pending Approval can be rejected.</li><li>Saves the rejection reason and detailed rejection reason content, and changes the product's sale status from Pending Approval to Rejected.</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">🔗View API ></a></td></tr><tr><td>Product Information Modification History List Lookup</td><td><ul><li>Looks up products matching the entered modification date, modified item, product name, and product number.</li><li>Looks up in order of most recently registered product information modification history</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">🔗View API ></a></td></tr><tr><td>Modified Product Information Lookup</td><td><ul><li>Looks up the information of the product selected in the product information modification history</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">🔗View API ></a></td></tr></tbody></table>

***

## Terminology

<table><thead><tr><th width="138.4444580078125">Term</th><th>Description</th><th data-hidden>Remarks</th></tr></thead><tbody><tr><td>Product</td><td>• Refers to all goods that are the subject of sale through a commerce channel.<br>• It is the basic unit in which a product is displayed, and the basic unit that makes up the product detail screen. • A product is the unit in which price is managed.</td><td></td></tr><tr><td>SKU</td><td>• The minimum management unit under a product, i.e. the minimum unit of product stock and sale — the unit the customer actually purchases.<br>• The unit that manages ordered product information according to the customer's selected options.<br>• The unit in which stock is managed. (In this solution, stock refers to 'web stock'.)<br>• SKU information is created from a combination of options. (e.g.) SKU A: Color-Black/Size-260 / SKU B: Color-Black/Size-250</td><td></td></tr><tr><td>Option</td><td>• The basic unit for creating product variations.<br>• Items such as 'Color' and 'Size' are called the option name, and 'Black', 'XL', and so on are called option values. • Option types include most of the types used in commerce, such as gender, color, size, weight, capacity, and region, and additional types can be added per site as needed.</td><td></td></tr><tr><td>General Product (Classification)</td><td>• Refers to all goods products that undergo general shipping.</td><td></td></tr><tr><td>Gift (Classification)</td><td>• Refers to a product provided at no additional cost to customers who meet certain conditions, such as purchasing a specific product or purchasing over a certain amount, through a promotion or event.</td><td></td></tr><tr><td>General Product</td><td>• Refers to a product managed by coding the product's options into SKUs.<br>• Stock deduction is performed at the SKU level.</td><td></td></tr><tr><td>Bundle Product</td><td>• Refers to a bundle product for display purposes, regardless of whether a discount applies.<br>• Purchased by selecting some of the products that make up the option composition.</td><td></td></tr><tr><td>Reservation Product</td><td>• Refers to a product that is pre-ordered over a certain period and shipped together on the delivery notification date.<br>• A reservation product is registered by selecting the SKU, which is the sale unit. An SKU can only be looked up and selected if the display period of the reservation product information falls within the product's display period.</td><td></td></tr></tbody></table>

***