bimetricsEntwickler
Buchhaltung

DATEV-Export zusammenfassen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/export/datev/summary

Fasst zusammen, was ein DATEV-Export des Jahres jetzt enthielte, je Monat: wie viele Buchungen es gibt, wie viele davon noch nicht in DATEV sind, wie viele der Export enthält und festschreibt, die Belege und die ungeklärten Bankumsätze. Die Zusammenfassung bucht nichts und schreibt nichts fest. Sie wählt aus wie der Export: Anlagenbuchungen, die er zurückhält, Buchungen, die auf einen Euro-Betrag warten, und mit onlyNew Belege und Umsätze, die DATEV schon mit einem früheren Kontenrahmen oder Steuerstatus hat, zählen nicht mit. Buchungen eines nicht zugestellten Exports gelten als noch nicht exportiert. totals nennt, was ein Export des ganzen Zeitraums enthält und festschreibt. Für einen Export einzelner Monate summierst du deren inExport und open. Das stimmt, solange ein Paar aus Buchung und Storno auf einem Konto, das DATEV nicht mehr annimmt, im selben Monat liegt; liegt es über eine Monatsgrenze, nimmt der Export nur eines Monats seine Hälfte in den Stapel. documents der Monate summierst du nicht, denn ein Beleg mit Buchungen in mehreren Monaten zählt in jedem. Die Belege einzelner Monate ergeben sich aus totals.documentMonths: die Summe der count, deren months einen der Monate enthalten. Was noch nicht gebucht ist, bucht erst countDatevOpenBookings; dessen Zahl kann deshalb etwas höher liegen.

Ohne from und to steht in previousYear, wie viele Nachträge es im Vorjahr seit dessen letztem Export gibt. Welche das sind, liefert dieselbe Route für das Vorjahr mit since: Dann zählen nur Buchungen, deren Tag im Zeitraum eines zugestellten Exports liegt und die nach since erfasst wurden. Was in einem nie exportierten Monat liegt, zählt nicht, auch wenn es später erfasst wurde. Die addenda der Monate ergeben zusammen previousYear.addenda; previousYear selbst ist null.

Benötigt einen Schlüssel mit der Berechtigung read.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Query-Parameter

year*integer

Kalenderjahr, Pflicht.

from?string

Optional mit to: erster Buchungstag im Jahr, YYYY-MM-DD. Dann zählen nur die Tage von from bis to.

to?string

Optional mit from: letzter Buchungstag im Jahr, YYYY-MM-DD.

onlyNew?boolean

Umfang wie beim Export: true heißt „Nur was noch nicht exportiert ist“. Fehlt der Wert, zählt alles im Zeitraum, wie beim Export per API.

parts?string

Teile des Exports, durch Komma getrennt: bookings, documents, protocol. Ohne Angabe Buchungen und Belege.

offset?integer

Erste Buchung je Monat in items, ab 0.

limit?integer

Höchstens so viele Buchungen je Monat in items, 0 bis 100, Standard 6.

since?string

Optional, Zeitpunkt nach RFC 3339, URL-kodiert: Dann zählen nur Nachträge, die danach erfasst wurden, zusammen mit onlyNew=true; ohne zählen auch Buchungen, die DATEV aus einem früheren Kontenrahmen oder Steuerstatus schon hat. Mit previousYear.exportedAt und year des Vorjahrs sind das genau die Buchungen, die previousYear.addenda zählt.

Antworten

Erfolg.

application/json
  1. response

Was DATEV-Exporte des Jahres enthalten, je Monat.

months?array<>|

Die Monate des Zeitraums, der älteste zuerst; ohne from und to alle zwölf.

onlyNew?boolean

Umfang der Zahlen, wie angefragt.

previousYear?|

Nur ohne from, to und since: die Nachträge des Vorjahrs. null, wenn es dort keinen zugestellten Export gibt.

totals?

Die Zahlen eines Exports des ganzen Zeitraums.

year?integer

