# Glossar (https://developer.bimetrics.de/glossary) Fachbegriffe der bimetrics API von Automatikkonto bis Zuordnung, mit den zugehörigen Feldern. Die Begriffe stehen alphabetisch. Feldnamen und Werte sind so geschrieben, wie sie in der API vorkommen. ## Automatikkonto Ein Sachkonto, dem DATEV einen festen [Steuerschlüssel](#steuerschlüssel) zuordnet. Die [Kontenbezeichnungen](https://developer.bimetrics.de/reference/accounting/list-account-labels.md) 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: | `bookingFlags` der Buchung | DATEV-Export | | ------------------------------------------------------------------- | ------------------------------------------------------------- | | gleich `tax` des Automatikkontos | ohne BU-Schlüssel: DATEV rechnet die Steuer des Kontos heraus | | leer, `v-none`, `ust-none`, `ust-none-kleinunternehmer` oder `omit` | BU-Schlüssel 40: DATEV bucht ohne Steuer | | ein anderer Steuerschlüssel | der BU-Schlüssel zu diesem Steuerschlüssel | ## Beleg 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: | `kind` | Bedeutung | | --------- | ------------------------------------------------------------ | | `invoice` | Ausgangsrechnung: eine Rechnung, die die Firma gestellt hat | | `receipt` | Eingangsbeleg: eine Rechnung oder Quittung eines Lieferanten | Beim [Upload](/document-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. ## Buchung 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](#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](/data-types#beträge-von-buchungen)). * `refDocumentId`, `refBankTransactionId` und `refMatch` verweisen auf den Beleg, den Umsatz und die Zuordnung, aus denen die Buchung entstand. * `bookingFlags` enthält den [Steuerschlüssel](#steuerschlüssel) der Buchung. * Solange eine Buchung nicht [festgeschrieben](#festschreibung) 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`](https://developer.bimetrics.de/reference/accounting/filter-bookings.md) und [`GET /api/accounting/booking/{id}`](https://developer.bimetrics.de/reference/accounting/get-booking.md). Belege und Umsätze enthalten ihre Buchungen außerdem im Feld `bookings`. ## Debitor und Kreditor 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](https://developer.bimetrics.de/reference/accounting/list-account-labels.md) nennen sie mit dem Namen des Kontakts. ## Erkennung 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](/document-upload#verarbeitung-abfragen). ## Festschreibung 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](#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](#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`). ## Gegenkonto 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](#debitor-und-kreditor)). ## Kontenrahmen 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: | `accountingModel` | Bedeutung | | ------------------------ | ---------------------------------------------- | | `SKR03`, `SKR04` | Kontenrahmen ohne Besonderheiten | | `SKR03-v`, `SKR04-v` | Firma ohne Umsatzsteuerpflicht | | `SKR03-v-k`, `SKR04-v-k` | Firma mit Kleinunternehmerregelung (§ 19 UStG) | Ä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. ## Kontingent Die Zahl der Belege, die der Tarif im Abrechnungszeitraum enthält. [Tarif und Kontingent lesen](https://developer.bimetrics.de/reference/plan/get-entitlement.md) 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. ## Sachkonto Ein Konto im [Kontenrahmen](#kontenrahmen) der Firma, etwa für Erlöse, Aufwendungen oder Bankkonten. Die Nummern aller bebuchten Konten liefert [`GET /api/accounting/accounts/`](https://developer.bimetrics.de/reference/accounting/list-used-accounts.md), ihre Bezeichnungen [`GET /api/accounting/accounts/labels/`](https://developer.bimetrics.de/reference/accounting/list-account-labels.md). ## Steuerschlüssel 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. | `bookingFlags` | Bedeutung | | ----------------------------- | ----------------------------------- | | `v19%`, `v7%`, `v9%`, `v5.5%` | Vorsteuer mit dem genannten Satz | | `ust19%`, `ust7%` | Umsatzsteuer mit dem genannten Satz | Werte mit `none`, `reverse-charge` oder `omit` sowie ein leerer Wert haben keinen eigenen Steuersatz. Die Liste ist nicht abschließend. [Automatikkonten](#automatikkonto) nennen ihren Steuerschlüssel in derselben Form im Feld `tax` der Kontenbezeichnungen. ## Storno 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](#zuordnung) der Art `invoice_cancellation` verbindet Belege, die sich gegenseitig aufheben, etwa eine Rechnung und ihre Stornorechnung. Sie ist keine Zahlung. ## Umsatz 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. ## Zuordnung 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`. | `match.category` | Bedeutung | | ---------------------- | ------------------------------------------------------------- | | `payment` | Zahlung: Belege und die Umsätze, mit denen sie bezahlt wurden | | `invoice_cancellation` | Storno: Belege, die sich gegenseitig aufheben, ohne Umsatz | | `money_transfer` | Umbuchung zwischen eigenen Bankkonten, ohne Beleg | `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.