Zum Inhalt
brandbill

Für Software & Entwickler Deine Belege. Gedruckt in deinem Layout.

Zwei Wege über dieselbe API: brandbill führt Kunden, Nummernkreis und Archiv für dich — oder dein System behält alles, und brandbill druckt nur. Die Vorlage gestaltest du im Editor, das PDF kommt zurück.

Ablauf: Dein System schickt die Belegdaten an den brandbill-Druckdienst, der das PDF in deiner Vorlage zurückgibt. Dein System POST /api/v1/render PDF zurück nichts gespeichert brandbill Druckdienst Vorlage aus dem Editor PDF AN-2026-0012 · 3 Positionen type: quote Angebot AN-2026-0012 gültig bis · Positionen · Summe RE-2026-0042 · Summen geprüft type: invoice Rechnung RE-2026-0042 GiroCode · ZUGFeRD · Archiv Stand 60 % · bisher 30 % type: invoice 2. Teilrechnung RE-2026-0050 Bezug auf frühere Rechnungen 60 % 1. Mahnung · offen + Gebühr type: dunning Mahnung MA-2026-00007 neue Frist · Gebühr · Zinsen Titel · Markdown · Tabellen type: document Projektbericht im Briefkopf, beliebig viele Seiten
Ablauf: Dein System schickt die Belegdaten an den brandbill-Druckdienst, der das PDF in deiner Vorlage zurückgibt. Angebot, Rechnung, Teilrechnung, Mahnung, Bericht.

Nur drucken: so läuft die Anbindung

Drei Schritte vom eigenen System zum fertigen PDF.

  1. 01

    Vorlage gestalten

    Rechnung, Angebot oder Briefpapier im Editor anlegen. GET /api/v1/templates nennt dir jede Vorlage mit den Platzhaltern, die sie braucht — und woher ihr Wert kommt.

  2. 02

    Schlüssel «Nur Drucken»

    Unter Einstellungen → API-Schlüssel einen Schlüssel mit Umfang «Nur Drucken» anlegen. Er erreicht den Druck und die Vorlagen, sonst nichts.

  3. 03

    Belege schicken

    Nummer, Datum, Kunde, Positionen und deine Summen an POST /api/v1/render. Weichen die Summen ab, wird nicht gedruckt — dein PDF zeigt nie andere Beträge, als du buchst.

Beispiel: eine Rechnung drucken
curl -X POST https://brandbill.de/api/v1/render \
  -H "Authorization: Bearer bb_…" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "invoice",
    "number": "2026-00042",
    "issue_date": "2026-10-26",
    "customer_name": "Kunde GmbH",
    "lines": [{ "description": "Leistung", "quantity": 1,
                "unit_price": 1200, "vat_rate": 19 }],
    "expected_totals": { "net_cents": 120000,
      "vat_cents": 22800, "gross_cents": 142800 }
  }' \
  -o 2026-00042.pdf

Wir nutzen es selbst

Unser eigenes PSA — Projekte, Zeiten, Buchhaltung — druckt Angebote, Rechnungen, Teilrechnungen und Mahnungen genau so: Es behält Nummernkreis, Zahlungen und DATEV, brandbill liefert das Layout. Eine Mahnung wird dabei aus der Rechnungs-Vorlage, mit offenem Betrag, Gebühr und Zinsen.

  • Angebot, Rechnung, Teil- und Schlussrechnung, Rechnungskorrektur, Storno, Mahnung, freier Text
  • Wiederholte Anfragen sofort aus dem Cache, bis die Vorlage sich ändert
  • Vorschau ohne Nummer und ohne Zählung
  • Nur Anzahlen in der Statistik, nie Inhalte
  • Gleiche Nummer erneut gedruckt zählt einmal

Aus der Praxis

Zwei Systeme. Derselbe Baustein, verschieden tief eingesteckt.

Zwei Anbindungen aus unserer eigenen Arbeit, ohne Namen: Ein Händler lässt brandbill sein ganzes Belegwesen führen, eine Projekt-Software behält alles und lässt nur drucken. Beide sprechen dieselbe öffentliche API.

Ein eigenes System. Das Belegwesen steckt man ein.

Ein Händler führt Katalog, Shop, Kasse und Vermietung in seiner eigenen Verwaltung. Angebote, Rechnungen mit QR-Zahlteil, Mietverträge, Lieferscheine und Mahnungen kommen von brandbill — über die öffentliche API, ohne Sondercode und ohne zweites Login für das Team.

Architektur: Shop und Team arbeiten in der eigenen Verwaltung; die spricht brandbill über REST, Druck und eingebettete Oberflächen an; heraus kommen Belege für die Kundschaft. Webshop Kundschaft Team Innendienst Eigene Verwaltung Katalog Kasse Miete Kunden REST render embed brandbill Belege · Druck · Oberflächen Rechnung in CHF mit QR-Zahlteil · per Mail Mietrechnungen als Entwurf, ohne Nummer brandbill in der Verwaltung Angebote · Mahnungen · Vorlagen Briefe und Mails im eigenen Briefpapier

Bestellt, berechnet, verschickt — in einem Zug.

Die Kasse der Verwaltung übergibt den Warenkorb. brandbill legt Kundin und Rechnung an, stellt sie aus und schickt sie mit QR-Zahlteil — bezahlt wird per Vorkasse, versandt nach Zahlungseingang.

  1. POST /customers Kundin finden oder anlegen
  2. POST /documents Rechnung in CHF, MWST je Position, Total centgenau abgeglichen
  3. POST /documents/{id}/finalize fortlaufende Nummer, ab jetzt unveränderlich
  4. POST /documents/{id}/send Mail mit PDF und QR-Zahlteil
  5. POST /documents/{id}/payments Zahlung erfasst — die Verwaltung gibt den Versand frei
