> 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/sku-information-management.md).

# SKU Information Management

Provides functionality to look up and manage the detail information of a product's SKUs. It also provides an **Option Information Management API** for looking up and managing option information.

***

#### Key Features

* **SKU Lookup and Bulk Modification**
  * You can look up SKU information using various conditions such as product registration date, partner number, and standard category.
  * Based on the lookup results, you can bulk-modify the sale status, safety stock threshold quantity, stock quantity, and so on.
* **Option Lookup and Management**
  * You can look up the option classification code list and option code list according to the option classification type and use status.
  * You can register images and RGB values for the looked-up option code list.
  * The registered values can be checked on the FO product detail page.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2F6sIy4ucIYXo7oG3PkZRQ%2F%E1%84%83%E1%85%A1%E1%86%AB%E1%84%91%E1%85%AE%E1%86%B7%20%E1%84%8C%E1%85%A5%E1%86%BC%E1%84%87%E1%85%A9%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B5.png?alt=media&#x26;token=0f012287-6a2a-4a8a-a66d-6f5ccd7a4610" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### SKU List Lookup

* Looks up the SKU list according to the search conditions
* SKUs can be looked up by specifying the full-period search option and the out-of-stock status
  {% endstep %}

{% step %}

### SKU Management List Save

* Saves the modified SKU management list
* You can change the stock quantity, safety stock threshold quantity, safety stock notification status, and so on
* Sends an error if the product number or SKU number is not entered
  {% endstep %}

{% step %}

### Bulk Change Safety Stock Notification Threshold Quantity

* Bulk-changes the safety stock notification threshold quantity of the selected SKUs
* Only changed if the safety stock notification status is 'Y'
* Sends an error if the product number, SKU number, or safety stock notification threshold quantity is not entered
  {% endstep %}

{% step %}

### Bulk Change Stock Quantity

* Bulk-changes the stock quantity of the selected SKUs
* Only changed if the stock management status is 'Y'
* Sends an error if the product number, SKU number, or stock quantity is not entered
  {% endstep %}

{% step %}

### SKU Out-of-Stock Processing

* Processes the selected SKU list as Out of Stock
* Called for out-of-stock processing from Stockout Management in the Shipping module
  {% endstep %}
  {% endstepper %}

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FuZg6IRN9SihbtL3eUEKZ%2Fimage.png?alt=media&#x26;token=a75acf6b-909a-41b8-810e-cf4d2f65c62f" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Option Classification Code List Lookup

* Provides the function to look up the option classification code information list
* Sort order is ascending, modification date/time is descending
  {% endstep %}

{% step %}

### Option Code List Lookup

* Looks up the option code information list based on the option classification number
* Sort order is ascending, modification date/time is descending
  {% endstep %}

{% step %}

### Option Classification Code List Save

* Provides the function to save the option classification code information list
* When the option classification name is modified, the option classification name in the SKU option information is also modified
* The option classification name cannot be duplicated
* Validates the option classification code information when saving the list
  {% endstep %}

{% step %}

### Option Code List Save

* Saves the option code information list
* When the option name is modified, the option name in the SKU option information is also modified
  {% endstep %}
  {% endstepper %}

## API Function List

<table><thead><tr><th width="101.22216796875">API</th><th width="377.6666259765625">Description</th><th width="95.7777099609375">Server</th><th width="91.3333740234375">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Bulk Change Safety Stock Notification Threshold Quantity</td><td>•Bulk-changes the safety stock notification threshold quantity of the selected SKUs.<br>•Only applied if the safety stock notification status is Y; not applied if N.<br>•If the safety stock notification status is N, the safety stock notification threshold quantity is reset.</td><td>BO</td><td>POST</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>Bulk Change Stock Quantity</td><td>•Bulk-changes the stock quantity of the selected SKUs.<br>•Only applied if the stock management status is Y; not applied if N.</td><td>BO</td><td>POST</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>SKU Out-of-Stock Processing</td><td>•Processes the SKU list as Out of Stock.<br>•Called for out-of-stock processing from Stockout Management in the Shipping module.</td><td>BO</td><td>POST</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>Option Classification Code List Lookup</td><td>•Looks up the option classification code information list.<br>•Sort order is ascending, modification date/time is descending.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=goods&#x26;depth=%EC%98%B5%EC%85%98%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getOptionList">🔗View API ></a></td></tr><tr><td>Option Code List Lookup</td><td>•Looks up the option code information list based on the option classification number.<br>•Sort order is ascending, modification date/time is descending.</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>Option Classification Code List Save</td><td>•Saves the option classification code information list.<br>•When the option classification name is modified, the option classification name in the SKU option information is also modified.<br>•Validates the entered option classification code information when saving the option classification code list.<br>•The option classification name cannot be duplicated.</td><td>BO</td><td>POST</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>Option Code List Save</td><td>•Saves the option code information list.<br>•When the option classification name is modified, the option classification name in the SKU option information is also modified.<br>•Validates the entered option classification code information when saving the option code list.</td><td>BO</td><td>POST</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></tbody></table>

## Terminology

<table><thead><tr><th width="96.22216796875">Term</th><th>Description</th><th data-hidden></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.<br>•A product is the unit in which price is managed.</td><td></td></tr><tr><td>SKU</td><td><p>•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.</p><ul><li>(e.g.) SKU A: Color-Black/Size-260 / SKU B: Color-Black/Size-250</li></ul></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.<br>•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></tbody></table>

<br>
