Flow Builder and rules

The Bonus System ships its own building blocks for the Flow Builder and the rule builder. Use them to book points automatically and to use point balances as a condition anywhere in Shopware.

Flow Builder trigger “Bonus points changed”

Technical name: bonus_system.customer_points_changed

The trigger fires whenever a customer's point account changes — through an order, a manual credit, a flow action, expiring points or the Admin API. It provides customer and mail data, so it combines directly with the Send email action, for example for a “You collected new points” message.

The trigger also fires when the credit is 0 points.

Flow Builder action “Change points”

Technical name: action.change.bonus.points

The action writes an already activated credit to the customer's point account.

Field	Description
Points	Number of points. Negative values deduct points.
Reason	Booking text shown to the customer in the points account and in the admin module. Required.

Requirements:

The flow must start from a customer-aware trigger, for example Customer registered or Order payment status paid.
Both fields must be filled — without a reason or with 0 points the action does nothing.
The action is delayable and can be placed after the Shopware Delay action.

Typical use cases: welcome points after registration, points as compensation after a complaint, or a campaign credit for a customer group.

Rules for the rule builder

Under Settings → Rules three additional conditions are available:

Condition	Meaning
Customer has bonus points	Checks whether the logged-in customer has a point balance at all.
Customer Bonus Points	Compares the point balance with a value (equals, greater, lower …).
Amount of points redeemed in cart	Compares the points redeemed in the current cart with a value.

The conditions only match for logged-in customers. You can use them anywhere Shopware evaluates rules — shipping and payment availability, promotions, discounts — and additionally inside the Conditions of the Bonus System through the type Rule + All products or Rule + Products / Product groups.

Mail templates

During installation the plugin creates the template Bonus points expiration notification (type prems.bonus_system.points_expiration_notification_type). It is used when the automatic e-mail is enabled under Point expiration and can be edited under Settings → Email templates. The entity bonusPoints (the customer's point account) is available in the template.

Any other mail is built with the Flow Builder: trigger Bonus points changed plus the Send email action with your own template.