Architektur: Shop und Team arbeiten in der eigenen Verwaltung; die spricht brandbill über REST, Druck und eingebettete Oberflächen an; heraus kommen Belege für die Kundschaft. Bestellung, Miete, Im Team, Briefe & Mails.
  • CHF und MWST
  • QR-Rechnung
  • Total centgenau abgeglichen
  • Schlüssel bleibt auf dem Server
  • Gleiche API für jedes System

Aus Systemsicht: drei Bausteine, einzeln oder zusammen

/api/v1 · REST & MCP

brandbill führt die Belege

Kunden, Angebote, Rechnungen, Zahlungen, Verträge. Nummernkreis, Status und Archiv liegen bei brandbill; dein System ruft nur auf.

POST /api/v1/render

Dein System führt, brandbill druckt

Du behältst Nummern und Buchhaltung, schickst Belegdaten samt Summen und bekommst das PDF in deiner Vorlage zurück. Gespeichert wird nichts.

POST /api/v1/embed/session

Die Oberfläche als Baustein

brandbill-Bildschirme direkt in deiner Anwendung, mit kurzlebigem Token statt eigenem Login. Dein Team bleibt in einem Werkzeug.

Was dir hilft

01

Du wählst, wo Belege liegen

Legst du Belege per API an, führt brandbill Nummernkreis, Status und Archiv — wie in der Oberfläche. Lässt du nur drucken, bleibt kein Beleg, kein Kunde, keine Nummer dauerhaft bei uns: Original, Aufbewahrung und Nummernkreis liegen bei dir, wir zählen nur die Drucke.

02

Summen geprüft

Du schickst deine Summen mit, brandbill rechnet nach. Weicht ein Cent ab, gibt es eine klare Fehlermeldung statt eines PDF — und auf Wunsch auch für IBAN und USt-IdNr.

03

Gestaltung ohne Code

Layout, Schriften, Logo und feste Texte entstehen im Editor, nicht im Quelltext. Eine neue Vorlage wirkt sofort in jedem Druck, ohne Deployment.

In jedem Konto dabei

  • Editor für Layout, Schriften und Farben — auch im kostenlosen Plan
  • E-Rechnung als ZUGFeRD und XRechnung, inkl. Leitweg-ID
  • Angebote, Rechnungen und Mahnungen im selben Look
  • Zahl-Code auf der Rechnung: Banking-App scannen, fertig
  • Export als ZIP für deine Steuerberatung
  • Server in Deutschland, keine Tracking-Cookies

Kleingedrucktes

Häufige Fragen

Frage stellen
01 Was speichert brandbill von meinen Belegen?

Das hängt vom Weg ab. Legst du Belege an (POST /api/v1/documents), speichert brandbill sie wie in der Oberfläche — mit Nummer, Status und Archiv. Beim reinen Druck (POST /api/v1/render) nichts vom Inhalt: Gezählt wird, wie viele PDFs je Tag und Schlüssel geliefert wurden; damit ein erneuter Druck derselben Nummer nicht doppelt zählt, bleibt nur ein Prüfwert (HMAC) — nicht die Nummer selbst. Kommt dieselbe Anfrage gleich noch einmal, beantworten wir sie aus einem verschlüsselten Zwischenspeicher, der nach 15 Minuten gelöscht ist.

02 Zählen Drucke zum Kontingent meines Tarifs?

Ja, endgültige Angebote und Rechnungen zählen wie in der Oberfläche angelegte Belege. Vorschauen, Rechnungskorrekturen, Stornos und Mahnungen zählen nie. Die REST-API ist ab dem Tarif Frühstück enthalten.

03 Gehen auch Teil- und Schlussrechnungen?

Ja, sie sind Rechnungen mit eigener Nummer. Den Leistungsstand schreibst du in die Position («Leistungsstand 60 % (bisher berechnet 30 %)»), den Betreff nach subject («2. Teilrechnung — Website») und den Bezug auf frühere Rechnungen in intro_text. Die Schlussrechnung zieht bereits Berechnetes als negative Position ab — brandbill prüft die Summen wie bei jeder Rechnung.

04 Und die E-Rechnung?

Führt brandbill die Belege, entsteht die E-Rechnung samt XML bei brandbill. Beim reinen Druck kommt das XML aus deinem System, weil dort die Daten liegen: Du bettest es in das gelieferte PDF ein (ZUGFeRD), brandbill druckt das Layout dazu.

05 Was passiert, wenn der Druck ausfällt?

Der Aufruf antwortet mit 503 und einem Retry-After. Eine Vorlage, die nicht druckt, fällt nie still auf ein anderes Layout zurück — dein Archiv bleibt einheitlich.

Deine nächste Rechnung sieht nach dir aus.

Konto anlegen, Logo hochladen, loslegen. Kostenlos, ohne Kreditkarte.

brandbill ist auch für Selbständige · Freelancer · Designer · Architekten · Fotografen.

Kontakt

Frage, Demo oder On-Premise? Schreiben Sie uns – wir antworten in der Regel innerhalb eines Werktags.

Ihre Angaben verwenden wir nur, um Ihre Anfrage zu beantworten. Mehr in der Datenschutzerklärung.