Glossary

The words used in this manual and in the administration, each explained in one sentence.

Partner

An entity of its own in the shop, usually hanging on a customer account but possible without one. A partner has two switches: Activated decides whether they take part, Active decides whether new commissions arise.

Partner code

The identifier of a partner. It hangs on the partner link as a parameter, can optionally be typed into the cart by the customer, and is stored permanently on the customer when they log in, register or place a guest order. The code assigns, it does not discount.

Partner voucher

A real Shopware discount code belonging to a partner. It discounts for the customer and assigns the order at the same time, without a link too. Not to be confused with the commission the partner receives themselves.

Assignment

The connection between a customer and their partner. It runs through the standard Shopware fields on the customer and on the order; there is no tracking table of its own. Once set, it stands as long as poaching is not allowed.

Poaching lock

Active out of the box: a referred customer stays with the partner they first came through, even if they later find the shop through somebody else's link or code.

Reconciliation

The process that turns orders into commissions. It runs live when the partner account is opened, hourly as a scheduled task and on request through a console command. Each route can be switched off separately. The commission arises at the reconciliation, not at the purchase.

Commission

The amount credited to a partner for an order. Three types are possible: a percentage of the net goods value excluding shipping, absolute per order, or absolute per item.

Commission rate

The value used in the calculation. It can hang on the partner, the customer, the product, a category and a dynamic product group. If several apply, the configured priority decides.

Priority

The rule for which commission rate wins when several apply: the first match in a fixed order, the highest, or the lowest rate.

Follow-up order

Every further order from a customer already referred. It can be rewarded separately or excluded entirely, in which case only the first purchase counts.

Entry

A single record on the partner account, positive or negative. Entries arise automatically from orders and cancellations, or by hand through you, with a private note and a comment for the partner.

Balance

The sum of all entries less what the partner has already redeemed. Only the balance can be turned into a voucher or paid out.

Reward

The route by which the partner gets their money: as a voucher for your shop, or as a payout to their bank account. The kind applies shop-wide as a rule and can be switched per partner.

Bonus

A percentage uplift per partner that only increases the value of a voucher. The balance is charged the original amount, while the voucher is issued for the higher one.

Tiered amount

One of five fixed amounts a partner can redeem, out of the box 10, 25, 50, 100 and 250 euros. For payouts there are either tiers or the whole balance; for vouchers either tiers or a freely typed amount.

Receipt

The record of a payout, as a PDF with a consecutive number from a real number range. It lists the orders it contains with their partial amounts and shows no VAT, because it is not an invoice.

Calculation log

The stored basis of a commission calculation on the order. It shows which rate applied and why an order may not have counted.

Multi-level marketing

A separate add-on plugin with which the partner who recruited a partner earns as well, across up to five levels. An individual rate on the customer, product, category or product group beats the level rate on every level.