PHPackages                             actualizer/order-surcharges - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. actualizer/order-surcharges

ActiveShopware-platform-plugin[Utility & Helpers](/categories/utility)

actualizer/order-surcharges
===========================

Actualize: Order Surcharges - Adds surcharges like logistic fees and cash on delivery fees to the cart

1.2.2(1w ago)00MITPHPPHP >=8.3

Since May 11Pushed 1w ago1 watchersCompare

[ Source](https://github.com/actualizer/ActOrderSurcharges)[ Packagist](https://packagist.org/packages/actualizer/order-surcharges)[ RSS](/packages/actualizer-order-surcharges/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

ActOrderSurcharges - Shopware Plugin
====================================

[](#actordersurcharges---shopware-plugin)

A Shopware 6 plugin that automatically adds configurable surcharges to the shopping cart, including logistic fees and cash on delivery charges with dynamic payment method detection.

Features
--------

[](#features)

- Automatic logistic surcharge for all orders
- Cash on delivery (COD) fee based on payment method selection
- Dynamic surcharge calculation with proper tax handling
- Automatic cart cleanup when items are removed
- Payment method change detection and fee adjustment
- Configurable surcharge amounts through admin panel
- Multi-language support (German & English)
- Compatible with Shopware 6.6.10 - 6.7.x

Requirements
------------

[](#requirements)

- Shopware 6.6.10 or higher (up to 6.7.x)
- PHP 8.3 or higher

Installation
------------

[](#installation)

### Via Composer (recommended)

[](#via-composer-recommended)

```
composer require actualizer/order-surcharges
bin/console plugin:refresh
bin/console plugin:install --activate ActOrderSurcharges
bin/console cache:clear
```

### Manual

[](#manual)

1. Download or clone this plugin into your `custom/plugins/` directory
2. Install and activate the plugin via CLI: ```
    bin/console plugin:refresh
    bin/console plugin:install --activate ActOrderSurcharges
    bin/console cache:clear
    ```

Configuration
-------------

[](#configuration)

1. Go to Admin Panel → Settings → System → Plugins
2. Find "Actualize: Order Surcharges" and click on the three dots
3. Click "Config" to access plugin settings

### Configuration Options

[](#configuration-options)

#### Logistic Surcharge

[](#logistic-surcharge)

- **Active**: Enable/disable the logistic surcharge
- **Logistic Surcharge Amount**: Fixed amount added to all orders (default: 4.95 €)

#### Cash on Delivery Fee

[](#cash-on-delivery-fee)

- **Active**: Enable/disable COD fees
- **COD Fee Amount**: Fee amount for cash on delivery payments (default: 5.95 €)

#### Tax Settings

[](#tax-settings)

- **Default Tax Rate**: Tax rate used when no other rate can be determined (default: 19.0%)

How it works
------------

[](#how-it-works)

### Logistic Surcharge

[](#logistic-surcharge-1)

1. **Automatic Addition**: Added to cart when at least one regular product is present
2. **Cart Cleanup**: Automatically removed when cart becomes empty
3. **Tax Calculation**: Uses appropriate tax rate based on cart contents or configuration

### Cash on Delivery Fee

[](#cash-on-delivery-fee-1)

1. **Payment Detection**: Monitors payment method selection for COD variants
2. **Dynamic Addition**: Fee added when COD payment method is selected
3. **Automatic Removal**: Fee removed when different payment method is chosen
4. **Language Support**: Detects various COD payment method names (Nachnahme, Cash on Delivery, COD)

### Tax Handling

[](#tax-handling)

- Inherits tax rate from existing cart products
- Falls back to context tax rules
- Uses configured default tax rate as final fallback
- Proper tax calculation with Shopware's tax system

Technical Details
-----------------

[](#technical-details)

### Architecture

[](#architecture)

- Uses `CartProcessorInterface` for clean cart integration
- `SalesChannelContextSwitchEvent` for payment method change detection
- Line items with unique IDs (`logistic-surcharge`, `cod-fee`)
- Proper price definitions with tax calculations

### Payment Method Detection

[](#payment-method-detection)

Detects COD payments by checking payment method names for:

- `nachnahme` (German)
- `cash on delivery` (English)
- `cod` (abbreviation)

Development
-----------

[](#development)

### Building/Testing

[](#buildingtesting)

After making changes:

```
bin/console cache:clear
bin/console theme:compile
```

### Debugging

[](#debugging)

- Check cart contents in browser developer tools
- Monitor Shopware logs for surcharge-related events
- Test payment method changes in checkout process

Usage Examples
--------------

[](#usage-examples)

### Standard Shopping Cart

[](#standard-shopping-cart)

1. Customer adds products to cart
2. Logistic surcharge automatically added
3. Total price includes surcharge + tax

### Cash on Delivery Order

[](#cash-on-delivery-order)

1. Customer proceeds to checkout
2. Selects COD payment method
3. COD fee automatically added to cart
4. Changes to different payment → COD fee removed

### Empty Cart Handling

[](#empty-cart-handling)

1. Customer removes all products
2. All surcharges automatically removed
3. Clean cart state maintained

Compatibility
-------------

[](#compatibility)

- **Shopware Version**: 6.6.10 - 6.7.x
- **PHP Version**: 8.3+
- **Payment Methods**: Compatible with all standard Shopware payment providers
- **Tax Systems**: Works with all Shopware tax configurations

Support
-------

[](#support)

For issues and feature requests, please use the GitHub issue tracker.

License
-------

[](#license)

This plugin is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Credits
-------

[](#credits)

Developed by Actualize

---

Made with ❤️ for the Shopware Community

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance98

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~20 days

Total

2

Last Release

9d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c4299bac39069091458750da888ec6ed88b1898143fc8d95f468a05d19a6c57e?d=identicon)[actualizer](/maintainers/actualizer)

---

Top Contributors

[![actualizer](https://avatars.githubusercontent.com/u/17499933?v=4)](https://github.com/actualizer "actualizer (11 commits)")

---

Tags

shopware6shopware6-pluginshopware6-pluginssw6sw6-plugin

### Embed Badge

![Health badge](/badges/actualizer-order-surcharges/health.svg)

```
[![Health](https://phpackages.com/badges/actualizer-order-surcharges/health.svg)](https://phpackages.com/packages/actualizer-order-surcharges)
```

###  Alternatives

[frosh/tools

Provides some basic things for managing the Shopware Installation

83783.3k2](/packages/frosh-tools)[shopware/conflicts

Shopware 6 conflicting packages

149.1M8](/packages/shopware-conflicts)[swag/migration-assistant

Migration plugin for shopware/platform

2040.2k](/packages/swag-migration-assistant)[werkstattl/openblogware

OpenBlogware: A Blog Module for Shopware 6.

437.4k](/packages/werkstattl-openblogware)[heptacom/heptaconnect-bridge-shopware-platform

HEPTAconnect package to support a runtime in a shopware platform project

1025.0k3](/packages/heptacom-heptaconnect-bridge-shopware-platform)[tinect/matomo

Matomo plugin for shopware 6

1411.5k](/packages/tinect-matomo)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)