bmf-steuerrechner-api

Provides a javascript api to access the Lohn- und Einkommensteuerrechner by the Bundesministerium der Finanzen. Reference: https://www.bmf-steuerrechner.de/interface/einganginterface.xhtml

It exposes the endpoint:

1export async function bmf(
2  input: {
3    [ k: string ]: number
4  },
5  year: number,
6  month?: number
7): Promise<BMFResponse>

signature

takes input, year and month. For some years, the BMF has published more than one calculation period; otherwise month is optional. Months range is 1..12. input being a {} containing legal values for PAP input. e.g.:

• Lohnzahlungszeitraum (LZZ) = 1 (Jahr)
• Einkommen (RE4) = 2500000 (Cent)
• Steuerklasse (STKL) = 1

1const result = await bmf( { LZZ:1, STKL:1, RE4:2500000 }, 2016 );
2console.log( result );

yields

1{ jahr: '2016',
2  eingaben:
3   { LZZ: { value: '1', status: 'ok' },
4     STKL: { value: '1', status: 'ok' },
5     RE4: { value: '2500000', status: 'ok' } },
6  ausgaben:
7   { BK: { value: '0', type: 'STANDARD' },
8     BKS: { value: '0', type: 'STANDARD' },
9     BKV: { value: '0', type: 'STANDARD' },
10     LSTLZZ: { value: '267400', type: 'STANDARD' },
11     SOLZLZZ: { value: '14707', type: 'STANDARD' },
12     SOLZS: { value: '0', type: 'STANDARD' },
13     SOLZV: { value: '0', type: 'STANDARD' },
14     STS: { value: '0', type: 'STANDARD' },
15     STV: { value: '0', type: 'STANDARD' },
16     VKVLZZ: { value: '0', type: 'STANDARD' },
17     VKVSONST: { value: '0', type: 'STANDARD' },
18     VFRB: { value: '100000', type: 'DBA' },
19     VFRBS1: { value: '0', type: 'DBA' },
20     VFRBS2: { value: '0', type: 'DBA' },
21     WVFRB: { value: '1177200', type: 'DBA' },
22     WVFRBO: { value: '0', type: 'DBA' },
23     WVFRBM: { value: '0', type: 'DBA' } } }

License

This project is licensed under the terms of the MIT license.