Shipping calculator manual.

System requirements

Shopware 6.7, PHP 8.2 or newer. There are no migrations and no code running during installation - the table it needs is created when the module is first opened.

Installation

Upload the ZIP in the admin under Extensions, My Extensions, Upload extension, then install and activate it. SSH access is not required.

Opening the module

The module lives under Administration, Plugin Suite, Shipping calculator. There you see the overview of all rule sets you have created.

Creating a rule

"New rule" opens the dialog. In order:

• Give it a name and set the rule active
• Select the shipping method - the picker is searchable and shows whether the method is active and how many prices it currently holds
• Optionally choose a Shopware rule if the tiers should only apply to it
• Choose the currency
• Decide whether existing prices of the shipping method are removed beforehand

The calculation in detail

These values define how the tiers come about:

• Base price - the base amount always charged
• Surcharge type - a fixed amount per kilogram or a percentage added to the base price
• Price per kilogram or surcharge in percent - the size of the surcharge
• Included weight - up to this weight only the base price applies
• Start weight, tier size, maximum weight - define the steps
• Leave the last tier open - the top step then applies without an upper limit
• Calculation basis - lower bound, average or upper bound of each tier
• Minimum and maximum price - cap the result
• Rounding and rounding mode - to 0.05, 0.10, 0.50 or 1.00, up, down or commercially
• Price entry and tax rate - define whether the amounts entered are gross or net

The preview in the dialog shows the generated steps immediately with net and gross price. All steps are visible, not just the first few.

Which calculation basis makes sense

The calculation basis decides which weight within a tier is used. For a tier from 5 to 10 kilograms that gives three possible results.

The upper bound is the cautious choice: it covers even the heaviest parcel in the tier. The lower bound is the customer-friendly variant but can fall below your cost on heavy shipments. The average balances both across volume.

Writing the tiers

Writing happens through "Save and write" in the dialog or "Write to shipping method" in the overview.

If "Remove existing prices" is active, the existing prices of the shipping method for the selected rule are deleted first. Without that option they stay and the new ones are added.

Tax handling with mixed tax rates

The calculator writes a gross and a net amount per tier. Which tax rate the customer is actually charged is decided by the shipping method through its tax calculation setting:

• Automatic - the shipping tax is distributed across the tax rates in the cart, weighted by the net share of the line items
• Highest tax rate - shipping cost is taxed entirely at the highest rate found in the cart
• Fixed tax rate - the tax stored on the shipping method always applies

The module shows this setting directly in the shipping method picker. With a fixed rate the value is adopted into the tax rate field automatically and locked, so gross and net cannot drift apart.

Notes on handling

The plugin only changes the prices of the chosen shipping method, not the method itself. Delivery times, availability and rules stay untouched.

Rules can be duplicated to build variants quickly.

Prices already written stay in place when a rule set is deleted. Deleting a rule therefore removes nothing from the running shop.

Troubleshooting

Support

Questions and requests come straight to us - support is from the developer, not from a queue. You can also request a feature through the Plugin Suite in the admin.

Availability