D3Public/TaxRatesAdjustment
Archivé
8
0
Bifurcation 0
Code Demandes d'ajout Publications Activité
Anpassung der Steuersätze (speziell für den 01.07.2020 + 01.01.2021)
Ce dépôt a été archivé le 2021-01-04. Vous pouvez voir ses fichiers ou le cloner, mais pas ouvrir de ticket ou de demandes d'ajout, ni soumettre de changements.
26 Révisions 5 Branches 7 Étiquettes 93 KiB
PHP 100%
f4d7c8ef5f
Aller au fichier
Daniel Seifert f4d7c8ef5f
add article price adjustment scripts 
# Conflicts:
#	composer.json
#	copy_this/_taxRates/Models/articlePricesAbstract.php
#	copy_this/_taxRates/Models/genericAbstract.php
#	copy_this/_taxRates/Models/raiseArticlePrices.php
#	copy_this/_taxRates/Models/raiseTrait.php
#	copy_this/_taxRates/Models/reduceArticlePrices.php
#	copy_this/_taxRates/Models/reduceTrait.php
#	copy_this/_taxRates/Models/taxRateAbstract.php
#	copy_this/_taxRates/bin/raiseArticlePrices
#	copy_this/_taxRates/bin/reduceArticlePrices
2020-06-25 11:41:21 +02:00
copy_this/_taxRates add article price adjustment scripts 2020-06-25 11:41:21 +02:00
LICENSE.md add missing license file 2020-06-08 15:21:57 +02:00
README.md add article price adjustment scripts 2020-06-25 11:41:21 +02:00

README.md

TaxRatesAdjustment / Anpassung der MwSt.-Sätze

Funktionsumfang

Was kann das Modul?

Dieses Modul stellt 2 Aufrufe bereit, die in Standardkonstellationen die MwSt.-Sätze anpasst, die in Deutschland zum 01.07.20 und zum 01.01.2021 geändert werden (Bestandteil des beschlossenen Corona-Konjunkturpaketes). Weiterhin können über 2 weitere Aufrufe die Artikelpreise passend reduziert bzw. erhöht werden.

Die Anpassung kann über entsprechende Cronjobs zeitgesteuert zum Stichtermin ausgeführt werden, ohne dass hierfür Ihre Anwesenheit erforderlich ist.

Die Steuerscripte ändern:

  • den im Shop eingestellten allgemeinen Steuersatz

  • an den Artikeln hinterlegte spezielle Steuersätze

  • von 19% zu 16% und

  • von 7% zu 5%

  • sowie später auch zurück

Die Steuerscripte ändern:

  • den Standardpreis der Artikel

  • den UVP-Preis der Artikel

  • den Varminpreis an Elternartikeln (der Variantenpreis selbst wird schon mit dem Standardpreis geändert)

  • den Varmaxpreis an Elternartikeln (der Variantenpreis selbst wird schon mit dem Standardpreis geändert)

  • von 19% zu 16% und

  • von 7% zu 5%

  • sowie später auch zurück

Berücksichtigt werden artikelabhängige Steuersätze sowie auch der generelle Steuersatz des Shops. Bei den Varianten-MinPreisen und Max-Preisen wird der Steuersatz des Elternartikels zugrunde gelegt. Weicht der Steuersatz der Varianten vom Elternartikel ab, muss dies manuell nachgearbeitet werden.

Bei Multishopinstallationen (Enterprise Edition) können die zu aktualisierenden Subshops definiert werden.

Die Scripte prüfen anhand der Systemzeit mit kleinen Toleranzen (+/-3 Tage um das jeweilige Umstellungsdatum), ob die Veränderung ausgeführt werden darf. Damit wird verhindert, dass ein versehentliches Auslösen zur falschen Shopkonfiguration führt.

Was kann das Modul nicht?

Sind im Shop noch an anderen Stellen Steuersätze hinterlegt, werden diese nicht angepasst. Weiterhin werden auch die absoluten Artikelpreise und Berechnungswege nicht angepasst.

  • Werden Artikelpreise brutto gepflegt und angezeigt, werden danach weiterhin die bisherigen Preise verwendet, jedoch mit geändertem Steuersatz.
  • Werden Artikelpreise netto gepflegt und brutto angezeigt, ändern sich die daraus errechneten Bruttopreise.

Für die Preisanpassungen stehen Ihnen die entsprechenden Scripte im Modul zur Verfügung.

Beachten Sie bei der Preisanpassung speziell die Artikel, die einer Preisbindung unterliegen.

Artikel, die von der Steuersenkung ausgenommen sind (z.B. Tabakwaren) können hierbei nicht berücksichtigt werden und erfordern eine manuelle Nachbearbeitung.

