> 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/display-bo/promotion-management.md).

# Promotion Management

Promotion Management is divided into Promotion Information Management and Promotion Group Management. This function manages promotion information based on site and mall, configures the promotion's basic information and information by separator, and allows adding or removing display products. It also allows grouping registered promotions for efficient management.

## Key Features

* **Promotion Information Management**
  * You can register promotion information based on site, mall, and promotion number (mkdpNo).
  * Manages the promotion's basic information and information by separator.
  * You can register images and videos as promotion content, with one allowed per display media.
  * You can select Text, Image, or HTML as the promotion separator type, and register content according to that type.
  * For each separator, you can register general products, products on sale, and out-of-stock products, and control the display order via the product display order.
* **Promotion Group Management**
  * You can register a promotion group based on site and mall.
  * You can look up and register sub-promotions per group, and control the display order via each promotion's display order.
* **Promotion Permission Check**
  * Promotion display can be restricted based on display member grade and employee status.
  * The permission check criteria is AND-based, and you can set the display member grade (GREEN) and employee-only status.
  * Depending on the configured permission, a promotion is displayed only to specific member grades or employees, or to all users.

***

## Process Definition — Promotion Management

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FdSv8k9mXW6L6tJc6Fg2s%2F%E1%84%80%E1%85%B5%E1%84%92%E1%85%AC%E1%86%A8%E1%84%8C%E1%85%A5%E1%86%AB%20%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B5.png?alt=media&#x26;token=264175d1-549e-482f-8899-055edbf1bc8b" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Promotion List

\- Looks up the full list of promotion information.\
\- Modifies/deletes the promotion information list.\
\- Copies a single promotion.\
\- The copied promotion name is fixed to 'Promotion Name + (Copy)', and the display status is fixed to Not Displayed.
{% endstep %}

{% step %}

### Promotion Registration/Modification Popup - Basic Information Tab

\- Looks up the promotion detail information.\
\- Looks up the promotion image detail information.\
\- Registers and modifies the promotion basic information.
{% endstep %}

{% step %}

### Promotion Registration/Modification Popup – Basic Information Multilingual Popup

\- Looks up the promotion basic information multilingual information.\
\- Registers/modifies the promotion basic information multilingual information.
{% endstep %}

{% step %}

### Promotion Registration/Modification Popup – Separator Tab

\- Looks up the promotion separator information.\
\- Registers/modifies the promotion separator information.
{% endstep %}

{% step %}

### Promotion Registration/Modification Popup – Separator Multilingual Popup

\- Looks up the promotion separator multilingual information.\
\- Registers/modifies the promotion separator multilingual information.
{% endstep %}

{% step %}

### Promotion Registration/Modification Popup – Product Information Tab

\- Looks up the separator grid list.\
\- Looks up the product grid list by separator.\
\- Saves the promotion product information tab information.
{% endstep %}

{% step %}

### Promotion Registration/Modification Popup – Bulk Product Registration Popup

\- Looks up duplicate and existing products in the corresponding separator.\
\- Looks up product information by separator.\
\- Bulk-saves promotion products via Excel.
{% endstep %}
{% endstepper %}

***

## API Function List — Promotion Management

<table><thead><tr><th width="111.2222900390625">API</th><th width="333.4443359375">Description</th><th width="93.5555419921875">Server</th><th width="89.1112060546875">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Promotion Information List Lookup</td><td>•Looks up the promotion information list.<br>•Displayed in descending order by display order, then descending by display start date.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getPrMkdpBaseList">🔗View API ></a></td></tr><tr><td>Promotion Information Management List Save</td><td>•Modifies/deletes the promotion information list.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveMarketingDisplayMgmtList">🔗View API ></a></td></tr><tr><td>Single Promotion Copy</td><td>•Copies a single promotion.<br>•The copied promotion name is fixed to 'Promotion Name + (Copy)', and the display status is fixed to Not Displayed.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=registerCopyMarketingDisplayMgmt">🔗View API ></a></td></tr><tr><td>Promotion Information Detail Lookup</td><td>•Looks up the promotion detail information.<br>•Looks up the corresponding information by promotion and language code.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getPrMkdpBaseDetail">🔗View API ></a></td></tr><tr><td>Promotion Image Detail Lookup</td><td>•Looks up the promotion image detail information.<br>•Looks up the corresponding information by promotion and language code.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getPrMkdpBaseDetail">🔗View API ></a></td></tr><tr><td>Promotion Basic Information Save</td><td>•Registers and modifies the promotion basic information.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=savePrMkdpBase">🔗View API ></a></td></tr><tr><td>Promotion Basic Information Multilingual Lookup</td><td>•Looks up the promotion basic information multilingual information.<br>•Looks up the corresponding basic information by promotion number and language code.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getPrMkdpBaseMultiLanguage">🔗View API ></a></td></tr><tr><td>Promotion Basic Information Multilingual Save</td><td>•Saves the promotion basic information multilingual information.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveMarketingDisplayMgmtBaseMl">🔗View API ></a></td></tr><tr><td>Promotion Separator Information Lookup</td><td>•Looks up the promotion separator detail information.<br>•Looks up the corresponding information by promotion and language code.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getPrMkdpDivobjMultiLanguage">🔗View API ></a></td></tr><tr><td>Promotion Separator Tab Save</td><td>•Registers/modifies/deletes the promotion separator information.</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>Promotion Separator Multilingual Information Lookup</td><td><p>•Looks up the promotion separator multilingual information.</p><p>•Looks up the corresponding multilingual information by promotion number and language code.</p></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>Promotion Separator Multilingual Information Save</td><td>•Saves the promotion separator multilingual information.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=savePrMkdpDivobjMl">🔗View API ></a></td></tr><tr><td>Promotion Separator Grid List Lookup</td><td>•Looks up the promotion separator grid list.<br>•Displayed in order of display order, then separator number.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getMarketingDisplayDivobjGridListpresearch.com/?utm_source=extcr">🔗View API ></a></td></tr><tr><td>Promotion Product Grid List by Separator Lookup</td><td>•Looks up the promotion product grid list by separator.<br>•Displayed in order of display order, then product registration date.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getDivobjGoodsGridList">🔗View API ></a></td></tr><tr><td>Promotion Product Grid Save</td><td>•Registers/modifies/deletes the promotion product grid list.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveDivobjGoodsGridList">🔗View API ></a></td></tr><tr><td>List Lookup Excluding Duplicate and Non-Existent Products</td><td>•Excludes duplicate and non-existent promotion products, and looks up and returns the corresponding information.<br>•If a product is a duplicate or does not exist, returns the result with a product error message included.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getValidDisplayGoodsList">🔗View API ></a></td></tr><tr><td>Promotion Product Information Detail Lookup</td><td>•Looks up the product detail information by promotion separator.<br>•Looks up the corresponding information by promotion number and separator number.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=getGoodsListDetail">🔗View API ></a></td></tr><tr><td>Promotion Product Bulk Save via Excel</td><td>•Bulk-saves promotion products via Excel.<br>•Registers excluding duplicate products.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EC%A0%95%EB%B3%B4%20%EA%B4%80%EB%A6%AC&#x26;path=saveMarketingMgmtExcelGoodsList">🔗View API ></a></td></tr></tbody></table>

