Offene Posten zum Stichtag lesen
Benötigte Berechtigung:read(Daten lesen)
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.
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).
Erfolg.
application/json- response
Offene-Posten-Liste der Kunden oder der Lieferanten zu einem Stichtag.
asOf?Der Stichtag.
bookingErrors?Belege bis zum Stichtag, die ein Buchungsfehler am Buchen hindert, etwa eine fehlende USt-IdNr. Sie fehlen in der Liste, bis der Fehler behoben ist.
buckets?|Beträge in Cent je Altersstufe.
downPayments?Abschlagsrechnungen bis zum Stichtag mit ihrem unbezahlten Rest. Bei Soll-Versteuerung und als Kleinunternehmer bucht bimetrics sie erst mit der Zahlung, deshalb fehlen sie in der Liste; bei Ist-Versteuerung stehen sie in der Liste und zählen hier nicht. Nur bei customers.
generatedAt?stringZeitpunkt der Abfrage.
date-timegroups?array<>|Die Personenkonten mit offenen Posten, nach Namen sortiert, das Sammelkonto zuletzt.
side?stringcustomers oder suppliers.
"customers""suppliers"totalMinor?integerSumme aller offenen Posten in Cent; negativ ist ein Guthaben.
waitingForEuro?Belege in fremder Währung ohne Euro-Betrag, deren Buchungen der DATEV-Export samt ihrer Zuordnung weglässt, solange DATEV sie nicht hat und der Euro-Betrag nicht feststeht. Die Liste lässt sie deshalb auch weg. Hat DATEV den Beleg schon, fehlen nur seine späteren Zahlungen. count ist die Zahl dieser Belege, amountMinor der Saldo ihrer weggelassenen Buchungen auf den Personenkonten. Das ist kein Belegbetrag und kann negativ sein.
curl --fail-with-body "https://app.bimetrics.de/api/open-items?side=string" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "asOf": { "day": 16, "month": 11, "year": 2026 }, "bookingErrors": { "amountMinor": 0, "count": 0 }, "buckets": { "31_60": 5000, "61_90": 70000, "not_due": 50000, "over_90": 11900 }, "downPayments": { "amountMinor": 238000, "count": 1 }, "generatedAt": "2026-11-16T09:30:00Z", "groups": [ { "account": 11004, "buckets": { "31_60": 5000, "61_90": 70000, "not_due": 50000 }, "collective": false, "contactId": "b17e8812-eae4-49b6-b5dc-30510635cb07", "customerNumber": 1004, "items": [ { "amountMinor": 70000, "bucket": "61_90", "date": { "day": 1, "month": 9, "year": 2026 }, "daysOverdue": 62, "documentId": "3026096b-614f-40d3-8749-8acf9b529480", "dueDate": { "day": 15, "month": 9, "year": 2026 }, "kind": "document", "name": "Brauhaus Elbwiese GmbH", "number": "RE-2026-0087" }, { "amountMinor": 5000, "bucket": "31_60", "date": { "day": 1, "month": 10, "year": 2026 }, "daysOverdue": 32, "documents": [ { "documentId": "3f5c1a2e-8b4d-4c6e-9a7f-1d2e3f4a5b6c", "number": "RE-2026-0101" }, { "documentId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d", "number": "RE-2026-0102" } ], "dueDate": { "day": 15, "month": 10, "year": 2026 }, "kind": "collection", "matchId": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "name": "Brauhaus Elbwiese GmbH", "number": "" }, { "amountMinor": 50000, "bucket": "not_due", "date": { "day": 10, "month": 11, "year": 2026 }, "daysOverdue": -8, "documentId": "b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e", "dueDate": { "day": 24, "month": 11, "year": 2026 }, "kind": "document", "name": "Brauhaus Elbwiese GmbH", "number": "RE-2026-0131" } ], "name": "Brauhaus Elbwiese GmbH", "totalMinor": 125000 }, { "account": 10000, "buckets": { "over_90": 11900 }, "collective": true, "items": [ { "amountMinor": 11900, "bucket": "over_90", "date": { "day": 1, "month": 8, "year": 2026 }, "daysOverdue": 107, "documentId": "e1331e65-c539-4c84-9271-66cc20f52910", "dueDate": { "day": 1, "month": 8, "year": 2026 }, "kind": "document", "name": "Café Hafenblick", "number": "RE-2026-0042" } ], "name": "", "totalMinor": 11900 } ], "side": "customers", "totalMinor": 136900, "waitingForEuro": { "amountMinor": 0, "count": 0 }}Kostenstelle oder Verteilung zurückholen POST
Holt eine archivierte Kostenstelle oder Verteilung zurück, sie lässt sich danach wieder auswählen. Eine Verteilung geht nur zurück, solange ihre Kostenstellen nicht archiviert sind, sonst `400 CostCenterRejected`. Benötigt einen Schlüssel mit der Berechtigung `company:write`.
Offene Posten als CSV GET
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`.