Surcharges & discounts
Deutsch Demo shop Store

Five steps to your first automatic item

You need a rule from the Rule Builder and an item in the plugin. You set up both in the administration, without writing a line of code. This page shows which fields are required and what is preset.

Before you start.

After installing from the Shopware Store, the administration shows the new menu item Pseudo products under Catalogues. All items live there, each with its own rule.

The plugin configuration has a single switch: Activate plugin. It is on by default and can be switched off per sales channel. If it is off, the plugin adds nothing to the cart in that channel.

To try it without installing: Four items are set up in the demo shop. Put a product into the cart there and you will see the result of this guide. Open the demo shop

Step 1: the rule.

A rule consists of conditions joined by And or Or. It applies to the customer and their cart as they are at that moment.

RuleRule Builder

  • Shipping address: CountryIs one of Austria Switzerland
  • and
  • Customer groupIs one of Retailer

Transport insurance +10%

You will find the Rule Builder under Settings › Automation › Rule builder. For items in the cart, these conditions are especially useful:

  • Items in cart, Item in dynamic product group, Item with tag
  • Customer group, Commercial customer, Customer logged in
  • Shipping address: Country, Applied shipping method, Applied payment method
  • Date range, Day of the week, Sales Channel

If an item should be in every cart, the rule "Always valid (Default)", which Shopware creates on installation, is enough. The demo shop uses it.

For value thresholds: Use "Subtotal of goods (excl. discounts/fees)". The "Cart total (incl. shipping)" also counts shipping and the plugin's items, so a surcharge can switch its own rule off again.

Steps 2 and 3: the item.

Under Catalogues › Pseudo products › Add pseudo product. The internal name is required, plus either the title and number or the product, depending on the type.

General

Activeon

Internal nameTransport insurance AT/CH

Position1

Product typePseudo product

Removableoff

Maximum purchase per customeroff

Surcharge/discount

Type of surcharge/discountPercental

Surcharge/discount10%

  • Basic Data

    Active is preset, Position is 1, Product type is Pseudo product. The internal name is required but only visible to you.

  • Pseudo product

    Title and number are required. The type of surcharge/discount is set to Percental. If you switch to Absolute, you enter gross or net and choose a tax rate, which is then required.

  • Shopware product

    If you set the type to Shopware product, the Shopware Product tab is active. On this tab only the product is required. Product free of charge is off; the name in the checkout comes from the product.

Step 4: rule and sales channels.

The Basic Data tab has the Rules card. There you choose the rule from step 1 and the sales channels the item applies to. Both are required; without a rule you cannot save.

Step 5: what else is possible.

Everything else is optional and off when you create the item:

  • Removable, so the customer can remove the item
  • Maximum purchase per customer, with a quantity from 1
  • Link quantity to products, per piece or per position
  • Cart note and product note
  • Delivery time, icon or image for the line

  1. Create a rule

    Under Settings › Automation › Rule builder you create a rule or use an existing one. It describes when the item should be added.

  2. Create the item

    Under Catalogues › Pseudo products you click Add pseudo product and enter an internal name on the Basic Data tab.

  3. Choose type and price

    Pseudo product with title, number and surcharge/discount, or Shopware product from the catalogue, free of charge if you like.

  4. Assign rule and sales channels

    On the Basic Data tab, in the Rules card, you pick the rule and at least one sales channel.

  5. Save and check

    After saving, go to the shop and put a product that matches the rule into the cart. The item is there right away.

If nothing appears in the cart.

The plugin checks the first seven points before it adds an item to the cart. The eighth is a trap with value thresholds.

Is the plugin active in the sales channel?

The Activate plugin switch in the plugin configuration applies per sales channel.

Is there a product in the cart?

An empty cart gets no item, even if the rule would apply.

Is the item active and assigned to the channel?

Active must be on, and the sales channel must be selected on the Rules card.

Does the rule apply right now?

Every condition counts; with And, all of them must be met at once. Check them for exactly this customer and this cart.

Has the customer removed the item?

A removed item stays away for the running session. In a new session it comes back.

Has the maximum purchase been reached?

With Maximum purchase per customer the plugin counts previous orders. If nothing is left, the item is not added.

Is an order being created in the admin?

When orders are created or edited in the administration, no new items are added. Existing ones stay.

Does the rule depend on the cart total?

The cart total counts the item itself. A surcharge can switch its rule off that way; use the subtotal of goods instead.

Cart processing All settings Examples

Ready to let your cart do the maths?

Put a product into the cart in the demo shop and watch four items appear. Or try it free for 30 days in your own shop.

Open the demo shop View in the store