Glossar

Die Begriffe stehen alphabetisch. Feldnamen und Werte sind so geschrieben, wie sie in der API vorkommen.

AutomatikkontoLink zu diesem Abschnitt kopieren

Ein Sachkonto, dem DATEV einen festen Steuerschlüssel zuordnet. Die Kontenbezeichnungen markieren solche Konten mit automatic: true und nennen in tax diesen Steuerschlüssel.

Ob DATEV die Umsatzsteuer oder Vorsteuer auf einem Automatikkonto selbst herausrechnet, hängt vom Steuerschlüssel der Buchung ab. Steht ein Automatikkonto in account oder accountContra, gilt beim DATEV-Export:

BelegLink zu diesem Abschnitt kopieren

Eine Rechnung oder ein anderer Nachweis, der in bimetrics hochgeladen, per E-Mail eingegangen, in bimetrics erstellt oder aus einem Vertrag oder einer Serie erzeugt wurde. Das Feld kind unterscheidet zwei Arten:

Beim Upload bestimmt das Formularfeld die Art: invoice[] oder receipt[]. Mit auto[] erkennt bimetrics die Art selbst. Der Beleg startet dann als receipt, und kind kann sich mit der Erkennung ändern.

BuchungLink zu diesem Abschnitt kopieren

Ein Eintrag im Kontenrahmen der Firma, den bimetrics aus Belegen, Umsätzen und Zuordnungen ableitet. Eine Buchung bewegt einen Betrag zwischen dem Konto account und dem Gegenkonto accountContra.

• amount ist der Betrag in Euro, bei Buchungen mit einem Steuersatz in bookingFlags brutto. Das Vorzeichen bezieht sich auf account: größer als 0 ist Soll, kleiner als 0 ist Haben (siehe Datentypen).
• refDocumentId, refBankTransactionId und refMatch verweisen auf den Beleg, den Umsatz und die Zuordnung, aus denen die Buchung entstand.
• bookingFlags enthält den Steuerschlüssel der Buchung.
• Solange eine Buchung nicht festgeschrieben ist, berechnet bimetrics sie bei jeder Änderung an Beleg, Umsatz oder Zuordnung neu. Die neuen Buchungen bekommen dabei neue IDs, die bisherigen erscheinen nicht mehr in den Treffern.

Buchungen liest du mit POST /api/accounting/booking/filter und GET /api/accounting/booking/{id}. Belege und Umsätze enthalten ihre Buchungen außerdem im Feld bookings.

Debitor und KreditorLink zu diesem Abschnitt kopieren

Personenkonten eines Kontakts: Das Debitorenkonto nimmt Forderungen an einen Kunden auf, das Kreditorenkonto Verbindlichkeiten gegenüber einem Lieferanten. bimetrics bildet beide Kontonummern aus der Kunden- bzw. Lieferantennummer customerNumber des Kontakts. Die Kontenbezeichnungen nennen sie mit dem Namen des Kontakts.

ErkennungLink zu diesem Abschnitt kopieren

Nach dem Upload liest bimetrics die Belegdaten im Hintergrund aus, etwa Rechnungsnummer, Datum, Aussteller und Positionen. Den Stand zeigt uploadDocument.ocrStatus. Die Werte und ihre Bedeutung stehen unter Beleg-Upload.

FestschreibungLink zu diesem Abschnitt kopieren

Beim DATEV-Export schreibt bimetrics die exportierten Buchungen fest. Das Feld finalized enthält dann den Zeitpunkt, sonst ist es null.

• Festgeschriebene Buchungen ändern sich nicht mehr.
• Ändert sich danach der Beleg, der Umsatz oder die Zuordnung, korrigiert bimetrics per Storno und legt die neuen Buchungen zusätzlich an.
• Einen Beleg mit festgeschriebenen Buchungen entfernt bimetrics beim Löschen nicht. Er bleibt in den Treffern und ist weiter abrufbar, seine invoicePositions sind danach null, und seine festgeschriebenen Buchungen hebt bimetrics per Storno auf. Über die dokumentierten Felder kannst du einen solchen Beleg derzeit nicht sicher von anderen unterscheiden.
• Mit dem Filterattribut finalized findest du festgeschriebene Buchungen (range mit einer Untergrenze lower) oder nicht festgeschriebene (eq mit dem Wert null).

