Layouts lesen
Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)
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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Erfolg.
application/json- response
Die Layouts der Firma.
issuedKinds?array<string>|Belegarten mit mindestens einem ausgestellten Beleg.
layouts?array<>|Alle Layouts, auch archivierte, in der Reihenfolge ihrer Anlage.
curl --fail-with-body "https://app.bimetrics.de/api/layouts" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "issuedKinds": [ "invoice" ], "layouts": [ { "appliesTo": [ "*" ], "archivedAt": null, "editable": true, "id": "243ee0cc-b1c7-4335-8817-6bc939f0f615", "module": "modern@2", "name": "Hansen & Kowalski Werbetechnik GmbH", "own": true, "spec": { "blocks": {}, "brandColor": "#1F5F5B", "module": "modern", "preset": "modern", "recipe": "", "schema": 2, "values": { "footer.pageNumber": "auto", "footer.titles": false, "header.logo.size": "L", "page.margin.left": 25 } }, "version": { "actor": { "membershipId": "53cd10a9-c864-4dc3-a777-9860d59efe6c", "name": "Jana Hansen" }, "check": "passed", "createdAt": "2026-11-04T10:15:00Z", "id": "16f6234e-8667-42f0-9584-6a397dc5f36a", "number": 2, "origin": "api", "originRef": null, "parentId": "b1a72031-ace3-4bdc-a63d-477d6be5d7cb", "summary": "Logo größer (L), Hausfarbe #1F5F5B" } }, { "appliesTo": [ "proposal" ], "archivedAt": null, "editable": true, "id": "bab564a1-86e9-45aa-98d7-2410bd59ba4b", "module": "modern@2", "name": "Angebote", "own": true, "spec": { "blocks": {}, "brandColor": null, "module": "modern", "preset": "modern", "recipe": "friendly", "schema": 2, "values": { "footer.pageNumber": "auto", "footer.titles": false, "header.rule": false, "items.head.style": "brand", "page.margin.left": 25, "title.brand": true } }, "version": { "actor": { "membershipId": "53cd10a9-c864-4dc3-a777-9860d59efe6c", "name": "Jana Hansen" }, "check": "passed", "createdAt": "2026-11-04T10:15:00Z", "id": "e1c5d5b2-3f0e-4f43-9a7c-2b7f0d5c8a11", "number": 2, "origin": "api", "originRef": null, "parentId": "5b0a3c7e-9d84-4e1f-a6b2-8c3d4e5f6a70", "summary": "Vorlage Modern verwendet, Rezept Freundlich" } } ]}„Zu erledigen“ lesen GET
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`.
Layout anlegen POST
Legt ein Layout aus einer Vorlage des Katalogs an, wie „Neues Layout“ im Editor. Mit `documentKind` gilt es sofort für diese Belegart, auch für ihre offenen Entwürfe; das erste Layout einer Firma gilt für alle Belegarten. Die Version davor hält den bisherigen Stand fest. Idempotency-Key bei Wiederholung unverändert senden. Benötigt einen Schlüssel mit der Berechtigung `layout:write`.