Schweizer QR-Rechnungs-PDFs: Umbenennen nach Gläubiger, Betrag oder Referenz in n8n!
Sie erhalten PDFs, Rechnungen und Zahlungsbelege, jeweils mit einem Schweizer QR-Code, der Informationen zu Zahler, Betrag und Referenznummer enthält. Sie möchten diese Dateien anhand dieser Daten umbenennen, um sie schnell finden und sortieren zu können. Eine manuelle Vorgehensweise ist nicht praktikabel.
Die Lösung: ein n8n-Workflow, der Downloads das PDF, verwendet Schweizer QR-Code lesen (PDF4me) um diese strukturierten Zahlungsdaten zu extrahieren, Fusionen es mit der Datei, und Uploads Benennen Sie die Datei neu, beispielsweise nach Gläubiger, Betrag, Referenz oder was auch immer Sie benötigen. Dieselbe Datei, ein aussagekräftigerer Dateiname, keine manuelle Umbenennung erforderlich.
Diese Anleitung führt Sie durch den gesamten Ablauf: Laden Sie die PDF-Datei herunter, lesen Sie den Schweizer QR-Code ein und fügen Sie die Datei anschließend mit einem Dateinamen hoch, der sich aus den für Sie relevanten Daten zusammensetzt, z. B. Name und Ort des Gläubigers, Betrag und Referenz oder Angaben zum Schuldner.
Der Flow auf einen Blick
Ihr n8n-Workflow für Umbenennung von PDFs durch Schweizer QR-Daten Sieht so aus:
- Auslösen: Manuell zum Testen oder automatisiert (z. B. Dropbox, E-Mail, Webhook), wenn eine neue PDF-Datei verfügbar ist.
- Datei herunterladenRuft die PDF-Datei aus Ihrer Quelle (z. B. Dropbox) ab und gibt sie als Binärdatei in einem Feld wie z. B. aus
documentDie - Schweizer QR-Code lesen (PDF4me): Extrahiert Daten von Schweizer QR-Belegen aus der PDF-Datei und gibt strukturierte Daten aus (
swissQrDataGläubigercr_Name,cr_City,cr_Country, Schuldnerud_Name,Amount,Currency,Referenceusw.). Die Original-PDF-Datei verbleibt auf dem Download-Knoten. - Verschmelzen: Kombiniert die Ausgabe von "Read Swiss QR Code" (Schweizer QR-Daten) und die Ausgabe von "Download" (PDF-Binärdatei) zu einem Element, sodass der nächste Knoten sowohl den neuen Dateinamen als auch den Dateiinhalt enthält.
- Laden Sie eine Datei hoch: Speichert die PDF-Datei unter dem Pfad/Dateinamen, der auf die von Ihnen ausgewählten Schweizer QR-Felder eingestellt ist (z.B.
Test AG_Zurich_Switzerland.pdfoder1000_CHF_REF123.pdf).
Immer dieselbe Datei, nur ein neuer Name. Im Folgenden gehen wir auf jeden einzelnen Schritt detailliert ein.
Schritt 1: Datei herunterladen und den Schweizer QR-Code lesen
Laden Sie die PDF-Datei in n8n und Den Namenswert extrahieren Mit PDF4me Schweizer QR-Code lesen. Die Datei kann stammen von Datei herunterladen (z.B. Dropbox), Google Drive, E-Mail oder ein beliebiger Knoten, der Ausgaben erzeugt binärDie
Bisheriger Ablauf: Auslöser → Datei herunterladen → Schweizer QR-Code lesen.
Wichtig: Das Lesen eines Schweizer QR-Codes liefert die Zahlungsdaten (in swissQrDataDie Datei wird nicht durch das PDF übertragen. Der Dateiinhalt verbleibt im Download-Knoten. In Schritt 2 werden beide zusammengeführt, sodass der Upload-Knoten die Datei und den neuen Namen enthält.
- Füge einen Auslöser hinzu: Manuell für Testzwecke; für den Produktivbetrieb einen automatisierten Auslöser verwenden (z. B. Dropbox, E-Mail, Google Drive, Webhook).
- Datei hinzufügen/herunterladen (z. B. Dropbox): Festlegen Dateipfad zu Ihrem PDF-Speicherort (z.B.
/Blog Data/Read Swiss QR.pdf) Und Ausgabedatei im Feld speichern ZudocumentDie PDF-Datei steht den nächsten Knoten also als Binärdatei zur Verfügung. - Füge einen PDF4me-Knoten hinzu → Barcode → Schweizer QR-Code lesenDie
- Konfigurieren Sie den Knoten „Schweizer QR-Code lesen“:
- Anmeldeinformationen für die Verbindung: Ihr PDF4me-Konto.
- Ressource: Barcode → Barcode-Operationen: Schweizer QR-Code lesen.
- Eingabedatentyp: Binärdaten.
- Binäres Eingabefeld:
document(dasselbe wie das Ausgabefeld des Download-Knotens). - Name der Ausgabedatei: z.B.
swissqr_code_data.jsonDie - Asynchron: Bei Bedarf für größere PDFs aktivieren.
- Führe den Knoten aus. Die Ausgabe umfasst Erfolg, docName, Und swissQrData mit Gläubiger (
cr_Name,cr_City,cr_Country), Schuldner (ud_Name, usw.), Menge, Währung, Referenz, IBANund mehr. Sie verwenden diese Felder für den Dateinamen im Upload-Schritt.
Vollständige Parameterübersicht: Schweizer QR-Code lesen (n8n)Die
Schritt 2: Zusammenführen und mit dem neuen Namen hochladen
Du brauchst beides PDF binär (aus dem Download) und die Schweizer QR-Daten (von „Read Swiss QR Code“) in einem Element, damit der Upload-Knoten die Datei unter dem neuen Namen speichern kann. Verschmelzen Der Knoten kombiniert sie; der Hochladen Der Knoten verwendet dann die Schweizer QR-Felder als Pfad oder Dateinamen.
- Füge einen Merge-Knoten hinzu
- Modus: Kombinieren.
- Kombinieren durch: Position (erstes Element aus Eingabe 1 zusammen mit dem ersten Element aus Eingabe 2).
- Anzahl der Eingänge: 2.
- Eingabe 1: Verbinden Sie sich von Schweizer QR-Code lesen (stellt bereit)
swissQrData). - Eingabe 2: Verbinden Sie sich von Datei herunterladen (stellt bereit)
binary.document). - Ausgabe: Ein zusammengeführtes Element mit sowohl dem Schweizer QR-JSON als auch
binary.documentDer nächste Knoten enthält also den neuen Dateinamen und den Dateiinhalt.
- Füge einen Upload-Knoten hinzu (z. B. Dropbox) Laden Sie eine Datei hochoder jeder Knoten, der Binär- und Pfadinformationen akzeptiert)
- Dateipfad (Ausdruck): Verwenden Sie die Ausgabe „Schweizer QR-Code lesen“. Sie können den Knoten über seinen Namen referenzieren:
$('Read SwissQR code').item.json.swissQrDataDie - Binärdatei: AN.
- Binäres Eingabefeld:
documentDie - Die Datei wird unter dem vom Schweizer QR-Code abgeleiteten Namen hochgeladen; der PDF-Inhalt bleibt unverändert.
- Creditor (Name_City_Country)
- Debtor name
- Amount and reference
Verwenden Sie den Namen des Gläubigers, den Ort und das Land für den Dateinamen (z.B. Test AG_Zurich_Switzerland.pdf):
/Blog Data/{{ $('Read SwissQR code').item.json.swissQrData.cr_Name }}_{{ $('Read SwissQR code').item.json.swissQrData.cr_City }}_{{ $('Read SwissQR code').item.json.swissQrData.cr_Country }}.pdf
Wird aufgelöst zu: /Blog Data/Test AG_Zurich_Switzerland.pdf
Verwenden Sie den Namen des endgültigen Schuldners:
/Blog Data/{{ $('Read SwissQR code').item.json.swissQrData.ud_Name }}.pdf
Oder mit Stadt: {{ $('Read SwissQR code').item.json.swissQrData.ud_Name }}_{{ $('Read SwissQR code').item.json.swissQrData.ud_City }}.pdf
Verwenden Sie Betrag, Währung und Referenz für die zahlungsbasierte Namensgebung:
/Blog Data/{{ $('Read SwissQR code').item.json.swissQrData.Amount }}_{{ $('Read SwissQR code').item.json.swissQrData.Currency }}_{{ $('Read SwissQR code').item.json.swissQrData.Reference || 'no-ref' }}.pdf
Das gleiche Merge + Upload-Muster funktioniert mit Google Drive, E-Mail oder jedem Speichermedium, das Binärdaten und einen dynamischen Pfad akzeptiert. Tipp: Für Dropbox aktivieren lesen Und schreiben im Dropbox App-Konsole (Berechtigungen → Dateien und Ordner): z. B. Leseberechtigung für Downloads files.content.write Für Uploads und verwenden Sie nach der Änderung der Berechtigungen ein neues Zugriffstoken.
Verstanden: Wenn Upload eine fehlende Binärdatei meldet, stellen Sie sicher, dass Merge ausgeführt wird. Eingang 2 ist von Datei herunterladen, nicht von Read Swiss QR Code.
Warum das funktioniert
Wichtigste Punkte
- AuslösenVerwenden Sie einen manuellen Auslöser zum Testen oder einen automatisierten Auslöser (Dropbox, E-Mail, Webhook), damit der Workflow immer dann ausgeführt wird, wenn eine neue PDF-Datei verfügbar ist.
- Schweizer QR-Code lesen extrahiert Daten von Schweizer QR-Banknoten und gibt diese aus.
swissQrData(Gläubiger)cr_*, Schuldneraus_*,Menge,Währung,Referenzusw.). Die Datei wird nicht durch das PDF weitergeleitet; sie verbleibt auf dem Download-Knoten. - Verschmelzen (Kombinieren nach Position) Paare: Schweizer QR-Code-Ausgabe lesen und herunterladen, sodass der nächste Knoten ein Element mit beiden empfängt
binary.documentUndswissQrDataDie - Hochladen verwendet einen Ausdruck wie
$('Read SwissQR code').item.json.swissQrData.cr_Name(Undcr_City,cr_Country, oder andere Felder) für den Pfad/Dateinamen undbinary.documentfür den Inhalt, daher wird jede Datei von Swiss QR data umbenannt.
Realwelt-Szenarien
Szenario 1: Rechnungen vom Gläubiger umbenannt
Problem: Eingehende Rechnungen im PDF-Format haben generische Namen; Sie müssen sie nach Lieferant (Gläubiger) und Standort suchen.
Lösung: Umbenennung nach Gläubigername, Stadt und Land (z.B. Test AG_Zurich_Switzerland.pdfJede Datei ist nach demjenigen durchsuchbar, der die Rechnung gestellt hat.
Felder extrahieren: cr_Name, cr_City, cr_Country
Auslösen: Dropbox-Ordner, E-Mail-Anhang oder Webhook
Szenario 2: Zahlungsbelege nach Betrag und Referenz
Problem: Die Zahlungsbelege im PDF-Format müssen zur Abstimmung nach Betrag und Zahlungsreferenz abgelegt werden.
Lösung: Umbenennen nach Betrag, Währung und Bezugszeichen (z.B. 1000_CHF_210000000003139471430009017.pdf). Dokumente den Banktransaktionen zuordnen.
Felder extrahieren: Amount, Currency, Reference
Auslösen: Dropbox, E-Mail, Webhook
Szenario 3: Schuldnerbasierte Anmeldung
Problem: Für die Buchhaltung müssen Sie die PDFs nach Kunden (endgültigem Schuldner) gruppieren.
Lösung: Umbenennung nach Schuldnernamen (z.B. Test Debt AG.pdf) oder Schuldnername + Ort. Direkte Zuordnung zu Kundendatensätzen.
Felder extrahieren: ud_Name, ud_City
Auslösen: E-Mail, freigegebener Ordner, Webhook
Häufig gestellte Fragen
- Was passiert, wenn kein Schweizer QR-Code gefunden wird? Verwenden Sie einen Fallback im Dateipfadausdruck, z.B.
{{ $('Read SwissQR code').item.json.swissQrData?.cr_Name || 'no-qr-found' }}Sie können eine bedingte Verzweigung hinzufügen, um den Upload zu überspringen oder diese Dateien in einen separaten Ordner zu verschieben. - Kann ich Gläubiger und Betrag zusammen verwenden? Ja. Beispiel:
{{ $('Read SwissQR code').item.json.swissQrData.cr_Name }}_{{ $('Read SwissQR code').item.json.swissQrData.Amount }}_{{ $('Read SwissQR code').item.json.swissQrData.Currency }}.pdfDie - Kann ich das für Google Drive oder E-Mail verwenden? Ja. Gleiches Muster: Verwenden Sie einen beliebigen Knoten, der Ihnen die Datei als Binärdatei liefert, und einen beliebigen Upload- (oder Speicher-)Knoten, der Binärdateien plus einen dynamischen Pfad akzeptiert.
Nächste Schritte
Rekapitulieren: Auslöser → Datei herunterladen → Schweizer QR-Code lesen → Zusammenführen → Hochladen. Der Dateiname setzt sich zusammen aus swissQrData (z. B. Name des Gläubigers, Ort, Land oder Betrag/Referenz). Jede PDF-Datei wird unter dem Namen der extrahierten Schweizer QR-Code-Daten gespeichert.
- Holen Sie sich Ihren API-SchlüsselVerwenden Sie für n8n dasselbe PDF4me-Konto. Kostenlos zum Starten.
- Erstelle deinen n8n-Flow: Auslöser → Datei herunterladen → Schweizer QR-Code lesen → Zusammenführen → Hochladen mit dem Dateipfad, der auf den benötigten Schweizer QR-Code-Ausdruck eingestellt ist.
- Lesen Sie die vollständigen Dokumente.: Schweizer QR-Code lesen (n8n)Die
- Probieren Sie die API aus.: Testen Sie den Read Swiss QR Code-Endpunkt mit Ihrer eigenen PDF-Datei im API-Tester.