bimetricsEntwickler
Logo

Rechnungslogo löschen

Als Markdown ansehen

Benötigte Berechtigung:layout:write(Layouts und Logo ändern)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
delete/api/company/logo

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

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

Query-Parameter

expectedLogoId?string

Optional: die ID des aktiven Bildes wie gelesen (invoice.active.id beim Rechnungslogo, app.id beim App-Zeichen), leer, wenn es keins gab. Hat sich das Logo seitdem geändert, antwortet die Route mit 409 LogoChanged und ändert nichts. Ohne den Parameter prüft die Route nichts.

Header-Parameter

Idempotency-Key*string

Stabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.

Muster^[!-~]+$
Länge1 <= length <= 128

Antworten

Erfolg.

application/json
  1. response

Das Logo der Firma. Ändern geht mit layout:write und gilt für alle Layouts.

app?|

Das App-Zeichen; null für das bimetrics-Zeichen.

enabled?boolean

Immer true, das Logo lässt sich ändern.

frame?

Der Logo-Rahmen des Layouts der Firma.

invoice?|

Das Rechnungslogo; null ohne Logo.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/company/logo" -X DELETE \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001"
Beispielantwort
{  "app": null,  "enabled": true,  "frame": {    "heightMm": 16,    "layout": "modern",    "widthMm": 48  },  "invoice": null}

Versionen lesen GET

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

Logo lesen GET

Liefert das aktive Rechnungslogo mit Größe, Auflösung im Logo-Rahmen des Layouts (`dpiInFrame`) und Hinweisen, einen offenen Vorschlag von „Mach es passend“, die helle Fassung und das App-Zeichen. Die Bilder lädt `GET /api/blob/{sha256}/{id}` mit `blob.sha256` und `blob.id`, mit demselben Schlüssel. Die IDs der aktiven Bilder sind `expectedLogoId` der Änderungen. Benötigt einen Schlüssel mit der Berechtigung `read`.