finanzamt
Version:
Get information about a German tax office (Finanzamt)
136 lines (71 loc) • 2.52 kB
Markdown
# finanzamt
> Get information about a German tax office (*Finanzamt*)
## Installation
```console
$ npm install finanzamt
```
## Usage
```js
const finanzamt = require('finanzamt');
finanzamt('1131');
// => { buFaNr: '1131', name: 'Prenzlauer Berg', … }
```
## API
### finanzamt(bundesfinanzamtsnummer)
### finanzamt(steuernummer)
Returns a [Finanzamt object](#finanzamt-1).
#### bundesfinanzamtsnummer
Type: `string`
German federal tax office number (*Bundesfinanzamtsnummer*).
#### steuernummer
Type: `string`
German tax number (*Steuernummer*) in the national format.
**Tip:** Use [normalize-steuernummer](https://github.com/kontist/normalize-steuernummer).
### Finanzamt
Type: `object`
The property names and descriptions are based on the [GemFA XSD](https://www.bzst.de/SharedDocs/Downloads/DE/GemFA/gemfa_xsd_beschreibungsdatei2.xsd?__blob=publicationFile&v=4) by the [Federal Central Tax Office](https://www.bzst.de/EN/Home/home_node.html).
#### buFaNr
Type: `string`
Die Bundesfinanzamtsnummer.
#### name
Type: `string`
Der Name der Finanzbehörde.
#### hausanschrift
Type: `object`
Die Hausanschrift der Finanzbehörde.
*Nicht alle Finanzbehörden geben diese Adresse an.*
##### strasse
Type: `string`
Die Strasse der Hausanschrift.
##### hausNr
Type: `string`
Die Hausnummer der Hausanschrift.
*Nicht alle Hausanschriften haben eine Hausnummer.*
##### hausNrZusatz
Type: `string`
Der Hausnummernzusatz der Hausanschrift.
*Nicht alle Hausanschriften haben einen Hausnummernzusatz.*
##### plz
Type: `string`
Die PLZ der Hausanschrift.
##### ort
Type: `string`
Der Ort der Hausanschrift.
#### tel
Type: `string`
Die Telefonnummer-Kontaktangabe der Finanzbehörde.
*Nicht alle Finanzbehörden geben diesen Kontakt an.*
#### fax
Type: `string`
Die Fax-Kontaktangabe der Finanzbehörde.
*Nicht alle Finanzbehörden geben diesen Kontakt an.*
#### mail
Type: `string`
Die Mail-Kontaktangabe der Finanzbehörde.
*Nicht alle Finanzbehörden geben diesen Kontakt an.*
#### url
Type: `string`
Die URL-Kontaktangabe der Finanzbehörde.
*Nicht alle Finanzbehörden geben diesen Kontakt an.*
## License
This project is licensed under the MIT License. The underlying [GemFA](https://www.bzst.de/DE/Service/Behoerdenwegweiser/Finanzamtsuche/finanzamtsuche_node.html) data by the [Federal Central Tax Office](https://www.bzst.de/EN/Home/home_node.html) is in the public domain in accordance with [§ 5 Abs. 1 UrhG](https://www.gesetze-im-internet.de/urhg/__5.html).