Steuerkonten

Steuerkonten kennzeichnen die steuerrechtliche Relevanz von Buchungen bzw. Anlagen und enthalten die Kennzahlen für die Einkommensteuererklärung.

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

Liste der Steuerkonten

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

/preferences/costaccounts/

Response

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

{
    "count": 34,
    "next": ".../api/v1/at/2026/preferences/costaccounts/?page=2",
    "previous": null,
    "results": [
        {
            "id": 2361,
            "costaccount": 120,  // ID des vordefinierten Steuerkontos
            "name": "Einnahmen",
            "section": "Betriebseinnahmen",
            "group": "1",
            "inventory": false,
            "index_incometax": ["9040"],
            "deductibility_tax_percent": "100.00",
            "deductibility_amount_percent": "100.00",
            "description": "Alle Einnahmen im Inland ...",
            "active": true,
            "purchasetaxaccounts": [
                {
                    "id": 3475,
                    "name": "Umsatzsteuer Inland"
                },
                {
                    "id": 3476,
                    "name": "Umsatzsteuerfrei Inland (ohne Vorsteuerabzug)"
                },
                {
                    ...
                }
            ],
            "counter_booked_bookings": 10,
            "counter_open_bookings": 0,
            "counter_deleted_bookings": 0,
            "counter_bookingtemplates": 0
        },
        {
            "id": 2362,
            "costaccount": 121,  // ID des vordefinierten Steuerkontos
            "name": "Betriebliche Versicherungen",
            "section": "Versicherungen und Beiträge",
            "group": "2",
            "inventory": false,
            "index_incometax": ["9230"],
            "deductibility_tax_percent": null,
            "deductibility_amount_percent": null,
            "description": "Hier werden Aufwendungen für Güter- und Personen ...",
            "active": true,
            "purchasetaxaccounts": [
                {
                    "id": 3477,
                    "name": "Keine Vorsteuer"
                }
            ],
            "counter_booked_bookings": 2,
            "counter_open_bookings": 0,
            "counter_deleted_bookings": 0,
            "counter_bookingtemplates": 0
        }
    ]
}

Felder

id:

Eindeutige Identifikationsnummer

Format
Ganzzahl
costaccount:

ID des vordefinierten Steuerkontos

Format
Ganzzahl
Siehe
Vordefinierte Steuerkonten
name:

Bezeichnung des Steuerkontos

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
inventory:

Für Anlagen verwendbar

Format
Boolean
index_incometax:

Kennzahlen für die Einkommensteuererklärung

Format
Liste
Listenwerte
Kennzahlen als String
deductibility_tax_percent:

Betrieblicher Anteil der Umsatzsteuer in %

Format
Dezimalzahl
Anmerkung
Nur vorhanden, wenn kein anderer Wert zulässig ist.
deductibility_amount_percent:

Betrieblicher Anteil des Nettobetrags in %

Format
Dezimalzahl
Anmerkung
Nur vorhanden, wenn kein anderer Wert zulässig ist.
description:

Beschreibung

Format
Text
active:

Aktiv

Format
Boolean
Anmerkung
Wenn ein Steuerkonto 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.
purchasetaxaccounts:

Zugeordnete (aktivierte) Umsatzsteuerkonten

Format
Liste
Details
Siehe Felder der Liste purchasetaxaccounts
Anmerkung
Es werden nur aktivierte Umsatzsteuerkonten angegeben.
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).

Felder (purchasetaxaccounts)

Felder der Liste purchasetaxaccounts (Umsatzsteuerkonten).

id:

ID des Umsatzsteuerkontos

Format
Ganzzahl
Siehe
Umsatzsteuerkonten
name:

Bezeichnung

Format
String

Filter

costaccount:

ID des vordefinierten Steuerkontos

Format
Ganzzahl
Beispiele
costaccount=120
group:

Für Einnahmen oder Ausgaben verwendbar

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

Für Anlagen verwendbar

Format des Filters
true/false
Beispiele
inventory=true
index_incometax:

Kennzahlen für die Einkommensteuererklärung

Beispiele
index_incometax=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

Steuerkonto Detail

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

/preferences/costaccounts/{id}/

Steuerkonto hinzufügen

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

/preferences/costaccounts/{id}/

Request

{
    "costaccount": 122  // ID des vordefinierten Steuerkontos
}

Response

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

{
    "id": 2363,
    "costaccount": 122,  // ID des vordefinierten Steuerkontos
    "name": "Sonstige Einnahmen",
    "section": "Betriebseinnahmen",
    "group": "1",
    "inventory": false,
    "index_incometax": ["9090"],
    "deductibility_tax_percent": "100.00",
    "deductibility_amount_percent": "100.00",
    "description": "Sonstige Einnahmen, die nicht anderweitig zuordenbar sind ...",
    "active": true,
    "purchasetaxaccounts": [
        {
            "id": 3477,
            "name": "Keine Vorsteuer"
        }
    ],
    "counter_booked_bookings": 0,
    "counter_open_bookings": 0,
    "counter_deleted_bookings": 0,
    "counter_bookingtemplates": 0
}

Felder

costaccount *:

ID des vordefinierten Steuerkontos

Format
Ganzzahl

Steuerkonto löschen

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

Bemerkung

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

/preferences/costaccounts/{id}/

Response

HTTP/1.0 204 NO CONTENT