***

## Process Definition — Promotion Group Management

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FJDgUPwCtw7yy226QEIgM%2F%E1%84%80%E1%85%B5%E1%84%92%E1%85%AC%E1%86%A8%E1%84%8C%E1%85%A5%E1%86%AB%20%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%20%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B5.png?alt=media&#x26;token=f4d9d4b7-4ea7-4a51-9430-7d9ac6a2c65f" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Promotion Group Management List

\- Looks up the promotion group list.\
\- Registers/modifies/deletes a promotion group.
{% endstep %}

{% step %}

### Promotion Group Management Multilingual Popup

\- Looks up the promotion group multilingual list.\
\- Registers/modifies the promotion group multilingual list.
{% endstep %}

{% step %}

### Sub-Promotion List

\- Looks up the sub-promotion list by group.\
\- Checks for duplicates before registering promotion information by group.\
\- Saves the sub-promotion list.
{% endstep %}

{% step %}

### Sub-Promotion Popup

\- Looks up the promotion information list.
{% endstep %}
{% endstepper %}

***

## API List — Promotion Group Management

<table><thead><tr><th width="119">API</th><th width="374.77783203125">Description</th><th width="93.5555419921875">Server</th><th width="91.3333740234375">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Promotion Group List Lookup</td><td>•Looks up the promotion group information list.<br>•Displayed in ascending order by display order, then descending by<br>registration date.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getPrDispGrpBaseList">🔗View API ></a></td></tr><tr><td>Sub-Promotion List Lookup</td><td>•Looks up the list of promotions belonging to a group.<br>•Displayed in ascending order by display order, then descending by display start date.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=savePrDispGrpMappInfoList">🔗View API ></a></td></tr><tr><td>Duplicate Check on Sub-Promotion List Save</td><td>•Checks for duplicates when saving the sub-promotion list.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getMarketingDisplayGroupMgmtSubMarketingDisplayChk">🔗View API ></a></td></tr><tr><td>Promotion Information List Lookup</td><td>•Promotion popup – looks up the promotion information list.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getMarketDisplayList">🔗View API ></a></td></tr><tr><td>Promotion Group List Register/<br>Modify/Delete</td><td>•Registers/modifies/deletes the promotion group information list.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=savePrDispGrpBaseList">🔗View API ></a></td></tr><tr><td>Sub-Promotion List Save</td><td>•Registers/modifies/deletes the sub-promotion list.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=savePrDispGrpMappInfoList">🔗View API ></a></td></tr><tr><td>Promotion Group Multilingual List Lookup</td><td>•Looks up the promotion group multilingual information.<br>•Looks up the corresponding information by display group number and display group type code.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=getMarketingDisplayGroupMultiLanguageList">🔗View API ></a></td></tr><tr><td>Promotion Group Multilingual List Save</td><td>•Saves the promotion group multilingual list.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=display&#x26;depth=%EA%B8%B0%ED%9A%8D%EC%A0%84%20%EA%B7%B8%EB%A3%B9%20%EA%B4%80%EB%A6%AC&#x26;path=saveMarketingDisplayGroupMultiLanguageList">🔗View API ></a></td></tr></tbody></table>

***

## Terminology

<table><thead><tr><th width="131.7777099609375">Term</th><th>Description</th><th data-hidden>Remarks</th></tr></thead><tbody><tr><td>Display Period</td><td>Refers to the period during which a promotion is displayed in the promotion list.<br>A promotion cannot be entered once its display period has ended.</td><td></td></tr><tr><td>Template</td><td>Configures the promotion detail page according to the promotion template.<br>Currently, there are 4 templates (Promotion Template 1, 2, 3, 4).</td><td></td></tr><tr><td>Member Grade</td><td>Restricts promotion display based on member grade.<br>Member grades: GREEN, FAMILY, GOLD, VIP, VVIP</td><td></td></tr><tr><td>Employee Only</td><td>Restricts promotion display based on whether employee status applies.</td><td></td></tr><tr><td>Promotion Separator</td><td>A term referring to a division area on the promotion detail page.<br>Each promotion separator includes separator information, coupon banners, and a product list.</td><td></td></tr></tbody></table>

***