Offene Posten zum Stichtag
Die Offene-Posten-Liste der Kunden oder Lieferanten zu einem Stichtag lesen und als CSV oder PDF für die Kanzlei laden.
Die Offene-Posten-Liste (OPOS) zeigt zu einem Stichtag, was jeder Kunde noch schuldet und was die Firma jedem Lieferanten noch schuldet. Die Summe je Personenkonto ist sein Saldo, wie ihn der DATEV-Export bis zu diesem Tag ergibt. So lässt sie sich mit den Personenkonten in DATEV abgleichen.
Ablauf
- Liste lesen:
GET /api/open-itemsmitside=customersfür die Kunden oderside=suppliersfür die Lieferanten und dem Stichtag inasOf, etwa2026-12-31. OhneasOfgilt heute. Den Stichtag schreibst du alsJJJJ-MM-TT(siehe Datentypen). - Auswerten: Jeder Eintrag in
groupsist ein Personenkonto mit seiner Summe intotalMinor, den Summen je Altersstufe inbucketsund den Posten initems, die früheste Fälligkeit zuerst.totalMinorundbucketsauf oberster Ebene gelten für die ganze Liste. - Dateien für die Kanzlei:
GET /api/open-items/csvliefert dieselbe Liste als CSV für Excel, eine Zeile je Posten,GET /api/open-items/pdfals PDF zum Weitergeben. Mitdownload=1nennt der HeaderContent-Dispositionden Dateinamen, etwaOffene-Posten-Kunden-2026-12-31.pdf.
Code
Du brauchst einen Schlüssel mit der Berechtigung read in der Umgebungsvariable BIMETRICS_API_KEY. Das Beispiel liest die offenen Posten der Kunden zum 31.12.2026, gibt je Konto die Summe und den Teil aus, der über 90 Tage überfällig ist, und speichert CSV und PDF. Das JavaScript-Beispiel braucht Node.js ab Version 20 und läuft nur als ES-Modul, weil es import und await außerhalb von Funktionen nutzt: Speichere es als offene-posten.mjs oder setze in deiner package.json "type": "module".
#!/usr/bin/env bash
set -euo pipefail
API="https://app.bimetrics.de/api"
AUTH="Authorization: Bearer $BIMETRICS_API_KEY"
QUERY="side=customers&asOf=2026-12-31"
# 1. Liste der Kunden zum Stichtag
curl --fail --silent --show-error --retry 5 -H "$AUTH" "$API/open-items?$QUERY" >offene-posten.json
# 2. Je Konto: offen gesamt und davon über 90 Tage überfällig, in Euro
jq -r '(.groups // [])[]
| [.account, (if .collective then "Ohne Kundennummer" else .name end),
(.totalMinor / 100), ((.buckets.over_90 // 0) / 100)]
| @tsv' offene-posten.json
# 3. CSV und PDF für die Kanzlei
for ext in csv pdf; do
curl --fail --silent --show-error --retry 5 -H "$AUTH" \
-o "Offene-Posten-Kunden-2026-12-31.$ext" "$API/open-items/$ext?$QUERY"
doneWas die Liste zählt
- Buchungen bis zum Stichtag: Es zählt jede Buchung auf einem Personenkonto bis einschließlich
asOf: der Beleg mit seinem Belegdatum, eine Bankzahlung mit ihrer Wertstellung, eine erfasste Zahlung mit ihrem Zahltag. Die Zuordnungen gelten so, wie sie heute sind. Eine Zahlung, die vor dem Stichtag einging, aber erst danach zugeordnet wurde, gleicht ihren Beleg deshalb schon zum Stichtag aus. - Teilzahlung und Sammelposten: Nach einer Teilzahlung bleibt ein Beleg mit seinem Rest offen. Ist eine Zahlung mehreren Belegen zugeordnet und bleibt ein Rest, steht er als ein Posten mit
kindcollectionda.documentsnennt die Belege; fällig ist der Posten mit dem frühesten. - Guthaben: Eine Überzahlung ist ein Posten mit negativem
amountMinor. Sie mindert die Summe des Kontos, wie in DATEV. - Sammelkonto: Belege von Kontakten ohne Kunden- oder Lieferantennummer stehen wie im DATEV-Export auf dem Konto 10000 bzw. 70000, mit
collectivegleichtrue. Jeder Posten nennt dort innameseinen Kunden oder Lieferanten. - Was fehlt: Abschlagsrechnungen bucht bimetrics bei Soll-Versteuerung und als Kleinunternehmer erst mit der Zahlung, ihr unbezahlter Rest fehlt deshalb. Belege mit einem Buchungsfehler sind noch gar nicht gebucht. Belege in fremder Währung ohne Euro-Betrag hält der DATEV-Export samt ihrer Zuordnung zurück, bis der Euro-Betrag feststeht. Alle drei fehlen deshalb in der Liste und im DATEV-Export.
downPaymentsundbookingErrorsnennen Zahl und Summe,waitingForEurodie Zahl der Belege und den Saldo ihrer weggelassenen Buchungen.
Beträge und Daten
- Alle Beträge sind Euro-Cent als Ganzzahl. Bei den Kunden ist positiv, was der Kunde schuldet, bei den Lieferanten, was die Firma schuldet. Bei einem Beleg in Fremdwährung nennt der Posten zusätzlich
currencyund den Belegbetrag in dieser Währung inoriginalAmountMinor. bucketsnennt nur Altersstufen mit Posten:not_due,1_30,31_60,61_90undover_90. Eine fehlende Stufe zählt als 0, deshalb setzen die Beispiele 0 ein.dateunddueDatekommen als Objekt{ "year", "month", "day" }wie jedes Kalenderdatum in den Antworten.daysOverduezählt vondueDatebis zum Stichtag; 0 oder weniger heißt nicht überfällig.- Gibt es keine offenen Posten, ist
groupsleer.