Rechnungswerk
Buchhaltung, Team und API

REST-API: E-Rechnungen aus dem eigenen System erzeugen

Kurz gesagt

Über die REST-API liefern Sie eine Rechnung als JSON ein. Rechnungswerk vergibt die Nummer, erzeugt ZUGFeRD-PDF und XRechnung, prüft beide und versendet sie auf Wunsch per E-Mail. API-Schlüssel haben abgestufte Rechte; ein Idempotency-Key verhindert doppelte Rechnungen bei wiederholten Aufrufen.

So geht’s Häufige Fragen
POST /api/v1/submit
{
  "customer": {"name": "Beispielbau GmbH",
    "email": "buchhaltung@beispielbau.example"},
  "lines": [{"name": "Montage", "quantity": "12",
    "unit": "HUR", "price": "85.00", "vat": "19"}],
  "send": true
}
201 Created
{
  "invoice": {"number": "RE-2026-000053",
    "status": "issued", "gross": "1213.80"},
  "validation": {"internal_passed": true},
  "dispatch": {"status": "sent"}
}
Ein Aufruf mit Kunde und Positionen; zurück kommen Rechnungsnummer, Prüfergebnis und Versandstatus.
Format
JSON über HTTPS
Schlüssel
mit abgestuften Rechten
Wiederholung
Idempotency-Key
Doku
öffentlich

Ein Aufruf, eine fertige E-Rechnung

Der Endpunkt zum Einliefern nimmt Kunde und Positionen entgegen, legt den Kunden bei Bedarf an, stellt die Rechnung aus und gibt Nummer, Prüfergebnis und Download-Adressen zurück.

Sicher wiederholen

Bricht die Verbindung ab, schicken Sie denselben Aufruf mit demselben Idempotency-Key erneut – die Rechnung entsteht nur einmal.

  1. POST /submit Idempotency-Key: auftrag-4711 Verbindung abgebrochen
  2. POST /submit Idempotency-Key: auftrag-4711 201 · RE-2026-000053
  3. POST /submit Idempotency-Key: auftrag-4711 dieselbe Antwort, keine zweite Rechnung
Wiederholte Aufrufe mit demselben Schlüssel erzeugen die Rechnung nur einmal.

So geht’s in vier Schritten

  1. Schlüssel anlegen

    Unter „API-Schlüssel“ mit den nötigen Rechten.

  2. Rechnung senden

    JSON mit Kunde und Positionen.

  3. Ergebnis lesen

    Nummer, Prüfung, Dateien.

  4. Versand anstoßen

    Per E-Mail, wenn gewünscht.

Häufige Fragen

Wo finde ich die Dokumentation?

Öffentlich unter /docs, mit Beispielen für jeden Aufruf.

Kann ich Rechnungen nur lesen?

Ja, mit einem Schlüssel, der nur Leserechte hat.

Gibt es Grenzen für Aufrufe?

Ja, eine Grenze je Minute; der Betreiber kann sie anpassen.

Stand: . Beschrieben ist Version 0.40.0.

Passend dazu

E-Rechnung erstellenEin Entwurf, zwei Formate: ZUGFeRD-PDF und XRechnung entstehen beim Ausstellen aus demselben Stand.Rollen und SteuerbüroSechs Rollen mit getrennten Rechten und ein eigenes Panel für Steuerbüros.

Rechnungswerk für Ihre Firma

Keine Selbstregistrierung: Der Betreiber richtet Ihre Firma mit einem ersten Administrator ein.

Anmelden