bimetricsEntwickler
Zu erledigen

„Zu erledigen“ lesen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/home/tasks

Liefert dieselben Aufgaben wie die Startseite: Belege prüfen, Zahlungen ohne Beleg, überfällige Rechnungen, nicht zugestellte Mails, ablaufende Bankfreigaben und Mails im Postfach, je Art eine Zeile mit Anzahl, dazu den Monatsstand der Belege und Zahlungen. Die Zahlen sind dieselben wie in den Listen der App. Ohne month kommen der Vormonat und der laufende Monat; die Zeilen nennen bis zum 10. die Arbeit des Vormonats, solange dort etwas offen ist, sonst die des laufenden.

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

month?string

Optional ein Monat YYYY-MM, nicht in der Zukunft: Monatsstand und Zeilen nur dieses Monats.

Antworten

Erfolg.

application/json
  1. response

„Zu erledigen“ und Monatsstand der Startseite.

asOf?string

Heutiges Datum in Deutschland, YYYY-MM-DD.

bankApprovals?array<>|

Bankfreigaben, die in den nächsten sieben Tagen ablaufen, die früheste zuerst. Erneuern geht nur in der App unter Einstellungen › Bank.

months?array<>|

Monatsstand: der Vormonat, dann der laufende Monat; mit month nur dieser.

rows?array<>|

Eine Zeile je Art mit offener Arbeit, in der Reihenfolge der Startseite. Fehlt eine Art, ist dort nichts zu tun.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/home/tasks" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "asOf": "2026-11-02",  "bankApprovals": [    {      "account": "Geschäftskonto",      "renewable": true,      "validUntil": "2026-11-06"    }  ],  "months": [    {      "documents": {        "complete": false,        "done": 36,        "open": 12,        "total": 48      },      "month": "2026-10",      "payments": {        "open": 3,        "total": 64      }    },    {      "documents": {        "complete": false,        "done": 3,        "open": 2,        "total": 5      },      "month": "2026-11",      "payments": {        "open": 1,        "total": 9      }    }  ],  "rows": [    {      "count": 12,      "kind": "review",      "month": "2026-10"    },    {      "count": 3,      "kind": "missing_receipts",      "month": "2026-10"    },    {      "count": 2,      "kind": "overdue",      "openMinor": 238000    },    {      "count": 1,      "kind": "bank_approval"    }  ]}

Tarif und Kontingent lesen GET

Liefert Tarif, Grenzen und die aktuelle Nutzung der Firma. Ein einfacher erster Aufruf, um Schlüssel und Verbindung zu prüfen. Benötigt einen Schlüssel mit der Berechtigung `read`.

Layouts lesen GET

Liefert die Layouts der Firma mit Gestaltung (`spec`), aktueller Version und den Belegarten, für die sie gelten (`appliesTo`), auch archivierte. Ohne eigenes Layout steht dort eines mit der ID `standard` und `own: false`; die erste Änderung legt daraus ein eigenes an. Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `read`.