Die Preise werden immer auf dem im Shop vorliegenden Preis angewandt. Hierbei kann es durchaus zu Rundungsungenauigkeiten kommen.

Gibt es in Ihrem Shop reguläre Steuersätze mit 16% oder 5%, werden diese beim Zurücksetzen ebenfalls auf 19% bzw. 7% angehoben. Eine Unterscheidung, welcher Steuersatz vorab reduziert wurde, gibt es nicht. Diese Anpassung muss dann manuell durchgeführt werden.

Systemanforderung

  • installierter OXID eShop in Version 4.10 (CE, PE) oder 5.3 (EE) und dessen Anforderungen

Ein Einsatz in älteren Shopversionen ist vor dem Livebetrieb zwingend auf Verwendbarkeit zu testen.

Installation / Update

Kopieren Sie den Inhalt des copy_this-Ordners in Ihren Shopordner. Achten Sie darauf, auch die verborgene .htaccess mitzukopieren, dass die Scripte nicht über den Browser von außen erreichbar sind.

Vergeben Sie den beiden Scripten im Ordner _taxRates/bin Ausführungsrechte.

Ausführung

  • Bitte führen Sie die Umstellung rechtzeitig vorab in einer Testinstallation durch und prüfen Ihren Shop, um Fehler im Livebetrieb zu vermeiden. Zum Übergehen der Datumsprüfung können Sie den folgenden Befehlen einfach den Parameter -d anhängen: z.B. [ Shoppfad ]/_taxRates/bin/reduceTaxRate -d. Für den Livebetrieb soll der Parameter nicht verwendet werden.
  • Legen Sie sich unbedingt vor jeder Ausführung eine Datensicherung an. Die Software wird nach bestem Wissen erstellt. Durch die Vielzahl an möglichen Shopkonstellationen können wir jedoch keine Gewährleistung für die richtige Ausführung und eventuelle Folgen übernehmen.

Richten Sie einen ersten Cronjob ein, der idealerweise am 01.07.2020 um 00:00 folgendes Script startet, um die Steuersätze zu senken. Alternativ führen Sie dieses Script zum passenden Zeitpunkt manuell auf der Serverkonsole aus:

[ Shoppfad ]/_taxRates/bin/reduceTaxRate

Richten Sie einen zweiten Cronjob ein, der idealerweise am 01.01.2021 um 00:00 folgendes Script startet, um die Steuersätze zurückzusetzen. Alternativ führen Sie dieses Script zum passenden Zeitpunkt manuell auf der Serverkonsole aus:

[ Shoppfad ]/_taxRates/bin/raiseTaxRate

Nutzen Sie für die Preisanpassungen die folgenden Scripte als Cronjob zum passenden Moment:

um die Artikelpreise zu senken::

[ Shoppfad ]/vendor/bin/reduceArticlePrices

um die Artikelpreise zurückzusetzen:

[ Shoppfad ]/vendor/bin/raiseArtikelPrices

Führen Sie die Preisanpassungsscripte nur ein einziges Mal aus, da die Preise sonst mehrfach gesenkt / erhöht werden.

Bei Fragen zur Einrichtung der Cronjobs kontaktieren Sie bitte Ihren Hostingprovider.

Prüfen Sie nach Ausführung der Scripte Ihren Shop bitte zeitnah auf richtige Funktion.

Zur Definition, welche Subshops bearbeitet werden sollen, kann der Parameter -s 1,3,4 verwendet werden. Setzen Sie statt der 1,3,4 eine kommagetrennte Liste Ihrer gewünschten Shop-IDs ein. Ohne Angabe des Filters werden alle vorhandenen Subshops bearbeitet.

Sollen die Scripte über eine PHP-Version gestartet werden, die nicht als Standard am Server definiert ist, ändern Sie den Pfad zur passenden PHP-Version in den beiden bin-Scripten.

Deinstallation

Entfernen Sie die eingerichteten Cronjobs nach den beiden Ausführungszeitpunkten, um versehentliche spätere Auslösungen zu vermeiden.

Nach heutigem Stand werden die Scripte nach dem Zurücksetzen der Steuersätze nicht mehr benötigt. Dann kann der Ordner _taxRates wieder komplett aus der Installation entfernt werden.

Änderungshistorie

  • 1.0.0:
    • scriptgesteuertes Ändern der Steuersätze (generell und artikelspezifisch) reduzierend und erhöhend für jeden Subshop
    • per Argument übersteuerbare Ausführungsbeschränkung
    • Subshopfilter eingefügt
  • 1.0.1
    • falsche Konvertierung der ShopId entfernt
  • 1.0.2
    • PHP-Versionshinweis angepasst
  • unreleased
    • Preisanpassungsscripte eingefügt

Support