Umsatzsteuerkonten

Umsatzsteuerkonten kennzeichnen die steuerrechtliche Relevanz des Umsatzsteueranteils von Buchungen und enthalten die Kennzahlen für die Umsatzsteuervoranmeldung.

Mit der bookamat–API können Umsatzsteuerkonten abgefragt, aktiviert und deaktiviert (gelöscht) werden. Es sind also GET, POST und DELETE Requests möglich.

Liste der Umsatzsteuerkonten

Die Liste der aktivierten Umsatzsteuerkonten wird mit einem GET Request auf die Listen URL abgefragt. Hier werden nur aktivierte Umsatzsteuerkonten aufgelistet.

Bemerkung

Die erlaubten Steuersätze und Kennzahlen hängen vom Jahrespaket in der API-URL ab. Das Beispiel unten zeigt den Stand für 2026.

/preferences/purchasetaxaccounts/

Response

HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8

{
    "count": 14,
    "next": ".../api/v1/at/2026/preferences/purchasetaxaccounts/?page=2",
    "previous": null,
    "results": [
        {
            "id": 3475,
            "purchasetaxaccount": 210,  // ID des vordefinierten Umsatzsteuerkontos
            "name": "Umsatzsteuer Inland",
            "section": "Inland",
            "group": "1",
            "reverse_charge": false,
            "ic_report": false,
            "ic_delivery": false,
            "ic_service": false,
            "ioss_report": false,
            "eu_oss_report": false,
            "tax_values": ["20.00", "10.00", "13.00", "4.90"],
            "index_purchasetax": ["000", "022", "124", "029", "006"],
            "description": "Dieses Umsatzsteuerkonto verwendest du für Einnahmen ...",
            "active": true,
            "counter_booked_bookings": 10,
            "counter_open_bookings": 2,
            "counter_deleted_bookings": 3,
            "counter_bookingtemplates": 0
        },
        {
            "id": 3476,
            "purchasetaxaccount": 211,  // ID des vordefinierten Umsatzsteuerkontos
            "name": "Vorsteuer Inland",
            "section": "Inland",
            "group": "2",
            "reverse_charge": false,
            "ic_report": false,
            "ic_delivery": false,
            "ic_service": false,
            "ioss_report": false,
            "eu_oss_report": false,
            "tax_values": ["20.00", "10.00", "13.00", "4.90"],
            "index_purchasetax": ["060"],
            "description": "Dieses Umsatzsteuerkonto verwendest du für Ausgaben ...",
            "active": true,
            "counter_booked_bookings": 16,
            "counter_open_bookings": 15,
            "counter_deleted_bookings": 2,
            "counter_bookingtemplates": 12
        }
    ]
}

Felder

id:

Eindeutige Identifikationsnummer

Format
Ganzzahl
purchasetaxaccount:

ID des vordefinierten Umsatzsteuerkontos

Format
Ganzzahl
Siehe
Vordefinierte Umsatzsteuerkonten
name:

Bezeichnung

Format
String (max. 40 Zeichen)
section:

Bereich

Format
String
group:

Für Einnahmen oder Ausgaben verwendbar

Format
String (Auswahl)
Möglichkeiten
1 — Einnahme
2 — Ausgabe
reverse_charge:

Übergang der Steuerschuld

Format
Boolean
ic_report:

Zusammenfassende Meldung

Format
Boolean
ic_delivery:

Zusammenfassende Meldung (Lieferung)

Format
Boolean
ic_service:

Zusammenfassende Meldung (Leistung)

Format
Boolean
ioss_report:

IOSS

Format
Boolean
eu_oss_report:

EU-OSS

Format
Boolean
tax_values:

Erlaubte Umsatzsteuersätze

Format
Liste
Listenwerte
Umsatzsteuersätze als String
Anmerkung
Abhängig vom Jahrespaket (at/{year}/)
index_purchasetax:

Kennzahlen für die Umsatzsteuervoranmeldung

Format
Liste
Listenwerte
Kennzahlen als String
Anmerkung
Abhängig vom Jahrespaket
description:

Beschreibung

Format
Text
active:

Aktiv

Format
Boolean
Anmerkung
Wenn ein Umsatzsteuerkonto nicht aktiv ist wurde es von uns im Hintergrund deaktiviert, d.h. auf dieses Konto kann nicht mehr gebucht werden. Nicht aktive Konten sind eine absolute Ausnahme.
counter_booked_bookings:

Anzahl gebuchter Buchungen (Buchungszeilen)

Format
Ganzzahl
Anmerkung
Die Zahl bezieht sich auf Buchungszeilen (amounts).
counter_open_bookings:

Anzahl offener Buchungen (Buchungszeilen)

Format
Ganzzahl
Anmerkung
Die Zahl bezieht sich auf Buchungszeilen (amounts).
counter_deleted_bookings:

Anzahl gelöschter Buchungen (Buchungszeilen)

Format
Ganzzahl
Anmerkung
Die Zahl bezieht sich auf Buchungszeilen (amounts).
counter_bookingtemplates:

Anzahl Buchungsvorlagen (Buchungszeilen)

Format
Ganzzahl
Anmerkung
Die Zahl bezieht sich auf Buchungszeilen (amounts).

Filter

purchasetaxaccount:

ID des vordefinierten Umsatzsteuerkontos

Format
Ganzzahl
Beispiele
purchasetaxaccount=3475
group:

Für Einnahmen oder Ausgaben verwendbar

Format des Filters
1 — Einnahmen
2 — Ausgaben
Beispiele
group=1
reverse_charge:

Übergang der Steuerschuld

Format des Filters
true/false
Beispiele
reverse_charge=true
ic_report:

Zusammenfassende Meldung

Format des Filters
true/false
Beispiele
ic_report=true
ic_delivery:

Zusammenfassende Meldung (Lieferung)

Format des Filters
true/false
Beispiele
ic_delivery=true
ic_service:

Zusammenfassende Meldung (Leistung)

Format des Filters
true/false
Beispiele
ic_service=true
ioss_report:

IOSS

Format des Filters
true/false
Beispiele
ioss_report=true
eu_oss_report:

EU-OSS

Format des Filters
true/false
Beispiele
eu_oss_report=true
tax_values:

Erlaubte Umsatzsteuersätze

Beispiele
tax_values=9090
index_purchasetax:

Kennzahlen für die Umsatzsteuervoranmeldung

Beispiele
index_purchasetax=9090
active:

Aktiv

Format des Filters
true/false
Beispiele
active=true
has_bookings:

Buchungen vorhanden

Format
Boolean
Beispiele
has_bookings=true

Sortierung

ordering:

Sortierung

Möglichkeiten
id, name, section
Beispiele
ordering=id

Umsatzsteuerkonto Detail

Ein einzelnes aktiviertes Umsatzsteuerkonto wird mit einem GET Request auf die Detail URL abgefragt. Es sind dieselben Felder verfügbar wie bei der Listenansicht.

/preferences/purchasetaxaccounts/{id}/

Umsatzsteuerkonto hinzufügen

Ein neues (aktiviertes) Umsatzsteuerkonto wird mit einem POST Request auf die Detail URL hinzufgefügt. Derzeit kann nur ein Umsatzsteuerkonto aus der Liste der vordefinierten Umsatzsteuerkonten hinzugefügt werden — das passiert durch Übergabe der ID des vordefinierten Umsatzsteuerkontos. Aus einem vordefinierten Umsatzsteuerkonto wird also ein aktiviertes Umsatzsteuerkonto.

/preferences/purchasetaxaccounts/{id}/

Request Body

{
    "purchasetaxaccount": 212  // ID des vordefinierten Umsatzsteuerkontos
}

Response

HTTP/1.0 200 OK
Content-Type: application/json; charset=utf-8

{
    "id": 3477,
    "purchasetaxaccount": 212,  // ID des vordefinierten Umsatzsteuerkontos
    "name": "IG Erwerb von Leistungen",
    "section": "Innergemeinschaftliche Geschäfte",
    "group": "2",
    "reverse_charge": true,
    "ic_report": false,
    "ic_delivery": false,
    "ic_service": true,
    "ioss_report": false,
    "eu_oss_report": false,
    "tax_values": ["20.00", "10.00"],
    "index_purchasetax": ["057", "066"],
    "description": "Dieses Umsatzsteuerkonto verwendest du für ...",
    "active": true,
    "counter_booked_bookings": 0,
    "counter_open_bookings": 0,
    "counter_deleted_bookings": 0,
    "counter_bookingtemplates": 0
}

Felder

purchasetaxaccount *:

ID des vordefinierten Umsatzsteuerkontos

Format
Ganzzahl

Umsatzsteuerkonto löschen

Ein Umsatzsteuerkonto wird mit einem DELETE Request auf die Detail URL gelöscht.

Bemerkung

Es können nur Umsatzsteuerkonten gelöscht werden, denen keine Buchungen zugeordnet sind. Bei zugeordneten Buchungsvorlagen wird das Umsatzsteuerkonto aus der Vorlage gelöscht.

/preferences/purchasetaxaccounts/{id}/

Response

HTTP/1.0 204 NO CONTENT