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/2015/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
- costaccount
ID des vordefinierten Steuerkontos
- Format
- Siehe
- name
Bezeichnung des Steuerkontos
- Format
- String (max. 40 Zeichen)
- section
Bereich
- Format
- group
Für Einnahmen oder Ausgaben verwendbar
- Format
- Möglichkeiten
- 1 — Einnahme2 — Ausgabe
- inventory
Für Anlagen verwendbar
- Format
- index_incometax
Kennzahlen für die Einkommensteuererklärung
- Format
- Listenwerte
- Kennzahlen als String
- deductibility_tax_percent
Betrieblicher Anteil der Umsatzsteuer in %
- Format
- Anmerkung
- Nur vorhanden, wenn kein anderer Wert zulässig ist.
- deductibility_amount_percent
Betrieblicher Anteil des Nettobetrags in %
- Format
- Anmerkung
- Nur vorhanden, wenn kein anderer Wert zulässig ist.
- description
Beschreibung
- Format
- active
Aktiv
- Format
- 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
- Details
- Anmerkung
- Es werden nur aktivierte Umsatzsteuerkonten angegeben.
- counter_booked_bookings
Anzahl gebuchter Buchungen (Buchungszeilen)
- Format
- Anmerkung
- Die Zahl bezieht sich auf Buchungszeilen (amounts).
- counter_open_bookings
Anzahl offener Buchungen (Buchungszeilen)
- Format
- Anmerkung
- Die Zahl bezieht sich auf Buchungszeilen (amounts).
- counter_deleted_bookings
Anzahl gelöschter Buchungen (Buchungszeilen)
- Format
- Anmerkung
- Die Zahl bezieht sich auf Buchungszeilen (amounts).
- counter_bookingtemplates
Anzahl Buchungsvorlagen (Buchungszeilen)
- Format
- Anmerkung
- Die Zahl bezieht sich auf Buchungszeilen (amounts).
Felder (purchasetaxaccounts)¶
Felder der Liste purchasetaxaccounts (Umsatzsteuerkonten).
- id
ID des Umsatzsteuerkontos
- Format
- Siehe
- name
Bezeichnung
- Format
Filter¶
- costaccount
ID des vordefinierten Steuerkontos
- Format
- Ganzzahl
- Beispiele
- costaccount=120
- group
Für Einnahmen oder Ausgaben verwendbar
- Format des Filters
- 1 — Einnahmen2 — 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
}
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