Promo Price

A promo price is a temporary retail price for one item during a date range.

Promo prices are separate from normal prices. Normal prices are the regular saved prices; promo prices are date-bounded overrides used for promotional work.

Where To Find It

Open Pricing in the Web client.

Screen	Route	Use it to
Retail Promo	`/v2/price-promo/retail`	View and manage retail promo prices.
New Retail Promo	`/v2/price-promo/retail/new`	Create a retail promo price.
Promo detail	`/v2/price-promo/retail/:id`	View or edit one retail promo price.

What Staff See

The promo price list shows:

Area	Notes
Promo name	English and Korean promo names.
Item	Item name, item code, and barcode for the item receiving the promo.
Default promo price	The first promo price level.
Valid date range	Start and end dates for the promo.
Expired badge	Shows when the promo end date has already passed.
Archived badge	Shows when the promo has been archived.

Required Fields

Field	Required?	Notes
Item	Yes	The item receiving the promo price. Cannot be changed after creation.
Name (EN)	Yes	English promo name.
Name (KO)	Yes	Korean promo name.
Valid From	Yes	Promo start date.
Valid To	Yes	Promo end date. Must be after `Valid From`.
Default Price	Yes	First and most important promo price level.
Level 1 to Level 4	No	Optional extra promo price levels. Blank levels repeat the previous price.
Archived	Edit only	Hides the promo without deleting it.

Prices are entered in dollars on the screen.

Normal Price Reference

When an item is selected, the form shows the current normal price as a reference:

Reference	Meaning
Default	The item's current normal default price.
Markup	The normal price target margin rate.
Levels	The normal price levels, shown as `L0` to `L4`.

Use this reference to compare the promo price against the regular retail price.

Open Pricing > Retail Promo.
Click New Promo.
Select an item.
Enter English and Korean promo names.
Select Valid From and Valid To.
Enter the default promo price and any extra levels.
Review the normal price reference and price tag preview.
Save.

Open the promo list.
Select a promo price.
Update names, date range, price levels, or archived state.
Save.

Expired promos cannot be edited from the form.

Use the search box on the promo price list. Search checks:

Promo English name
Promo Korean name
Item English name
Item Korean name
Item code
Item barcode

This means staff can find a retail promo even when they remember the item code or barcode instead of the promo name.

Required Roles

Action	Required role
View retail promo prices	`pricing.read` or `pricing.manage`
View one promo price	`pricing.read` or `pricing.manage`
Create a promo price	`pricing.manage`
Update or archive a promo price	`pricing.manage`

Common Problems

Problem	What it means
`Select an item`	No item has been selected.
`Name (EN) is required`	The English promo name is empty.
`Name (KO) is required`	The Korean promo name is empty.
`Date range is required`	One or both promo dates are missing.
`From must be before To`	The start date is after the end date.
`Default price is required`	The first promo price level is empty or zero.
`Promo price overlaps with existing price`	Another active promo already overlaps this item, price type, and date range.
Expired promo cannot be edited	The promo end date has already passed.
An older promo does not appear by item keyword	Some older promo prices may only match the promo name until they are reviewed and saved again.

Promo Price

On this page