Konfiguration

Im Rahmen von bookamat gibt es Vordefinierte Steuerkonten und Vordefinierte Umsatzsteuerkonten die vom Benutzer aktiviert/deaktiviert werden können. Eigene Steuerkonten bzw. Umsatzsteuerkonten können nicht definiert werden.

Vordefinierte Steuerkonten

Alle vordefinierten Steuerkonten werden mit einem GET Request auf die Listen URL der Konfiguration abgefragt. Für ein einzelnes vordefiniertes Steuerkonto ist die Detail URL zu verwenden.

Bemerkung

Für Buchungen und Anlagen sind nur die aktivierten Steuerkonten relevant.

/configuration/costaccounts/, /configuration/costaccounts/{id}/

Response

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

{
    "count": 74,
    "next": ".../api/v1/at/2026/configuration/costaccounts/?page=2",
    "previous": null,
    "results": [
        {
            "id": 120,
            "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 ...",
            "purchasetaxaccounts": [
                {
                    "id": 211,  // ID des vordefinierten Umsatzsteuerkontos
                    "name": "Umsatzsteuer Inland",
                    "group": "Vorsteuerabzugsberechtigt"
                },
                {
                    "id": 212,  // ID des vordefinierten Umsatzsteuerkontos
                    "name": "Umsatzsteuerfrei Inland (ohne Vorsteuerabzug)",
                    "group": "Vorsteuerabzugsberechtigt"
                },
                {
                    ...
                }
            ]
        },
        {
            "id": 121,
            "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 ...",
            "purchasetaxaccounts": [
                {
                    "id": 213,  // ID des vordefinierten Umsatzsteuerkontos
                    "name": "Keine Vorsteuer",
                    "group": "Vorsteuerabzugsberechtigt"
                },
                {
                    ...
                }
            ]
        }
    ]
}

Felder

id:

Eindeutige Identifikationsnummer

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

Für Anlagegüter 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
purchasetaxaccounts:

Zugeordnete (vordefinierte) Umsatzsteuerkonten

Format
Liste
Details
Siehe Felder der Liste purchasetaxaccounts
Anmerkung
Es werden alle theoretisch möglichen Optionen angegeben.

Felder (purchasetaxaccounts)

Felder der Liste purchasetaxaccounts (Umsatzsteuerkonten).

id:

ID des vordefinierten Umsatzsteuerkontos

Format
Ganzzahl
Siehe
Vordefinierte Umsatzsteuerkonten
name:

Bezeichnung

Format
String
group:

Benutzergruppe

Format
String (Auswahl)
Möglichkeiten
Vorsteuerabzugsberechtigt
Nicht vorsteuerabzugsberechtigt (Kleinunternehmen, ärztliche und arztähnliche Berufe etc.)

Filter

group:

Für Einnahmen oder Ausgaben verwendbar

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

Für Anlagegüter verwendbar

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

Kennzahlen für die Einkommensteuererklärung

Beispiele
index_incometax=9090

Sortierung

ordering:

Sortierung

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

Vordefinierte Umsatzsteuerkonten

Alle vordefinierten Umsatzsteuerkonten werden mit einem GET Request auf die Listen URL der Konfiguration abgefragt. Für ein einzelnes vordefiniertes Umsatzsteuerkonto ist die Detail URL zu verwenden.

Bemerkung

Für Buchungen sind nur die aktivierten Umsatzsteuerkonten relevant.

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

/configuration/purchasetaxaccounts/, /configuration/purchasetaxaccounts/{id}/

Response

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

{
    "count": 14,
    "next": ".../api/v1/at/2026/configuration/purchasetaxaccounts/?page=2",
    "previous": null,
    "results": [
        {
            "id": 211,
            "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 ..."
        },
        {
            "id": 212,
            "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 ..."
        }
    ]
}

Felder

id:

Eindeutige Identifikationsnummer

Format
Ganzzahl
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
index_purchasetax:

Kennzahlen für die Umsatzsteuervoranmeldung

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

Beschreibung

Format
Text

Filter

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

Sortierung

ordering:

Sortierung

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