Skip to content

Get information about a German tax office (Finanzamt)

License

Notifications You must be signed in to change notification settings

kontist/finanzamt

Repository files navigation

finanzamt

Get information about a German tax office (Finanzamt)

Installation

$ npm install finanzamt

Usage

const finanzamt = require('finanzamt');

finanzamt('1131');
// => { buFaNr: '1131', name: 'Prenzlauer Berg', … }

API

finanzamt(bundesfinanzamtsnummer)

finanzamt(steuernummer)

Returns a Finanzamt object.

bundesfinanzamtsnummer

Type: string

German federal tax office number (Bundesfinanzamtsnummer).

steuernummer

Type: string

German tax number (Steuernummer) in the national format.

Tip: Use normalize-steuernummer.

Finanzamt

Type: object

The property names and descriptions are based on the GemFA XSD by the Federal Central Tax Office.

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 data by the Federal Central Tax Office is in the public domain in accordance with § 5 Abs. 1 UrhG.