bimetricsEntwickler
Offene Posten

Offene Posten als CSV

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/open-items/csv

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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

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

Query-Parameter

side*string

customers für die Kunden (Debitoren), suppliers für die Lieferanten (Kreditoren).

asOf?string

Stichtag als JJJJ-MM-TT, etwa 2026-12-31. Ohne den Parameter gilt heute (deutsche Zeit).

download?string

1 liefert die Datei als Download mit Dateinamen.

Antworten

Die Liste als CSV-Datei, eine Zeile je Posten.

response?unknowntext/csv
Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/open-items/csv?side=string" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
null

Offene 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`.