n8n-nodes-rechnungswandler

n8n-Community-Baustein von rechnungswandler.de:
„rechnungswandler.de – ZUGFeRD-Anhänge zusammenführen" fügt eine
ZUGFeRD-/Factur-X-E-Rechnung und ihre Anhänge (PDF, PNG, JPG) zu einer
einzigen Datei zusammen – wie Papier, das zusammengetackert wird:

• Die Original-Rechnungsseiten bleiben unverändert vorn.
• Jeder Anhang wird als sichtbare Seiten dahinter angefügt (PDF-Anhänge
  seitenweise in Originalqualität, Bilder als A4-Seite).
• Jeder Anhang wird zusätzlich als Datei in die PDF eingebettet
  (PDF/A-3-Container), sodass er maschinell wieder entnehmbar ist.

Typischer Einsatz: Dein Rechnungsprogramm (z. B. Lexware Office) erzeugt die
E-Rechnung, kann aber Stundenzettel, Lieferscheine oder Fotos nicht mit in
die Datei aufnehmen. Dieser Baustein erledigt genau das – automatisch, in
deinem n8n.

Datenschutz: Deine Rechnungen bleiben bei dir

Das Zusammenführen läuft vollständig in deiner eigenen n8n-Installation.
Deine Rechnungen und Anhänge werden niemals an rechnungswandler.de oder
irgendeinen anderen Server übertragen. Die einzige Verbindung zu unserem
Server ist die Prüfung deines Schnittstellen-Schlüssels (gehört zu deinem
Pro-Konto) – dabei wird ausschließlich der Schlüssel übermittelt, nie
Rechnungsdaten. Ist rechnungswandler.de einmal nicht erreichbar, bricht der
Baustein mit einer klaren Meldung ab; es werden auch dann keine Daten
übertragen.

Voraussetzungen

• Ein aktives rechnungswandler.de Pro-Konto (Abo oder 24-Stunden-Pass) –
  der Baustein ist im normalen Pro-Zugang enthalten, ohne Aufpreis.
• Eine eigene n8n-Installation (self-hosted), die Community Nodes erlaubt.

Installation

1. In n8n als Administrator anmelden.
2. Settings → Community Nodes → Install öffnen.
3. Paketname eingeben: n8n-nodes-rechnungswandler
4. Risiko-Hinweis bestätigen und installieren.

Einrichtung (Schlüssel)

1. Auf rechnungswandler.de mit deinem
   Pro-Konto anmelden → Seite Konto → Abschnitt
   „Schnittstellen-Schlüssel (n8n)" → Schlüssel erzeugen.
2. Den angezeigten Schlüssel (rw_live_…) sofort kopieren – er wird aus
   Sicherheitsgründen nur ein einziges Mal angezeigt.
3. In n8n beim Baustein neue Zugangsdaten vom Typ
   „rechnungswandler.de API" anlegen und den Schlüssel eintragen. Der
   eingebaute Verbindungstest prüft ihn sofort.

Geht der Schlüssel verloren oder soll er ungültig werden: einfach auf der
Konto-Seite einen neuen erzeugen (der alte wird sofort ungültig) oder den
Schlüssel widerrufen.

Beispiel-Workflow: Lexware Office → Zusammenführen → Ablage

1. Auslöser (z. B. „täglich 18 Uhr" oder ein Webhook).
2. HTTP Request: neue Rechnung als ZUGFeRD-PDF aus der Lexware Office
   API herunterladen (GET /v1/invoices/{id}/document mit
   Accept: application/pdf, Binär-Antwort z. B. in das Feld data).
3. HTTP Request / Read Binary Files: die zugehörigen Anhänge laden
   (z. B. Stundenzettel-PDF, Baustellenfoto) und als weitere Binär-Felder
   (anhang1, anhang2, …) an denselben Eintrag hängen (z. B. mit dem
   Merge-Node im Modus „Combine").
4. rechnungswandler.de – ZUGFeRD-Anhänge zusammenführen:
   • Rechnung (Binär-Feld): data
   • Anhänge (Binär-Felder): leer lassen (= alle anderen Binär-Felder)
     oder gezielt anhang1,anhang2
   • Ausgabe (Binär-Feld): data
5. Ablage: die fertige Datei per E-Mail versenden, in eine Cloud laden
   oder lokal speichern.

Der Baustein liefert im json-Teil jedes Eintrags eine kleine Statistik
(rechnungswandler.rechnungSeiten, .anhangSeiten,
.eingebetteteDateien), mit der du in Folge-Bausteinen prüfen kannst, ob
alles dabei ist.

Grenzen (bewusst identisch zum Web-Werkzeug)

• Anhänge: nur PDF, PNG, JPG (Dateityp wird an Endung/MIME erkannt).
• Höchstens 5 MB je Anhang, 10 MB Anhänge insgesamt je Rechnung.
• Höchstens 20 sichtbare Anhang-Seiten insgesamt.
• Die Eingabe muss eine echte ZUGFeRD-/Factur-X-PDF sein (eingebettete
  Rechnungsdaten wie factur-x.xml vorhanden). Reine „Bild-PDFs" ohne
  Rechnungsdaten werden mit einer klaren Meldung abgelehnt.
• Alle Fehlermeldungen sind deutsch und sagen dir konkret, was zu tun ist.

Was der Baustein garantiert NICHT anfasst (ehrliche Grenzen)

Der Baustein verändert nie das Innere der Rechnung: Die eingebetteten
Rechnungsdaten (factur-x.xml), die XMP-Metadaten und die
Dokument-Eigenschaften bleiben byte-identisch erhalten – das ist durch
automatische Tests abgesichert. Daraus folgen zwei ehrliche Einschränkungen:

1. Keine BG-24-Verweise im XML: Die Anhänge sind sichtbar angefügt und
   als Dateien in der PDF eingebettet, werden aber nicht zusätzlich im
   Rechnungs-XML (BG-24 „rechnungsbegleitende Unterlagen") eingetragen –
   das würde ein Umschreiben der fremden Rechnungsdaten bedeuten. Für
   Empfänger, die nur das XML maschinell auswerten, sind die Anhänge daher
   nicht im XML verzeichnet (in der PDF selbst aber vollständig enthalten).
2. PDF/A-Konformität bei exotischen Anhängen: Seiten aus PDF-Anhängen
   werden originalgetreu übernommen. Stammt ein Anhang aus einer Quelle,
   die selbst kein sauberes PDF erzeugt (z. B. Schriften nicht eingebettet),
   kann die strenge PDF/A-3-Konformität der Gesamtdatei theoretisch leiden.
   Unsere Testfälle mit typischen Rechnungs- und Anhang-PDFs bestehen die
   offizielle Validierung (Mustangproject: PDF/A-3b, isCompliant=true);
   im Zweifel prüfe deine Kombination einmal mit dem kostenlosen
   Prüf-Werkzeug auf rechnungswandler.de.

Fehlermeldungen zur Schlüssel-Prüfung

• „… Schlüssel ist ungültig oder dein Pro-Zugang ist abgelaufen":
  Auf rechnungswandler.de → Konto einen neuen Schlüssel erzeugen bzw. Pro
  verlängern.
• „Die Schlüssel-Prüfung … ist gerade nicht erreichbar": Unser Server ist
  kurzzeitig nicht erreichbar; der Lauf bricht ab, es wurden keine Daten
  übertragen. Einfach später erneut ausführen. (Innerhalb von 10 Minuten
  nach einer erfolgreichen Prüfung läuft der Baustein ohne erneute
  Server-Anfrage weiter.)

Lizenz

MIT