← API Index

Reduced prices (durchgestrichene Preise)

A shop may announce a price reduction by showing the former, higher price struck through next to the current price. The platform detects reductions automatically: it records every item's price once a day and compares the current price with the recorded one. The shop operator decides in the admin settings whether the feature is on and how big a reduction must be (minimum percentage and/or minimum amount) and for how many days it is announced.

As an API client you do not have to compute anything. You get the result as one field per item.

Note: There is also a different reduce (or increase) price tag in carts, that indicates price changes of an item that is already in a cart for a while. Different feature.

The field: Item.lastPrice

Available in the Item response type from version 22 on (position 35), returned by /api/items20 and later, /api/item1, /api/assortment13 and the item lists embedded in /api/order27 and later.

Value Meaning
lastPrice > 0 Announce a reduction: lastPrice is the former price, price the current one. lastPrice is always higher than price.
lastPrice == 0 Nothing to announce. Either the feature is off, the price did not fall, the reduction is below the operator's thresholds, or the announcement period is over.

Points that are easy to miss:

Display

The standard shop renders the former price struck through, in red, in front of or above the current price, in item lists as well as on item detail pages. Keep the two prices visually distinct so that the customer cannot mistake the struck price for the price to pay.

Do not confuse three different "lower price" mechanisms, which can all appear on the same item:

Mechanism Field(s) What the customer sees in the standard shop
Reduced price (this skill) lastPrice former price struck through
Customer discount maxDiscount, the customer's discount list price struck through, discounted price shown
Bulk price bulkPrice, bulkAmount, bulkPriceReference "Staffelpreis ab …" offer, badge in the cart

Announcing a price reduction is regulated (Preisangabenverordnung §11, based on the EU Omnibus directive). Whenever you show a reduction you must also state the lowest price the item had within the last 30 days before the reduction. The platform records this lowest price per item and the standard shop labels the struck price with "Kleinster Preis seit 30 Tagen" (lowest price of the last 30 days).

Price changes on positions already in the cart are a different topic: the standard shop shows a "Preissenkung!" or "Preiserhöhung" badge when a stored position's price differs from the current item price. You can implement the same by comparing the position price in the order with the current Item.price.

Checklist for the shop operator

These are not API calls, but a client implementer should know them, because an empty lastPrice is usually one of these:

Ideas