GegenkontoLink zu diesem Abschnitt kopieren

Das zweite Konto einer Buchung, im Feld accountContra. Es hat die umgekehrte Seite von account. Bei einem Eingangsbeleg ist es in der Regel das Kreditorenkonto des Lieferanten, bei einer Ausgangsrechnung das Debitorenkonto des Kunden (siehe Debitor und Kreditor).

KontenrahmenLink zu diesem Abschnitt kopieren

Die Nummerierung der Sachkonten nach DATEV. bimetrics unterstützt die Standardkontenrahmen SKR03 und SKR04. Welchen eine Firma nutzt, legt sie in der App fest.

Das Feld accountingModel einer Buchung nennt den Kontenrahmen und die steuerlichen Einstellungen, mit denen die Buchung entstand:

Ändert eine Firma diese Einstellungen, tragen neue Buchungen den neuen Wert, bestehende behalten ihren. Die Buchungssuche liefert beide. Werte Buchungen für ein Reporting deshalb getrennt nach accountingModel aus.

KontingentLink zu diesem Abschnitt kopieren

Die Zahl der Belege, die der Tarif im Abrechnungszeitraum enthält. Tarif und Kontingent lesen liefert die Grenze in limits.documents und die Nutzung in usage.documentsPeriod. Ist das Kontingent ausgeschöpft, speichert bimetrics neue Belege trotzdem und pausiert ihre Erkennung (quota_paused). Sobald wieder Kontingent frei ist, etwa im nächsten Zeitraum oder nach einem Tarifwechsel, setzt bimetrics die Erkennung von selbst fort.

SachkontoLink zu diesem Abschnitt kopieren

Ein Konto im Kontenrahmen der Firma, etwa für Erlöse, Aufwendungen oder Bankkonten. Die Nummern aller bebuchten Konten liefert GET /api/accounting/accounts/, ihre Bezeichnungen GET /api/accounting/accounts/labels/.

SteuerschlüsselLink zu diesem Abschnitt kopieren

Das steuerliche Kennzeichen einer Buchung, im Feld bookingFlags. bimetrics schreibt es in eigener Form, nicht als DATEV-BU-Schlüssel. Den BU-Schlüssel bildet bimetrics erst beim DATEV-Export daraus.

Werte mit none, reverse-charge oder omit sowie ein leerer Wert haben keinen eigenen Steuersatz. Die Liste ist nicht abschließend. Automatikkonten nennen ihren Steuerschlüssel in derselben Form im Feld tax der Kontenbezeichnungen.

StornoLink zu diesem Abschnitt kopieren

bimetrics kennt zwei Arten:

• Stornobuchung: Eine festgeschriebene Buchung wird nicht geändert, sondern durch eine Gegenbuchung aufgehoben. Die Stornobuchung hat dieselben Konten, dasselbe Datum und das umgekehrte Vorzeichen in amount und verweist in revertsAccountBookingId auf die aufgehobene Buchung. Summierst du Buchungen, zählst du Stornobuchungen einfach mit: Beide heben sich auf.
• Storno-Zuordnung: Eine Zuordnung der Art invoice_cancellation verbindet Belege, die sich gegenseitig aufheben, etwa eine Rechnung und ihre Stornorechnung. Sie ist keine Zahlung.

UmsatzLink zu diesem Abschnitt kopieren

Eine Bewegung auf einem mit bimetrics verbundenen Bankkonto, wie die Bank sie liefert. status ist booked für gebuchte und pending für vorgemerkte Umsätze. Der Betrag transactionAmount ist in Cent, negativ bei Ausgängen.

ZuordnungLink zu diesem Abschnitt kopieren

Die Verbindung von Belegen und Umsätzen, in der API das Objekt match an Belegen und Umsätzen. Eine Zuordnung kann mehrere Belege und mehrere Umsätze umfassen. Ohne Zuordnung ist match gleich null.

amountOpen ist der offene Betrag der Zuordnung in Cent, 0, wenn Belege und Umsätze aufgehen. autoMatch zeigt, dass bimetrics die Zuordnung selbst angelegt hat.