Google-Sheets-Anleitung

IBANs in Google Sheets mit Apps Script prüfen

Prüfen Sie eine ausgewählte IBAN-Spalte über ein Tabellenmenü und erhalten Sie einen separaten Bericht mit Zeitstempel, Prüfstatus, Bankname und BIC. Laden Sie die Vorlage herunter, hinterlegen Sie Ihren API-Token und starten Sie Prüfungen bei Bedarf.

Teststand des Beispiels: Der Download besteht 46 lokale Node.js-Tests mit simulierten Apps-Script-Diensten. Geprüft werden Duplikatbereinigung, Grenzen, Antwortbehandlung, Token-Speicherung, unterbrochene Schreibvorgänge und Formelmaskierung. Ein Test in einem echten Google-Sheets-Konto oder mit authentifizierter API wurde nicht durchgeführt. Beginnen Sie mit einer kleinen Testtabelle, bevor Sie betriebliche Daten verwenden.

Was diese Tabelle prüft

Die API prüft IBAN-Format und Prüfsumme und ergänzt verfügbare Bankverzeichnisdaten. Ein gültiges Ergebnis belegt weder Kontoinhaberschaft, Kontoexistenz, Zahlungsfähigkeit noch verfügbare Mittel. Den aktuellen Prüfumfang beschreibt die IBAN-Test-API-Dokumentation.

Die Vorlage verwendet einen ausdrücklichen Menübefehl unter IBAN-Test. Das Bearbeiten einer Zelle löst keine kostenpflichtige Anfrage aus. Jeder Durchlauf akzeptiert einen zusammenhängenden Bereich einer Spalte mit bis zu 500 Zeilen und höchstens 10 unterschiedlichen, nicht leeren IBANs. Dies sind Grenzen der Vorlage, nicht Ihres Kontotarifs.

Für Anfragen und Duplikaterkennung werden Leerzeichen entfernt und Buchstaben großgeschrieben. Die Originalzellen bleiben unverändert. Wiederholte IBANs teilen sich innerhalb eines Durchlaufs eine Anfrage, jede Quellzeile erscheint jedoch im Bericht. Leere Zellen werden übersprungen; Überschriften und Formeln müssen von der Auswahl ausgeschlossen werden.

1. Die Vorlage in einer Tabelle installieren

1. Erstellen Sie für den ersten Test eine private Google-Tabelle. Laden Sie die ZIP-Datei herunter und entpacken Sie sie.
2. Öffnen Sie in Google Sheets Erweiterungen → Apps Script. Ersetzen Sie den Standardinhalt von Code.gs durch die heruntergeladene Datei. Enthält das Projekt bereits benötigte Skripte, verwenden Sie für diese Einrichtung eine neue Tabelle.
3. Öffnen Sie in Apps Script die Projekteinstellungen und aktivieren Sie die Anzeige der Manifestdatei appsscript.json im Editor. Kehren Sie zum Editor zurück und ersetzen Sie diese Datei durch das mitgelieferte Manifest.
4. Speichern Sie das Projekt und laden Sie die Tabelle neu. Die Funktion onOpen des Skripts fügt das Menü IBAN-Test hinzu. Google erklärt diesen Mechanismus in der Anleitung zu benutzerdefinierten Menüs.
5. Wählen Sie IBAN-Test → Save my API token (API-Token speichern). Durchlaufen Sie Googles Autorisierung für die aktuelle Tabelle und externe Anfragen; führen Sie den Befehl bei Bedarf erneut aus. Prüfen Sie Skript und angeforderte Berechtigungen, bevor Sie Zugriff erlauben. Workspace-Richtlinien können Unterstützung durch einen Administrator erfordern; siehe Googles Autorisierungsdokumentation.
6. Fügen Sie Ihren API-Token aus dem IBAN-Test-Kontobereich in die Eingabeaufforderung ein. Geben Sie nur den Token ohne Bearer ein. Die Eingabe ist nicht verdeckt: Vermeiden Sie währenddessen Bildschirmfreigaben.

2. IBANs auswählen und prüfen

Tragen Sie in A1 eine Überschrift wie IBAN ein. Formatieren Sie die Eingabezellen als Klartext und tragen Sie darunter IBANs ein. Verwenden Sie für eine erste Demonstration das dokumentierte Beispiel DE89370400440532013000, die Variante mit Leerzeichen DE89 3704 0044 0532 0130 00 und eine bewusst geänderte Prüfsumme wie DE00370400440532013000.

