bimetricsEntwickler
Offene Posten

Offene Posten zum Stichtag lesen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/open-items

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.

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).

Antworten

Erfolg.

application/json
  1. 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?string

Zeitpunkt der Abfrage.

Formatdate-time
groups?array<>|

Die Personenkonten mit offenen Posten, nach Namen sortiert, das Sammelkonto zuletzt.

side?string

customers oder suppliers.

Wert in"customers""suppliers"
totalMinor?integer

Summe 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.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/open-items?side=string" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "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  }}