taxapi

- Version 2018 has been changed to Java 8.

Generated API classes for direct server communication with https://www.bmf-steuerrechner.de/. Please respect the terms of use of this website (for tests only).

This artifact contains a XSD and the generated JAXB classes for the service answer.

Project: https://taxcalcs.github.io/taxapi/

Javadoc: https://taxcalcs.github.io/taxapi/apidocs/

JDK 9 module name: info.kuechler.bmf.taxapi

For tax calculation in your project see project taxcalculator.

Usage

Use the maven dependency:

<dependency>
	<groupId>info.kuechler.bmf.taxapi</groupId>
	<artifactId>taxapi</artifactId>
	<version>2023.1.0</version>
</dependency>

or other build tools

Example to unmarschall:

InputStream in = ...; // TODO
JAXBContext context = JAXBContext.newInstance(Lohnsteuer.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
Lohnsteuer result = (Lohnsteuer) unmarshaller.unmarshal(inputStream);

Generated Classes

You can use this classes to marshal the result.

info.kuechler.bmf.taxapi.Lohnsteuer
info.kuechler.bmf.taxapi.Eingabe
info.kuechler.bmf.taxapi.Ausgabe
info.kuechler.bmf.taxapi.Type

URLs

TaxApiFactory is a class to provide the test URLs which returns the XML.

// returns "http://www.bmf-steuerrechner.de/interface/2018Version1.xhtml?code=Lohn2018"
TaxApiFactory.getUrl(0, 2018);

Example Answer

From: https://www.bmf-steuerrechner.de/

<?xml version="1.0" encoding="UTF-8"?>
<lohnsteuer jahr="2018">
  <information>
Die Berechnung ist nach den PAP 2018 erfolgt. Die Berechnung dient lediglich der Qualitätssicherung. Die Externe Schnittstelle des Lohn- und Einkommensteuerrechner ist also nur für die Überprüfung ihrer Rechnung bestimmt und nicht dazu bestimmt, die Berechnung über ihn abzuwickeln.
  </information>
  <eingaben>
    <eingabe name="STKL" value="1" status="ok" />
    <eingabe name="LZZ" value="1" status="ok" />
    <eingabe name="RE4" value="2500000" status="ok" />
  </eingaben>
  <ausgaben>
    <ausgabe name="BK" value="0" type="STANDARD" />
    <ausgabe name="BKS" value="0" type="STANDARD" />
    <ausgabe name="BKV" value="0" type="STANDARD" />
    <ausgabe name="LSTLZZ" value="252500" type="STANDARD" />
    <ausgabe name="SOLZLZZ" value="13887" type="STANDARD" />
    <ausgabe name="SOLZS" value="0" type="STANDARD" />
    <ausgabe name="SOLZV" value="0" type="STANDARD" />
    <ausgabe name="STS" value="0" type="STANDARD" />
    <ausgabe name="STV" value="0" type="STANDARD" />
    <ausgabe name="VKVLZZ" value="0" type="STANDARD" />
    <ausgabe name="VKVSONST" value="0" type="STANDARD" />
    <ausgabe name="VFRB" value="100000" type="DBA" />
    <ausgabe name="VFRBS1" value="0" type="DBA" />
    <ausgabe name="VFRBS2" value="0" type="DBA" />
    <ausgabe name="WVFRB" value="1122100" type="DBA" />
    <ausgabe name="WVFRBO" value="0" type="DBA" />
    <ausgabe name="WVFRBM" value="0" type="DBA" />
  </ausgaben>
</lohnsteuer>

Changelog

• 2023.1.0 March 18th, 2023: update to 2023.1 (new XML January 2023)
• 2023.0.0 December 12th, 2022: update to 2023
• 2022.2.0 December 12th, 2022: update to 2022.2 (new XML for 2022)
• 2022.0.0 December 2nd, 2021: update to 2022
• 2021.0.0 December 2nd, 2020: update to 2021
• 2020.0.0 December 16th, 2019: #11 update to 2020
• 2019.0.0 December 11th, 2018: #6 update to 2019
• 2018.1.0 May 2nd, 2018: API change #5
• 2018.0.0 December 1st, 2017: update to 2018
• 2017.0.0 November 30th, 2016: update to 2017
• 2016.0.1 October 4th, 2016: Make objects serializable
• 2016.0.0 September 18th, 2016: Initial Version