Introduction

With the plugin MND Add Charge Manager you can define surcharges and link them to articles. Surcharges become distinct articles with ordernumbers in the Shopware basket and order which will be calculated accordingly.

Typical applications could be:

• Bottle deposit
• Bulky goods surcharge
• Handling fees

Four surcharge types

From Version 2.5 there are 4 surcharge types:

1. One surcharge per article quantity. I.e. article quantity 10 = 10x surcharge
2. One surcharge per article, regardless of quantity. I.e. article quantity 10 = 1x surcharge, 15 = 1x surcharge ...
3. One surcharge per basket. Surcharge will only be factored 1x per shopping cart. Regardless of number of articles and resp. quantity.
4. One optional surchage per basket. Surcharge 1x per shopping cart. User can deselect surcharge before checkout.
   

Special features of the plugins

• ERP compatibly: Surcharges are distinct articles in the shopware basket and order! Ordernumbers can be custom values.
• You can define VAT setting per surcharge article
• Name and description can be custom defined.
• You can define multiple surcharge articles and link them to as many articles as you like
  
• Multiple surcharges can be linked to one article
• Surcharges can be limited to one or more shipping-countries
• Surcharges can be limited to one or more Shopware dispatch types
  
• You can use surcharge information in the Shopware product feed
  
• You can set custom prices for customer groups
• Surcharge calculation can be disabled for selected customer groups
  

Surcharges are placed in the basket as shopware discount articles and factored with default shopware process.

Screenshots

Display on the article detail page:

Display in Article Listing:

Display in the basket of goods:

Installation

The installation is being done as usual about the Shopware Plugin Manager.

Further information about the installation process in Shopware:

Plugin-Installation: http://community.shopware.com/Lizenzierung-und-Installation-von-lizenzpflichtigen-Plugins_detail_1340.html
Plugin-Manager: http://community.shopware.com/Plugin-Manager-ab-Shopware-5_detail_1856.html)

Plugin-Configuration (Experts Settings)

Usage

Configuration in the backend

Select the submenu item "Additional Charges Manager" in the main menu:

Create/Edit Surcharges

Click "Add" to create a new surcharge or click on the pen icon in the grid to edit an existing one.

A deposit can be assigned to several articles and be limited to certain shipping countries.

NEW

Creating a Deposit

The following fields are relevant for the configuration of a deposit:

an ordernumber must be unique

Although technically possible, you should use for ordernumbers only sign A-Z, a-z, 0-9 and "-". 

I.e. no umlauts, special characters or blanks.

Short description of the surcharge. It is shown by the article in the shop below the surcharge price info.

Here you can set the input type for the price (incl. VAT.) / (excl. VAT.)

Price of surcharge (decimal separator is a dot)

Set which VAT configuration should be used

Add different prices for Customer Groups

In the configuration tab of the surcharge you can also set exceptions for different selected groups.

All Customer Groups are listed. You can edit a row via double clicking.

To activate a special configuration for a customer group you have to activate the field "Exception". If "Exception" is inactive, the default handling will be used.

Now you can set a different price or deactivate the surcharge calculation completely. When "disable surcharge" is active, no surcharge will be added for this customer group.

Example for a customer group exception

The Customer Group "Shopkunden" no surcharge will be calculated.

For "Händler" a surcharge of 0.2 incl. VAT will be used.

Assign to Articles

You can add a surcharge for an article via the name of the article or the ordernumber.

The surcharge was successfully linked to the article

Assigning two or more surcharges to an article

You can assign more than one surcharge to an article.
If you use more than one surcharge you might need to customize your shopware template to make room for all surcharge information.

Assign to Categories

You can assign a surcharge to all articles of a category via the tab "assign categories". The surcharge will then be assigned to all articles of all child categories.

Category has been successfully linked

Limit surcharges to shipping countries

A surcharge can be limited to (shipping) countries. The surcharge will then only be calculated when the country in the shipping address of the user corresponds to the selected countries.

For surcharges limited to countries we recommend using an according name or description for the surcharge. E.g. "handling fee for delivery to france".

The surcharge was limited for the supplier country, in this case "Switzerland".

Limit surcharges to dispatch types

Like limiting to shipping countries you can limit surcharges to configured dispatch-types of Shopware.

You should clear the Shopware cache (frontend and http-proxy) after changing surcharge configurations.

Template customization

Use in the shopware productfeeds

In the templates of the productfeeds, a new field is added to the variable $sArticle

$sArticle.mnd_addcharge

This variable contains a JSON object with surcharge information:

name of the surcharge for the customer

Reusable cans deposit

The description may contain newline characters. You should convert the value according to your target format. (e.g. CSV does not like line wraps)

reusable cans deposit is mandatory in Germany.

The gross price of the deposit in the currency opposed for the export

The tax rate of the deposit

Examples of integration in productfeed template 

Spend deposit information as text

First we add a column to the header template of the productfeed

[...]
Deposit{#S#}
[...]

[...]
{assign var=addChargeData value=$sArticle.mnd_addcharge|unescape:'html'|json_decode:1}
{assign var="output" value=null}
{foreach $addChargeData AS $data}{append 'output' "plus {$data.price|format:"number"} {$sCurrency.currency} {$data.display_name}"}{/foreach}
{", "|implode:$output}{#S#}
[...]

Result:

plus 0,25 EUR Test surcharge, plus 3,21 EUR Second Test Surcharge

Explanation:

the first three lines only prepare the output (they are not visible in the feed):

{assign var=addChargeData value=$sArticle.mnd_addcharge|unescape:'html'|json_decode:1}

Then we convert the JSON-String to an array. We use the array so we can use the values in a more civilized manner.

{assign var="output" value=null}

Then we create a variable which we assign values to. (still no output in the feed)

{foreach $addChargeData AS $data}{append 'output' "zzgl. {$data.price|format:"number"} {$sCurrency.currency} {$data.display_name}"}{/foreach}

Then we loop through all available surcharges and save the info to the "output" array.

{$data.price|format:"number"} 

this makes sure the prices are correctly formatted

{", "|implode:$output}

Finally, we output the surcharges separated by comma.

It is also possible to filter the result by using the surcharge type.

For this, you simply add an if-statment.

[...]
{assign var=addChargeData value=$sArticle.mnd_addcharge|unescape:'html'|json_decode:1}
{foreach $addChargeData AS $data}
{if $data.type == 'basket'}
	This article contains a surcharge per basket.
    {break}
{/if}
{/foreach}
[...]

Add price of surcharge to article price

[...]
Price incl Surcharge{#S#}
{/strip}{#L#}

[...]
{assign var=addChargeData value=$sArticle.mnd_addcharge|unescape:'html'|json_decode:1}
{assign var="priceIncl" value=$sArticle.price}
{foreach $addChargeData AS $data}{assign var="priceIncl" value=$priceIncl+$data.price}{/foreach}
{$priceIncl}

Result:

123.41

Then we convert the JSON-String to an array. We use the array so we can use the values in a more civilized manner.

{assign var="priceIncl" value=$sArticle.price}

We create a smarty variable and assign the price of the article to it

{foreach $addChargeData AS $data}{assign var="priceIncl" value=$priceIncl+$data.price}{/foreach}

Now we loop through every available surcharge and add the price to our variable

{$priceIncl}

Finally, we output the price as float value (without any formatting in this case).

Uninstall

The plugin is also uninstalled about the Plugin Manager.

When you uninstall the plugin, the surcharge configuration will not be removed. The configuration is saved in the following db tables: