Commission

How an order becomes an amount on the partner account: when the calculation happens, what it calculates with, which rate wins and what undoes the entry again. This chapter describes the process in full.

The moment

The commission arises at the reconciliation, not at the purchase

When an order is placed only one thing happens: Shopware stores the partner code on the customer and on the order. The calculation comes later, at the reconciliation. That is the most important sentence in this chapter, because almost every everyday question traces back to it.

Live
As soon as a partner opens their account in the storefront, a reconciliation runs for them
Scheduled task
Runs hourly by default through the Shopware scheduled task
Console command
For operation through a cron job, with output that can be switched off
Switchable off
Each of the three routes separately, for instance to calculate only at night

Three conditions have to hold at once

If one of them does not, no entry arises. The order does not disappear, it waits: as soon as the condition is met, it is booked at the next reconciliation.

Minimum age
14 days out of the box. The higher, the more cancellations have passed beforehand
Order status
You choose in which status a reward happens. Not the payment or delivery status
Customer group
On request only selected groups count. Without a selection they all count

The basis of the calculation

Three commission types

The type determines what is calculated on. It applies per partner and can be switched for each of them individually.

Percentage
A percentage of the net goods value excluding shipping. 5 percent out of the box
Absolute per order
A fixed amount per order, independent of the goods value
Absolute per item
A fixed amount multiplied by the quantity of the line items
Foreign currency
Converted into your default currency

Six places a rate can hang

One rate for everything is rarely enough, because the margin is not the same everywhere. The four places on the range are released together by a single switch, which is off out of the box.

Partner
The base rate for this partner. Overwrites the shop-wide factory value
Follow-up order
A separate rate for every further order from a customer already referred
Customer
A rate for one particular referred customer. Individual per partner
Product
A rate on the single article. Applies to every partner equally
Category
A rate for a whole range. Applies to every partner equally
Dynamic product group
The group fills itself by your rules, and the rate follows

Priority: which rate wins

If several rates apply to an order, a single setting decides. It applies shop-wide and is the lever with which you choose between protecting the margin and keeping partners happy.

First match
The first matching rate in a fixed order wins. The most predictable
Highest rate
The partner always gets the best matching value
Lowest rate
Protects the margin, because the weakest matching value applies

Important with the add-on for levels: an individual rate on the customer, product, category or product group beats the level rate on every level. Whoever protects a product's margin with 2 percent at the same time raises the upper levels from 1 to 2 percent.

The brakes

What does not earn a commission

Three brakes are active out of the box, two you switch on as needed. A partner program is only as good as its brakes, because the plugin does not reclaim money already paid out.

Orders too young
Everything below the minimum age. Active out of the box with 14 days
Wrong order status
Only the status you choose is rewarded. Active out of the box
Poaching lock
A customer stays with their first partner. Active out of the box
Own orders
They count out of the box. A switch takes them out
Follow-up orders
They count out of the box. Switching them off turns the commission into a one-off bonus

Cancellation and correction

Only a complete cancellation is booked back by the plugin itself. Partial refunds and returns work differently in every shop and are therefore deliberately left out.

Trigger
The order status Cancelled, not the payment or delivery status
What happens
A negative entry for the amount of the commission, with your note
Money paid out
Is not reclaimed. The balance slips into the negative and settles itself
Everything else
A manual entry, positive as well as negative, with note and comment

Traceability

The calculation log

The basis of the calculation can be stored for every order. Without this log a question can only be answered by guessing, which is why it is switched on out of the box.

Where
On the order in the Commissions tab and through the context menu in the partner file
What it contains
The rate actually applied and the route to it
Check columns
Show per order with a tick or a cross whether age, group and status fit
Missing commission
The Commissions tab on the order names the reason in plain words

Everything on this page is generated straight from the plugin configuration. When a setting changes in the plugin, this page changes with it.

← Back to the manual

Common questions

When exactly does a commission arise?

At the reconciliation, not at the purchase. For that an order has to meet three conditions at once: it must have reached the minimum age, sit in the selected order status and belong to an admitted customer group. The reconciliation runs live when the partner account is opened, hourly as a scheduled task and on request through a console command.

Which commission types are there?

Three. A percentage calculates on the net goods value excluding shipping. Absolute per order grants a fixed amount per order regardless of the goods value. Absolute per item multiplies the amount by the quantity of the line items. Foreign currencies are converted into the default currency.

Where can a commission rate hang?

In six places: on the partner, on a separate rate for follow-up orders, on the individual customer, on the product, on a category and on a dynamic product group. The last four are released together by a single switch, which is off out of the box. Rates on the range apply to every partner equally; only the partner and customer rates are individual.

Which rate wins when several apply?

The Priority setting decides: the first match in a fixed order, the highest rate, or the lowest. Whoever wants to protect the margin takes the lowest; whoever does not want to upset partners takes the highest. The first match is the most predictable, because the order is fixed.

What does not earn a commission?

Orders below the minimum age, orders in the wrong order status, and orders from customer groups that are not admitted. In addition, the partner's own orders and follow-up orders from customers already referred can be excluded with a switch.

How do I find out why an order did not count?

Through the check columns in the partner file and the calculation log. The columns show per order with a tick or a cross whether age, customer group and order status fit. The log names the rate actually applied. The Commissions tab on the order names the reason when a commission is missing.

What happens with a cancellation?

When an order moves to the status Cancelled, the plugin automatically creates a negative entry that offsets the commission, with a note you word yourself. It is triggered by the order status, not by the payment or delivery status. Money already paid out is not reclaimed.

And with partial refunds or returns?

There the plugin deliberately books nothing on its own, because these processes work differently in every shop. You correct with a manual entry, which can be positive as well as negative, with a private note and a comment for the partner.

Does shipping count towards the commission?

No. The percentage rate calculates on the net goods value excluding shipping costs. With absolute rates shipping plays no part anyway.