/einkommensteuerApi

API für Berechnung der Jahreseinkommensteuer und des Solidaritätszuschlags

Primary LanguagePHPMIT LicenseMIT

Einkommensteuer API

API für Berechnung der Jahreseinkommensteuer und des Solidaritätszuschlags

Hinweis/Disclaimer

Die externe Programmierschnittstelle wird ausschließlich für die Nutzung zu Programmtests bereitgestellt. Die Nutzung zur Abwicklung von Berechnungen direkt über diese Schnittstelle sowie die gewerbliche Nutzung der Schnittstelle ausdrücklich untersagt.

Weder die Entwickler, noch der Betreiber übernimmt Dritten gegenüber Gewähr für Richtigkeit, Aktualität, Vollständigkeit und Verfügbarkeit der ausgeführten Programme.

Diese Software ist ein rein privates Projekt von Kai Michael Poppe auf Basis der Vorarbeit von Michael Keutel und soll für andere interessiere Zahlennerds die Möglichkeit bieten, eigene Berechnungen anzustellen.

API-Dokumentation

Die hier als Source Code zur Verfügung gestellten Funktionen sind über https://einkommensteuerapi.de zugreifbar, die Swagger-Dokumentation findet sich unter https://einkommensteuerapi.de/doc/

Warum das Alles?

Als Entwickler möchte man möglichst viel programmgestützt tun. Dazu gehört wohl auch, für das Ende des Steuerjahres eine Schätzung zu haben, wie hoch denn die Steuerlast ist, so lange das Finanzamt diese Information noch nicht offiziell verkündet hat.

Hier kommt der Steuerrechner des Bundesministeriums für Finanzen ins Spiel. Leider bietet der "Service für Entwickler" dort nur die Möglichkeit, die Lohnsteuer für die laufenden Gehaltszahlungen zu berechnen, nicht aber die tarifliche Jahres-Einkommensteuer. Warum dies so ist wird wohl ein Rätsel bleiben ;-)

Die Anfänge

Michael Keutel erstellte im Juli 2014 eine Google WebApp auf Basis von PHP zur Berechnung der Einkommensteuer. Der Blog Beitrag hierzu ist weiterhin zu finden, auch wenn die WebApp nicht mehr funktionsfähig ist.

8 Jahre später fand Kai das Projekt, nahm Kontakt auf, und führte die Entwicklung weiter zu dem Projekt das heute hier liegt.

Quellen

Grundlage der Berechnungen sind die Programmablaufpläne, die vom Bundesministerium für Finanzen regelmäßig an die Gesetzeslage angepasst und veröffentlicht werden. Der Großteil der Pläne ist im Datenportal des BMF zu finden, oder auch in der Themensuche des BMF - dort zurück bis 2005.

Auch wenn es derzeit noch keine Anwendung fand, gibt es ein gut gepflegtes Archiv von Dr. Martin Hentrich mit Programmablaufplänen bis 1998.

Warum nur Berechnungen ab 2007?

Abgesehen von der Änderung des Eingangssteuersatzes von 15% auf 14% zum Jahr 2009 sind die Grundlagen der UPTABxx-Formel in den Programmablaufplänen identisch, hierbei vor allem der statische Wert 2397 in der Oberen Progressionszone sowie die Verwendung der Grenzwerte der vorherigen Stufe als Abzugsbeträge zu Beginn der Berechnung. Vor 2007 fehlte die 2. Progressionszone und die Abzugsbeträge wichen von den Zonen-Grenzwerten ab.

In einer späteren Ausbaustufe des Projektes sollen Berechnungen für frühere Jahre, zu denen noch Programmablaufpläne zu finden sind mit weiteren Formeln genutzt werden können.

Mitarbeit

Jeder kann und darf sich Anpassungen im Code über Issues wünschen oder über Pull Requests vorschlagen, das ist das Wesen von Open Source Entwicklung. Da es sich hierbei nur um ein mathematisch komplexes aber Quelltext-seitig recht einfaches Projekt handelt, sind keine besonderen Vorgaben für Beiträge zu machen, Kai nimmt sich aber die Freiheit, diese redaktionell an den Stil der Entwicklung anzupassen.

Vielen Dank für die Unterstützung an