Small Business: Installation

Small Business §19 UStG for Shopware 6.7 - requirements, installation via Store, Composer or ZIP, what activation changes in the shop, deactivation and uninstall, and the plugin line for Shopware 6.6.

Deutsche Version

Back to overview

Small Business: Installation

Requirements

Requirement	Value
Shopware	`~6.7.0` (package `shopware/core`)
PHP	`>=8.2`
Composer package	`mmd/sw67-kleinunternehmer`
Plugin class / technical name	`MmdKleinunternehmer`

Shopware 6.6 has its own plugin line with a different package name, see the section "Shopware 6.6" below.

Installation

Via Shopware Store (recommended)

Purchase the plugin in the Shopware Store.
In the Shopware Admin, install and activate the plugin under Extensions > My Extensions.
Clear the cache.

Via Composer

Add the private Composer repository. You receive the credentials after purchase.

{"repositories": [{"type": "composer", "url": "https://packeton.markus-michalski.net"}]}

Install the plugin:

composer require mmd/sw67-kleinunternehmer

Install and activate the plugin:

bin/console plugin:refresh
bin/console plugin:install --activate MmdKleinunternehmer
bin/console cache:clear

Via ZIP upload

Upload the ZIP file under Extensions > My Extensions.
Install and activate the plugin.
Clear the cache.

After installation

Open the plugin configuration: Extensions > My Extensions > Small Business §19 UStG.
Switch on Small business regulation active, see Configuration.
Migrate existing products, see Product migration.

Activating the plugin does not switch the display on. After installation the setting Small business regulation active is "Off".

What activation, deactivation and uninstall change in the shop

Action	Effect
Activate plugin	Remembers the shop's current default tax rate. Creates the tax rate Kleinunternehmer §19 UStG (0%) at 0 % if it does not exist yet (an existing tax rate with that name is reused). Sets it as the shop's default tax rate.
Deactivate plugin	Restores the remembered default tax rate. Products that were already migrated to the 0% tax rate stay as they are.
Uninstall plugin (without "keep user data")	Deletes the tax rate if the plugin created it itself and removes the remembered configuration values. With "keep user data" none of this happens.

Activation does not change existing products or orders. Products only move to the new tax rate through the product migration.

Before uninstalling, set products back to a regular tax rate with --restore, because the 0% tax rate is deleted on uninstall. See Product migration.

Shopware 6.6

Shopware 6.6 has a separate plugin line. Both lines share the technical name MmdKleinunternehmer and the same plugin class, so they must not be installed at the same time.

	Shopware 6.7 (this documentation)	Shopware 6.6
Composer package	`mmd/sw67-kleinunternehmer`	`mmd/sw66-kleinunternehmer`
Shopware requirement	`shopware/core ~6.7.0`	`shopware/core ~6.6.0`
PHP	`>=8.2`	`>=8.2`

Installation and activation work the same for both lines (Store, Composer or ZIP). The differences in functionality are listed in the section "Differences in the Shopware 6.6 line" on the Technical details page.