Offene Posten als CSV
Benötigte Berechtigung:read(Daten lesen)
Liefert dieselbe Liste wie GET /api/open-items als CSV-Datei für Excel, eine Zeile je Posten: Stichtag, Personenkonto, Kunden- oder Lieferantennummer, Name, Art, Beleg, Belegdatum, Fälligkeit, Tage überfällig, Altersstufe und offener Betrag in Euro, bei einem Beleg in Fremdwährung auch Währung und Belegbetrag. Die Datei ist UTF-8 mit BOM, trennt die Spalten mit Semikolon und schreibt Beträge mit Dezimalkomma. Ein Sammelposten nennt in der Spalte „Beleg“ alle Belegnummern. Beginnt ein Name oder eine Belegnummer mit =, +, - oder @, steht ein Hochkomma davor, damit Excel sie nicht als Formel liest. Fehler wie bei GET /api/open-items. Alle Rollen dürfen die Liste abrufen, auch die Steuerberatung.
Benötigt einen Schlüssel mit der Berechtigung read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
side*stringcustomers für die Kunden (Debitoren), suppliers für die Lieferanten (Kreditoren).
asOf?stringStichtag als JJJJ-MM-TT, etwa 2026-12-31. Ohne den Parameter gilt heute (deutsche Zeit).
download?string1 liefert die Datei als Download mit Dateinamen.
Die Liste als CSV-Datei, eine Zeile je Posten.
response?unknowntext/csvcurl --fail-with-body "https://app.bimetrics.de/api/open-items/csv?side=string" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"nullOffene Posten zum Stichtag lesen GET
Liefert die Offene-Posten-Liste (OPOS) zu einem Stichtag: mit `side=customers`, was jeder Kunde noch schuldet, mit `side=suppliers`, was die Firma jedem Lieferanten noch schuldet. Je Personenkonto enthält sie die Summe, die Summen je Altersstufe und die offenen Posten mit Fälligkeit und Tagen überfällig. Gezählt wird jede Buchung auf einem Personenkonto bis einschließlich Stichtag, mit den Zuordnungen von heute: Bankzahlungen nach Wertstellung, erfasste Zahlungen nach ihrem Zahltag. Die Summe eines Kontos (`totalMinor`) ist deshalb sein Saldo, wie ihn der DATEV-Export bis zu diesem Tag ergibt. Nach einer Teilzahlung bleibt ein Beleg mit seinem Rest offen. Ist eine Zahlung mehreren Belegen zugeordnet und bleibt ein Rest, steht er als ein Sammelposten da (`kind` `collection`). Skonto, eine Ausbuchung und eine zugeordnete Gutschrift mindern den offenen Betrag wie eine Zahlung; eine Überzahlung ist ein negativer Posten, also ein Guthaben. Alle Beträge sind Euro-Cent: positiv ist, was der Kunde schuldet oder was die Firma dem Lieferanten schuldet. Bei einem Beleg in Fremdwährung nennt der Posten zusätzlich den Belegbetrag in dieser Währung. Nicht in der Liste stehen Abschlagsrechnungen vor ihrer Zahlung, die bimetrics bei Soll-Versteuerung und als Kleinunternehmer erst mit der Zahlung bucht, und Belege, die ein Buchungsfehler am Buchen hindert. `downPayments` und `bookingErrors` nennen Zahl und Summe. Ein anderer Wert für `side` oder ein ungültiger Stichtag ergibt `400 OpenItemsInvalidQuery`, `context.field` nennt das Feld. Alle Rollen dürfen die Liste abrufen, auch die Steuerberatung. Benötigt einen Schlüssel mit der Berechtigung `read`.
Offene Posten als PDF GET
Liefert dieselbe Liste wie `GET /api/open-items` als PDF, zum Ausdrucken oder Weitergeben, etwa an die Steuerberatung. Oben stehen Firma, Stichtag und der Tag, dessen Zuordnungen gelten, dann die Summen je Altersstufe. Danach folgt je Personenkonto eine Tabelle mit Beleg, Name, Belegdatum, Fälligkeit, Tagen überfällig und offenem Betrag, am Ende Hinweise auf fehlende Abschlagsrechnungen und Belege mit Buchungsfehler. Das PDF wird bei jedem Aufruf neu aus den Buchungen erstellt. Fehler wie bei `GET /api/open-items`. Alle Rollen dürfen die Liste abrufen, auch die Steuerberatung. Benötigt einen Schlüssel mit der Berechtigung `read`.