Guida a Google Sheets

Validare gli IBAN in Google Sheets con Apps Script

Verifica una colonna di IBAN selezionata dal menu del foglio di calcolo e ottieni un rapporto separato con data e ora, esito della validazione, banca e BIC. Scarica il modello, salva il token API e avvia i controlli quando servono.

Stato dei test: Il download supera 46 test Node.js locali con servizi Apps Script simulati. Vengono controllati la rimozione dei duplicati, i limiti, la gestione delle risposte, l'archiviazione dei token, le scritture interrotte e il mascheramento delle formule. Non è stato eseguito alcun test su un account Fogli Google reale o con un'API autenticata. Inizia con una piccola tabella di prova prima di utilizzare i dati operativi.

Cosa controlla questa tabella

L'API controlla il formato IBAN e il checksum e integra i dati degli elenchi bancari disponibili. Un risultato valido non dimostra la proprietà del conto, l'esistenza del conto, l’idoneità del conto a effettuare pagamenti o i fondi disponibili. L'ambito attuale dei test è descritto in documentazione dell’API IBAN-Test.

Il modello utilizza un comando di menu esplicito in IBAN-Test. La modifica di una cella non attiva una richiesta addebitabile. Ogni pass accetta un intervallo contiguo di una colonna con un massimo di 500 righe e un massimo di 10 IBAN diversi e non vuoti. Questi sono i limiti del modello, non il piano del tuo account.

Per le query e il rilevamento dei duplicati, gli spazi vengono rimossi e le lettere vengono scritte in maiuscolo. Le celle originali rimangono invariate. Gli IBAN ripetuti condividono una query all'interno di un'esecuzione, ma ogni riga di origine viene visualizzata nel report. Le celle vuote vengono saltate; Intestazioni e formule devono essere escluse dalla selezione.

1. Installa il modello in un foglio di calcolo

1. Per il primo test, crea un foglio di calcolo Google privato. Scarica il file ZIP e decomprimilo.
2. In Google Sheets, aprire Estensioni → Apps Script. Sostituisci il contenuto predefinito di Code.gs con il file scaricato. Se il progetto contiene già gli script richiesti, utilizza una nuova tabella per questa configurazione.
3. In Apps Script, apri Impostazioni del progetto e abilita la visualizzazione di appsscript.json nell’editor. Torna all’editor e sostituisci il file con il manifest incluso.
4. Salva il progetto e ricarica il foglio di calcolo. La funzione onOpen dello script aggiunge il menu IBAN-Test. Google spiega questo meccanismo nello Guida ai menu personalizzati.
5. Seleziona IBAN-Test → Save my API token (Memorizza token API). Passa attraverso l'autorizzazione di Google per la tabella corrente e le richieste esterne; eseguire nuovamente il comando se necessario. Esaminare lo script e le autorizzazioni richieste prima di consentire l'accesso. Le policy dell'area di lavoro potrebbero richiedere l'assistenza dell'amministratore; vedere La documentazione di autorizzazione di Google.
6. Incolla il token API del tuo account IBAN-Test nella finestra di dialogo. Inserisci solo il token, senza Bearer. L’inserimento non è nascosto: evita di condividere lo schermo mentre lo digiti.

2. Seleziona e controlla gli IBAN

Inserisci un'intestazione come IBAN in A1. Formatta le celle di input come testo normale e inserisci gli IBAN sotto. Per una prima dimostrazione, utilizzare l'esempio documentato DE89370400440532013000, la variante con spazi DE89 3704 0044 0532 0130 00 e un checksum deliberatamente modificato come DE00370400440532013000.

Seleziona solo l'intervallo di input riempito, ad esempio A2:A4, quindi IBAN-Test → Validate selected IBANs (controlla gli IBAN selezionati). Questa selezione contiene due diversi valori normalizzati, quindi il modello tenta due richieste. Non selezionare l'intera colonna, le intestazioni o più sezioni separate. Non modificare le celle selezionate durante l’esecuzione.

Una volta che tutte le query restituiscono risultati riconosciuti, lo script crea un nuovo foglio di calcolo. Il suo nome inizia con IBAN check, seguito dal timestamp UTC e da un breve identificatore. Aprilo e controlla il segno COMPLETE in A1. I vecchi report rimangono istantanee storiche e non si aggiornano mai automaticamente.

3. Leggi il rapporto

Il report contiene nove colonne: Foglio di origine, Riga di origine, IBAN originale, IBAN normalizzato, Stato, Codice API, Nome della banca, BIC e Orario di controllo in UTC. I campi bancari vuoti indicano che non è stato consegnato alcun valore; non invalidano un IBAN valido.

Questo esempio abbreviato mostra la mappatura dello stato previsto quando l'API fornisce i codici specificati. È a scopo illustrativo e non è un test dal vivo autenticato:

Il modello accetta solo VALID su HTTP 200, codice 2100 e error: false. INVALID si applica solo ai codici 3100, 3101 o 3102 con error: true. Autenticazione, quota, errori di rete e risposte impreviste interrompono il processo. Vedi codici risultato documentati.

Mantieni privati i token e i dati della tabella

Il tuo token viene archiviato nelle proprietà dello script dell'utente corrente, separato dalle celle e dal codice sorgente. Ogni contributore deve depositare il proprio token. Google documenta questo ambito in PropertiesService.

Le proprietà utente non proteggono da modifiche dannose agli script. Gli editor di tabelle possono anche modificare lo script associato; il codice modificato potrebbe accedere al tuo token la prossima volta che lo eseguirai. Utilizza il modello solo con editor fidati o in una tabella privata separata. Google descrive queste relazioni di accesso nello guida agli script associati.

Lo script invia IBAN normalizzati a IBAN-Test tramite HTTPS. I report contengono gli IBAN originali e sono soggetti ai diritti di accesso alla cartella di lavoro. Limita la condivisione e conserva i report solo per il tempo necessario. Remove my API token rimuove il token archiviato localmente; Inoltre, revoca un token compromesso nel tuo account IBAN-Test.

Quote, errori e tentativi

Non sono previsti tentativi automatici o memorizzazione nella cache tra più esecuzioni. Una nuova esecuzione ricontrolla ogni valore diverso. Le richieste completate prima che si verificasse un errore potrebbero aver già esaurito la quota. Lo script utilizza Google URL Fetch ; si applica anche lo Quote e limiti di durata di Apps Script.

• Token o errore di accesso: Controlla lo stato del token e dell'account prima di riavviare.
• Quota o limite di frequenza: Attendere fino a quando le richieste non saranno nuovamente consentite. Prestare attenzione agli intervalli di ripetizione specificati e non fare clic continuamente sul comando di menu.
• Rete, errore del server o risposta illeggibile: Attendi e ripeti manualmente la piccola selezione. Gli errori permanenti devono essere indagati.
• Nessun menu o accesso negato: Salva lo script, ricarica i fogli e controlla i diritti di modifica e le restrizioni dello spazio di lavoro.

Una verifica interrotta non produce un nuovo report completo. Una scrittura interrotta può lasciare un foglio di calcolo incompleto: eliminalo e non utilizzare mai un report più vecchio per sostituire l'esecuzione non riuscita. Lo script protegge dalla sovrascrittura degli input, dalle esecuzioni simultanee degli script e dalle formule inserite nei testi di output.