MaxRechnung mit n8n verbinden
Vier n8n-Bausteine gegen die REST-API: Kunde anlegen, Rechnung anlegen und festschreiben, alle bezahlten Beträge aufsummieren, überfällige Rechnungen herausfiltern.
10 Min. LesezeitStand 13. Oktober 2026
Voraussetzungen: Business-Tarif (öffentliche API), eine n8n-Instanz (Cloud oder self-hosted)
Inhalt
n8n ruft die öffentliche REST-API von MaxRechnung (/api/v1,
Business-Tarif) mit dem HTTP-Request-Node auf: kein eigener Code, keine
eigene Server-Anwendung. Diese Anleitung zeigt vier Bausteine, die du einzeln
oder kombiniert nutzt:
- Kunde anlegen (
POST /customers) - Rechnung anlegen und festschreiben (
POST /invoices+PATCH /invoices/{id}/status) - Alle bezahlten Beträge abrufen (
GET /payments, paginiert, aufsummiert) - Überfällige Rechnungen abrufen (
GET /invoices, paginiert, gefiltert)
Voraussetzungen
- Business-Tarif in MaxRechnung (schaltet die öffentliche API frei). Verlässt das Konto den Business-Tarif, werden alle API-Keys widerrufen. Nach einem erneuten Wechsel zu Business legst du einen neuen Key an und trägst ihn in der Credential ein.
- Ein API-Key: Einstellungen, Reiter API, Namen eintragen, Scopes
anhaken, Key erstellen. Der Key (
mxr_live_…) wird einmalig angezeigt. - Deine Absenderdaten unter Absender: die API übernimmt sie in jede Rechnung.
- n8n (Cloud oder self-hosted), Version mit dem HTTP-Request-Node v4+ (Pagination-Optionen).
Nötige Scopes am Key:
| Baustein | Scope |
|---|---|
| Kunde anlegen | customers:write |
| Kunde lesen | customers:read |
| Rechnung anlegen + festschreiben | invoices:write |
| Zahlungen / Rechnungen lesen | invoices:read |
Zugangsdaten in n8n hinterlegen
Einmal eine Credential anlegen, dann in jedem HTTP-Request-Node auswählen:
- Credentials → New → „Header Auth"
- Name:
Authorization - Value:
Bearer mxr_live_…
Basis-URL für alle Aufrufe: https://maxrechnung.de/api/v1. Fehlerantworten sind
immer JSON: { "error": { "code", "message", "details"? } }.
Baustein 1: Kunde anlegen
HTTP Request Node:
| Feld | Wert |
|---|---|
| Method | POST |
| URL | https://maxrechnung.de/api/v1/customers |
| Authentication | Generic Credential Type → Header Auth (oben) |
| Send Headers | Idempotency-Key = ={{ $json.email }} (verhindert Doppelanlage bei einem erneuten Lauf) |
| Send Body | JSON |
Body (JSON):
{
"name": "{{ $json.name }}",
"address": "{{ $json.street }}\n{{ $json.zip }} {{ $json.city }}",
"country": "DE",
"email": "{{ $json.email }}",
"vat_id": "{{ $json.vat_id }}"
}
Antwort: 201 mit dem Kundenobjekt inkl. id. Diese id ist im nächsten Node
als ={{ $json.id }} verfügbar; sie ist aber nicht Pflicht, um eine
Rechnung zu schreiben (der Empfänger steht auch inline in der Rechnung).
Baustein 2: Rechnung anlegen und festschreiben
Zwei HTTP-Request-Nodes hintereinander.
2a: Entwurf anlegen
| Feld | Wert |
|---|---|
| Method | POST |
| URL | https://maxrechnung.de/api/v1/invoices |
| Headers | Idempotency-Key = ein stabiler Schlüssel je Vorgang, z. B. ={{ $json.order_id }} |
| Body | JSON (siehe unten) |
{
"invoice_date": "{{ $now.toFormat('yyyy-MM-dd') }}",
"service_date": "{{ $now.toFormat('yyyy-MM-dd') }}",
"payment_term_days": 14,
"price_mode": "net",
"recipient": {
"name": "{{ $json.customer_name }}",
"address": "{{ $json.customer_address }}",
"email": "{{ $json.customer_email }}"
},
"line_items": [
{
"description": "{{ $json.item_description }}",
"quantity": {{ $json.quantity }},
"unit_price": {{ $json.unit_price }},
"vat_rate": 19
}
],
"notes": ""
}
price_mode:net(Positionspreise netto) odergross(brutto).vat_rateje Position:19,7oder0; musst du selbst setzen.quantityundunit_pricesind Zahlen, ohne Anführungszeichen. Ein String endet mit422.numberfehlt mit Absicht: MaxRechnung vergibt die nächste Nummer im KreisRE-<Jahr>-<laufende Nummer>, zum BeispielRE-2026-0124. Führst du ein anderes Schema, gibnumbermit und halte den Zähler in n8n (z. B. per Node „Postgres"/„Airtable"/„n8n Data table"); eine schon vergebene Nummer lehnt die API mit409 conflictab.senderfehlt ebenfalls: Name, Anschrift, Steuernummer und Bankverbindung kommen aus Absender in deinem Konto. Felder, die du mitschickst, haben Vorrang.
Antwort: 201 mit dem Rechnungsobjekt inkl. id, number und totals.
2b: Festschreiben
| Feld | Wert |
|---|---|
| Method | PATCH |
| URL | https://maxrechnung.de/api/v1/invoices/{{ $json.id }}/status |
| Body | JSON: { "status": "sent" } |
draft → sent durchläuft den § 14-Vollständigkeitscheck. 422 in der Antwort = ein
Pflichtfeld fehlt, details[] nennt es. Danach ist der Beleg unveränderlich
(Korrektur: POST /invoices/{id}/corrections).
Baustein 3: Alle bezahlten Beträge abrufen
GET /payments liefert die erfassten Zahlungseingänge, neueste zuerst,
seitenweise (limit max. 100, offset, has_more). Jede Seite ist ein Objekt
mit den Zahlungen im Feld data.
HTTP Request Node:
| Feld | Wert |
|---|---|
| Method | GET |
| URL | https://maxrechnung.de/api/v1/payments |
| Query Parameters | limit = 100 |
| Options → Pagination | Mode: Update a Parameter in Each Request · Type: Query · Name: offset · Value: ={{ $pageCount * 100 }} · Complete when: ={{ $response.body.has_more === false }} |
Der Node holt damit alle Seiten. Summe bilden mit einem Code-Node:
// je Seite ein Item: die Zahlungen stehen in data
const rows = $input
.all()
.flatMap(i => i.json.data ?? [i.json])
.filter(p => !p.voided_at); // stornierte Zahlungseingänge zählen nicht
const total = rows.reduce((s, p) => s + Number(p.amount), 0);
// optional: nur ein Zeitraum
// const inRange = rows.filter((p) => p.paid_on >= "2026-01-01" && p.paid_on <= "2026-12-31");
return [{ json: { count: rows.length, total_paid: Math.round(total * 100) / 100 } }];
Stornierte Zahlungseingänge bleiben in der Liste und tragen einen Zeitstempel
in voided_at; deshalb der Filter.
Alternativ ohne Code: Node Split Out auf Feld data, ein Filter auf
leeres voided_at, dann Summarize → Aggregate sum auf Feld amount.
Jede Zahlung trägt amount, paid_on, invoice_id, note und voided_at; für
„bezahlte Beträge je Rechnung" nach invoice_id gruppieren (Summarize →
Fields to Split By). Nur die Zahlungen einer Rechnung liefert der
Query-Parameter invoice_id.
Baustein 4: Überfällige Rechnungen abrufen
Es gibt keinen fertigen „overdue"-Filter; hol die Rechnungen und filtere über
status, due_date und amount_open.
HTTP Request Node:
| Feld | Wert |
|---|---|
| Method | GET |
| URL | https://maxrechnung.de/api/v1/invoices |
| Query Parameters | limit = 100 · type = invoice |
| Options → Pagination | wie in Baustein 3 (offset = ={{ $pageCount * 100 }}, complete ={{ $response.body.has_more === false }}) |
Offen sind zwei Status: sent (festgeschrieben, noch nichts bezahlt) und
partial (Teilzahlung erfasst). Der Query-Parameter status nimmt nur einen
Wert, deshalb filtert der Code-Node:
const today = $now.toFormat("yyyy-MM-dd");
const overdue = $input
.all()
.flatMap(i => i.json.data ?? [i.json])
.filter(inv => ["sent", "partial"].includes(inv.status))
.filter(inv => inv.due_date && inv.due_date < today && Number(inv.amount_open) > 0)
.map(inv => ({
number: inv.number,
recipient: inv.recipient.name,
due_date: inv.due_date,
amount_open: inv.amount_open,
days_overdue: Math.floor((Date.now() - Date.parse(inv.due_date)) / 86400000),
}));
return overdue.map(json => ({ json }));
Ohne Code: Node Split Out auf Feld data, dann ein Filter mit drei
Bedingungen: ={{ $json.status }} ist sent oder partial,
={{ $json.due_date }} is before ={{ $today }} und
={{ Number($json.amount_open) }} larger 0.
Häng einen Schedule Trigger (täglich) davor und ein Send Email / Slack dahinter, fertig ist die tägliche Mahnliste.
Idempotenz, Rate-Limit, Fehler
- Anlegen (
POST): setz einenIdempotency-Key-Header mit einem pro Vorgang stabilen Wert (Bestell-ID, E-Mail). Ein wiederholter Lauf legt dann nichts doppelt an; MaxRechnung spielt die erste Antwort 24 h zurück. Der Wert gilt je Endpunkt und Body: Derselbe Key an einem anderen Endpunkt endet mit409.PATCHkennt keinen Idempotency-Key; ein zweitessentauf eine festgeschriebene, noch offene Rechnung antwortet mit200. - Rate-Limit: 120 Requests/Minute je Key. Bei Massenläufen im HTTP-Node
Options → Batching (z. B. 50 pro Intervall) setzen. Bei
429steht die Wartezeit im HeaderRetry-After. - Fehler: Settings → Continue On Fail am Node, danach prüfen:
={{ $json.error?.code }}(validation_failed→ Body korrigieren, nicht wiederholen;conflict→ z. B. Nummer schon vergeben).
Vollständige Endpunkt- und Feldreferenz: /developers/api. Dort steht zu jedem Endpunkt ein fertiger curl-Aufruf; den übernimmt der HTTP-Request-Node über Import cURL. Die OpenAPI-Spezifikation liegt unter /api/openapi.json.
Weitere Anleitungen
MaxRechnung an Stripe anbinden
Aus jeder bezahlten Stripe-Transaktion automatisch eine festgeschriebene MaxRechnung-Rechnung erzeugen, mit API-Key, Scopes, Idempotency und signierten Webhooks in beide Richtungen.
12 Min.
Stripe ohne eigenen Server anbinden (Zapier / Make)
Stripe-Zahlungen ohne selbst betriebene Anwendung in MaxRechnung-Rechnungen verwandeln, über eine No-Code-Automation als Bindeglied. Was dabei wirklich „direkt“ geht und wo die Grenzen liegen.
9 Min.
Die erste Rechnung in unter einer Minute
Absender, Empfänger, Position, Steuer: Schritt für Schritt zur fertigen Rechnung als PDF, ganz ohne Konto. Und wie du sie danach mit kostenlosem Konto als Entwurf speicherst.
4 Min.