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.
Nur drucken: so läuft die Anbindung
Drei Schritte vom eigenen System zum fertigen PDF.
-
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.
-
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.
-
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.
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.
- CHF und MWST
- QR-Rechnung
- Total centgenau abgeglichen
- Schlüssel bleibt auf dem Server
- Gleiche API für jedes System
Alles bleibt in der eigenen Software. Nur das Layout kommt von brandbill.
Projekte, Zeiten, Nummernkreis, Zahlungen und DATEV bleiben, wo sie sind. Ein eigenes PDF-Layout hat die Software nicht mehr: Jedes Angebot, jede Rechnung, Mahnung und jeder Bericht geht an den Druckdienst und kommt in der Vorlage aus dem Editor zurück.
- Kein eigenes PDF-Layout mehr in der Software
- Nummer erst nach erfolgreichem Druck
- Summen, IBAN und USt-IdNr. geprüft
- Druck speichert nichts bei brandbill
- E-Rechnung bleibt im eigenen 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
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.
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.
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
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.