Kalenderjahr.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/export/datev/summary?year=0" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "months": [    {      "addenda": 0,      "documents": 0,      "finalized": 0,      "inExport": 0,      "items": [],      "lastExport": "2026-09-04T07:40:00Z",      "month": "2026-01",      "notExported": 0,      "open": 0,      "total": 190,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 0,      "documents": 0,      "finalized": 0,      "inExport": 0,      "items": [],      "lastExport": "2026-09-04T07:40:00Z",      "month": "2026-02",      "notExported": 0,      "open": 0,      "total": 190,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 0,      "documents": 0,      "finalized": 0,      "inExport": 0,      "items": [],      "lastExport": "2026-09-04T07:40:00Z",      "month": "2026-03",      "notExported": 0,      "open": 0,      "total": 190,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 0,      "documents": 0,      "finalized": 0,      "inExport": 0,      "items": [],      "lastExport": "2026-09-04T07:40:00Z",      "month": "2026-04",      "notExported": 0,      "open": 0,      "total": 190,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 0,      "documents": 0,      "finalized": 0,      "inExport": 0,      "items": [],      "lastExport": "2026-09-04T07:40:00Z",      "month": "2026-05",      "notExported": 0,      "open": 0,      "total": 190,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 0,      "documents": 0,      "finalized": 0,      "inExport": 0,      "items": [],      "lastExport": "2026-09-04T07:40:00Z",      "month": "2026-06",      "notExported": 0,      "open": 0,      "total": 190,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 0,      "documents": 0,      "finalized": 0,      "inExport": 0,      "items": [],      "lastExport": "2026-09-04T07:40:00Z",      "month": "2026-07",      "notExported": 0,      "open": 0,      "total": 190,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 0,      "documents": 0,      "finalized": 0,      "inExport": 0,      "items": [],      "lastExport": "2026-09-04T07:40:00Z",      "month": "2026-08",      "notExported": 0,      "open": 0,      "total": 190,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 2,      "documents": 1,      "finalized": 2,      "inExport": 2,      "items": [],      "lastExport": "2026-10-06T08:12:00Z",      "month": "2026-09",      "notExported": 2,      "open": 0,      "total": 212,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 0,      "documents": 151,      "finalized": 0,      "inExport": 236,      "items": [        {          "account": 4930,          "accountContra": 70001,          "addendum": false,          "amount": "59.5",          "bookingDate": {            "day": 2,            "month": 10,            "year": 2026          },          "id": "6f1c2d4a-3b9e-4c8e-9f7b-5a1d0e2c4b71",          "label": "Büromaterial",          "reversal": false,          "unmatched": false        }      ],      "lastExport": null,      "month": "2026-10",      "notExported": 236,      "open": 236,      "total": 236,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 0,      "documents": 0,      "finalized": 0,      "inExport": 0,      "items": [],      "lastExport": null,      "month": "2026-11",      "notExported": 0,      "open": 0,      "total": 0,      "unmatched": 0,      "unmatchedExported": 0    },    {      "addenda": 0,      "documents": 0,      "finalized": 0,      "inExport": 0,      "items": [],      "lastExport": null,      "month": "2026-12",      "notExported": 0,      "open": 0,      "total": 0,      "unmatched": 0,      "unmatchedExported": 0    }  ],  "onlyNew": true,  "previousYear": {    "addenda": 12,    "exportedAt": "2026-01-09T10:30:00Z",    "year": 2025  },  "totals": {    "documentMonths": [      {        "count": 1,        "months": [          "2026-09",          "2026-10"        ]      },      {        "count": 150,        "months": [          "2026-10"        ]      }    ],    "documents": 151,    "finalized": 2,    "inExport": 238,    "open": 236  },  "year": 2026}

Stornos auf Konten, die DATEV nicht mehr annimmt GET

Zählt die Stornos, die ein Export von `from` bis `to` mit „Nur was noch nicht exportiert ist“ an DATEV schickt, zu Buchungen, die DATEV schon bekommen hat. Gezählt werden nur Buchungen auf Konten, die DATEV für das Buchungsjahr nicht mehr annimmt: laut DATEV-Kontenrahmen 2026 SKR03 8195 und 8600, SKR04 4185 und 3850, dazu Konto 0. Daneben steht jeweils die Neubuchung auf dem heutigen Konto. DATEV meldet die Zeilen dieser Stornos beim Import als fehlerhaft. Die Meldungen.csv im Export nennt die Belege und Umsätze dazu, bei „Alle im Zeitraum“ auch die schon einmal gesendeten Stornos. Benötigt einen Schlüssel mit der Berechtigung `read`.

Stand eines DATEV-Exports abrufen GET

Liefert den Stand eines DATEV-Exports: `waiting`, `running`, `done`, `failed`, `cancelled` oder `expired`. Ist er fertig (`done`), stehen seine Dateien in `files`; jede lädst du über ein Ticket von `issueExportFileTicket`. Ob die Buchungen festgeschrieben sind (nur mit `bookings: true`): bei `waiting` nein, bei `running` ab dem Schritt `write`, bei `done` und `expired` ja. Läuft ein Auftrag nach einem abgebrochenen Versuch erneut, kann er schon vor `write` festgeschrieben sein. Bei `failed` oder `cancelled` nur mit `errorCode` `datev_interrupted`. In diesem Fall ist die Datei nicht fertig geworden. Exportiere den Zeitraum noch einmal mit `onlyNew: true`; die Buchungen sind dann dabei. Jeder andere `errorCode` heißt: nichts festgeschrieben. Andere Exporte der App, etwa Beleg-ZIPs, liefert die Route nicht (`404`). Benötigt einen Schlüssel mit der Berechtigung `datev:export`.