Guide Google Sheets

Valider des IBAN dans Google Sheets avec Apps Script

Vérifiez une colonne d’IBAN sélectionnée depuis le menu du tableur et obtenez un rapport séparé avec horodatage, résultat de validation, banque et BIC. Téléchargez le modèle, enregistrez votre jeton API et lancez les vérifications lorsque vous en avez besoin.

État des tests : Le téléchargement réussit 46 tests Node.js locaux avec des services Apps Script simulés. Le nettoyage des doublons, les limites, la gestion des réponses, le stockage des jetons, les écritures interrompues et le masquage des formules sont vérifiés. Aucun test n'a été effectué sur un vrai compte Google Sheets ou avec une API authentifiée. Commencez par une petite table de test avant d’utiliser les données opérationnelles.

Ce que vérifie ce tableau

L'API vérifie le format IBAN et la somme de contrôle et complète les données de l'annuaire bancaire disponibles. Un résultat valide ne prouve pas la propriété du compte, l’existence du compte, la capacité du compte à effectuer un paiement ou les fonds disponibles. La portée actuelle des tests est décrite dans documentation de l’API IBAN-Test.

Le modèle utilise une commande de menu explicite à IBAN-Test. La modification d'une cellule ne déclenche pas de demande payante. Chaque passe accepte une plage contiguë d'une colonne comprenant jusqu'à 500 lignes et un maximum de 10 IBAN différents et non vides. Il s'agit de limites de modèles, et non de votre plan de compte.

Pour les requêtes et la détection des doublons, les espaces sont supprimés et les lettres sont en majuscules. Les cellules d'origine restent inchangées. Les IBAN répétés partagent une requête au sein d'une exécution, mais chaque ligne source apparaît dans le rapport. Les cellules vides sont ignorées ; Les rubriques et les formules doivent être exclues de la sélection.

1. Installez le modèle dans une feuille de calcul

1. Pour le premier test, créez une feuille de calcul Google privée. Téléchargez le fichier ZIP et décompressez-le.
2. Dans Google Sheets, ouvrez Extensions → Apps Script. Remplacez le contenu par défaut de Code.gs par le fichier téléchargé. Si le projet contient déjà les scripts requis, utilisez une nouvelle table pour cette configuration.
3. Dans Apps Script, ouvrez les Paramètres du projet et activez l’affichage de appsscript.json dans l’éditeur. Revenez à l’éditeur et remplacez ce fichier par le manifeste fourni.
4. Enregistrez le projet et rechargez la feuille de calcul. La fonction onOpen du script ajoute le menu IBAN-Test. Google explique ce mécanisme dans le Guide des menus personnalisés.
5. Sélectionnez IBAN-Test → Save my API token (jeton API de magasin). Passer par l'autorisation de Google pour la table actuelle et les requêtes externes ; réexécutez la commande si nécessaire. Examinez le script et les autorisations demandées avant d’autoriser l’accès. Les politiques de l'espace de travail peuvent nécessiter l'assistance d'un administrateur ; voir Documentation d'autorisation de Google.
6. Collez le jeton API de votre compte IBAN-Test dans la boîte de dialogue. Saisissez uniquement le jeton, sans Bearer. La saisie n’est pas masquée : évitez de partager votre écran à ce moment-là.

2. Sélectionnez et vérifiez les IBAN

Saisissez un en-tête tel que IBAN en A1. Formatez les cellules de saisie sous forme de texte brut et saisissez les IBAN en dessous. Pour une première démonstration, utilisez l'exemple documenté DE89370400440532013000, la variante avec des espaces DE89 3704 0044 0532 0130 00 et une somme de contrôle volontairement modifiée comme DE00370400440532013000.

Sélectionnez uniquement la plage de saisie remplie, par exemple A2:A4, puis IBAN-Test → Validate selected IBANs (vérifiez les IBAN sélectionnés). Cette sélection contient deux valeurs normalisées différentes, le modèle tente donc deux requêtes. Ne sélectionnez pas la colonne entière, les titres ou plusieurs sections distinctes. Ne modifiez pas les cellules sélectionnées pendant l'exécution.

Une fois que toutes les requêtes renvoient des résultats reconnus, le script crée une nouvelle feuille de calcul. Son nom commence par IBAN check, suivi de l'horodatage UTC et d'un identifiant court. Ouvrez-le et vérifiez la marque COMPLETE en A1. Les anciens rapports restent des instantanés historiques et ne sont jamais mis à jour automatiquement.

3. Lisez le rapport

Le rapport contient neuf colonnes : feuille source, ligne source, IBAN d'origine, IBAN normalisé, statut, code API, nom de la banque, BIC et heure de contrôle en UTC. Les champs bancaires vides signifient qu’aucune valeur n’a été livrée ; ils n'invalident pas un IBAN valide.

Cet exemple abrégé montre le mappage d'état attendu lorsque l'API fournit les codes spécifiés. Il est à titre indicatif et ne constitue pas un test en direct authentifié :

Le modèle n'accepte que VALID sur HTTP 200, code 2100 et error: false. INVALID s'applique uniquement aux codes 3100, 3101 ou 3102 avec error: true. L'authentification, les quotas, les erreurs réseau et les réponses inattendues arrêtent le processus. Consultez les codes de résultat documentés.

Gardez les jetons et les données de table privés

Votre jeton est stocké dans les propriétés du script de l'utilisateur actuel, distinct des cellules et du code source. Chaque contributeur doit déposer son propre token. Google documente cette portée à PropertiesService.

Les propriétés utilisateur ne protègent pas contre les modifications de script malveillantes. Les éditeurs de tableaux peuvent également modifier le script lié ; le code modifié pourrait accéder à votre jeton la prochaine fois que vous l'exécuterez. Utilisez le modèle uniquement avec des éditeurs de confiance ou dans une table privée distincte. Google décrit ces relations d'accès dans le Guide des scripts liés.

Le script envoie des IBAN normalisés à IBAN-Test via HTTPS. Les rapports contiennent les IBAN originaux et sont soumis aux droits d'accès au classeur. Limitez le partage et conservez les rapports uniquement aussi longtemps que nécessaire. Remove my API token supprime votre jeton stocké localement ; De plus, révoquez un jeton compromis dans votre compte IBAN-Test.

Quotas, erreurs et tentatives

Il n’y a pas de tentatives automatiques ni de cache sur plusieurs exécutions. Une nouvelle exécution revérifie chaque valeur différente. Les demandes terminées avant une erreur peuvent avoir déjà utilisé leur quota. Le script utilise Google URL Fetch ; le Quotas Apps Script et limites de durée s'applique également.

• Erreur de jeton ou d'accès : Vérifiez l'état du jeton et du compte avant de redémarrer.
• Quota ou limite de taux : Attendez que les demandes soient à nouveau autorisées. Faites attention aux intervalles de répétition spécifiés et ne cliquez pas continuellement sur la commande de menu.
• Erreur réseau, serveur ou réponse illisible : Attendez et refaites la petite sélection manuellement. Les erreurs permanentes doivent faire l’objet d’une enquête.
• Aucun menu ou accès refusé : Enregistrez le script, rechargez les feuilles et vérifiez les droits d'édition et les restrictions de l'espace de travail.

Une vérification interrompue ne produit pas un nouveau rapport complet. Une écriture interrompue peut laisser une feuille de calcul incomplète : jetez-la et n'utilisez jamais un rapport plus ancien pour remplacer l'exécution ayant échoué. Le script protège contre l'écrasement des entrées, les exécutions simultanées de scripts et les formules injectées dans les textes de sortie.