bimetricsEntwickler
Layouts

Versionen lesen

Als Markdown ansehen

Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)

GET
/api/layouts/{id}/versions

Liefert die Versionen eines Layouts, die neueste zuerst, höchstens 50 je Seite, jede mit der Änderung in einer Zeile (summary), Herkunft (origin), Person und Gestaltung. Für die nächste Seite nextBefore als before senden. Versionen werden nie gelöscht.

Benötigt einen Schlüssel mit der Berechtigung sales:read oder read.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID des Layouts (UUID) oder standard, das Layout aller Belegarten ohne eigenes.

Query-Parameter

before?integer

Nur Versionen mit kleinerer Nummer: nextBefore der vorigen Seite.

Antworten

Erfolg.

application/json
  1. response

Eine Seite der Versionen, die neueste zuerst.

nextBefore?|

Für die nächste Seite als before senden; null auf der letzten.

versions?array<>|

Die Versionen dieser Seite.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/layouts/string/versions" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "nextBefore": null,  "versions": [    {      "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",      "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        }      },      "summary": "Logo größer (L), Hausfarbe #1F5F5B"    },    {      "actor": null,      "check": "passed",      "createdAt": "2026-11-04T09:15:00Z",      "id": "b1a72031-ace3-4bdc-a63d-477d6be5d7cb",      "number": 1,      "origin": "migration",      "originRef": null,      "parentId": null,      "spec": {        "blocks": {},        "brandColor": null,        "module": "modern",        "preset": "modern",        "recipe": "",        "schema": 2,        "values": {          "footer.pageNumber": "auto",          "footer.titles": false,          "page.margin.left": 25        }      },      "summary": "Vorlage Modern"    }  ]}

Layout zurückholen POST

Holt ein archiviertes Layout zurück. Es gilt danach für keine Belegart. Benötigt einen Schlüssel mit der Berechtigung `layout:write`.

Rechnungslogo löschen DELETE

Löscht das Rechnungslogo mit allen Fassungen und das Zeichen, das bimetrics daraus gemacht hat; ein eigenes App-Zeichen bleibt. Neue Belege und offene Entwürfe drucken danach ohne Logo, ausgestellte Belege behalten ihres. Nicht umkehrbar. Benötigt einen Schlüssel mit der Berechtigung `layout:write`.