Wählen Sie nur den ausgefüllten Eingabebereich, beispielsweise A2:A4, und dann IBAN-Test → Validate selected IBANs (ausgewählte IBANs prüfen). Diese Auswahl enthält zwei unterschiedliche normalisierte Werte, sodass die Vorlage zwei Anfragen versucht. Wählen Sie weder die gesamte Spalte noch Überschriften oder mehrere getrennte Bereiche. Bearbeiten Sie ausgewählte Zellen während des Durchlaufs nicht.

Sobald alle Anfragen erkannte Ergebnisse liefern, erstellt das Skript ein neues Tabellenblatt. Dessen Name beginnt mit IBAN check, gefolgt von UTC-Zeitstempel und kurzer Kennung. Öffnen Sie es und prüfen Sie die Markierung COMPLETE in A1. Alte Berichte bleiben historische Momentaufnahmen und aktualisieren sich niemals automatisch.

3. Den Bericht lesen

Der Bericht enthält neun Spalten: Quellblatt, Quellzeile, Original-IBAN, normalisierte IBAN, Status, API-Code, Bankname, BIC und Prüfzeit in UTC. Leere Bankfelder bedeuten, dass kein Wert geliefert wurde; sie machen eine gültige IBAN nicht ungültig.

Dieses verkürzte Beispiel zeigt die erwartete Statuszuordnung, wenn die API die angegebenen Codes liefert. Es dient der Veranschaulichung und ist kein authentifizierter Live-Test:

Die Vorlage akzeptiert VALID nur bei HTTP 200, Code 2100 und error: false. INVALID gilt nur für die Codes 3100, 3101 oder 3102 mit error: true. Authentifizierungs-, Kontingent- und Netzwerkfehler sowie unerwartete Antworten stoppen den Durchlauf. Siehe die dokumentierten Ergebniscodes.

Tokens und Tabellendaten privat halten

Ihr Token wird in den Skripteigenschaften des aktuellen Benutzers gespeichert, getrennt von Zellen und Quellcode. Jeder Mitwirkende muss seinen eigenen Token hinterlegen. Google dokumentiert diesen Geltungsbereich unter PropertiesService.

Benutzereigenschaften schützen nicht vor böswilligen Skriptänderungen. Tabellenbearbeiter können auch das gebundene Skript bearbeiten; geänderter Code könnte bei Ihrer nächsten Ausführung auf Ihren Token zugreifen. Verwenden Sie die Vorlage nur mit vertrauenswürdigen Bearbeitern oder in einer separaten privaten Tabelle. Google beschreibt diese Zugriffsbeziehungen in der Anleitung zu gebundenen Skripten.

Das Skript sendet normalisierte IBANs über HTTPS an IBAN-Test. Berichte enthalten die ursprünglichen IBANs und unterliegen den Zugriffsrechten der Arbeitsmappe. Begrenzen Sie Freigaben und bewahren Sie Berichte nur so lange wie nötig auf. Remove my API token entfernt Ihren lokal gespeicherten Token; widerrufen Sie einen kompromittierten Token zusätzlich in Ihrem IBAN-Test-Konto.

Kontingente, Fehler und erneute Versuche

Es gibt weder automatische Wiederholungen noch einen Cache über mehrere Durchläufe. Ein neuer Durchlauf prüft jeden unterschiedlichen Wert erneut. Vor einem Fehler abgeschlossene Anfragen können bereits Kontingent verbraucht haben. Das Skript verwendet Google URL Fetch; auch die Apps-Script-Kontingente und Laufzeitgrenzen gelten.

• Token- oder Zugriffsfehler: Prüfen Sie Token und Kontostatus vor dem erneuten Start.
• Kontingent- oder Ratenlimit: Warten Sie, bis Anfragen wieder erlaubt sind. Beachten Sie vorgegebene Wiederholungsintervalle und klicken Sie nicht fortlaufend auf den Menübefehl.
• Netzwerk-, Serverfehler oder unlesbare Antwort: Warten Sie und wiederholen Sie die kleine Auswahl manuell. Dauerhafte Fehler müssen untersucht werden.
• Kein Menü oder Zugriff verweigert: Speichern Sie das Skript, laden Sie Sheets neu und prüfen Sie Bearbeitungsrechte sowie Workspace-Einschränkungen.

Eine abgebrochene Prüfung erzeugt keinen neuen vollständigen Bericht. Ein unterbrochener Schreibvorgang kann ein unvollständiges Tabellenblatt hinterlassen: Verwerfen Sie es und verwenden Sie niemals einen älteren Bericht als Ersatz für den fehlgeschlagenen Durchlauf. Das Skript schützt vor dem Überschreiben der Eingabe, gleichzeitigen Skriptausführungen und eingeschleusten Formeln in Ausgabetexten.