Guía de Google Sheets

Validar IBAN en Google Sheets con Apps Script

Compruebe una columna de IBAN seleccionada desde el menú de la hoja de cálculo y obtenga un informe separado con fecha y hora, estado de validación, banco y BIC. Descargue la plantilla, guarde su token API y ejecute las comprobaciones cuando las necesite.

Estado de las pruebas: La descarga pasa 46 pruebas locales de Node.js con servicios de Apps Script simulados. Se verifican la limpieza de duplicados, los límites, el manejo de respuestas, el almacenamiento de tokens, las escrituras interrumpidas y el enmascaramiento de fórmulas. No se realizaron pruebas en una cuenta real de Google Sheets ni con una API autenticada. Comience con una pequeña tabla de prueba antes de utilizar datos operativos.

Lo que comprueba esta tabla

La API verifica el formato IBAN y la suma de verificación y complementa los datos del directorio bancario disponibles. Un resultado válido no prueba la propiedad de la cuenta, su existencia, su aptitud de la cuenta para realizar pagos o los fondos disponibles. El alcance actual de las pruebas se describe en documentación de la API de IBAN-Test.

La plantilla utiliza un comando de menú explícito en IBAN-Test. La edición de una celda no genera una solicitud con cargo. Cada pase acepta un rango contiguo de una columna con hasta 500 filas y un máximo de 10 IBAN diferentes, no vacíos. Estos son límites de plantilla, no el plan de su cuenta.

Para consultas y detección de duplicados, se eliminan los espacios y las letras se escriben en mayúscula. Las celdas originales permanecen sin cambios. Los IBAN repetidos comparten una consulta dentro de una ejecución, pero cada línea de origen aparece en el informe. Se omiten las celdas vacías; Los títulos y fórmulas deben excluirse de la selección.

1. Instale la plantilla en una hoja de cálculo.

1. Para la primera prueba, cree una hoja de cálculo privada de Google. Descarga el archivo ZIP y descomprímelo.
2. En Google Sheets, abra Extensiones → Apps Script. Reemplace el contenido predeterminado de Code.gs con el archivo descargado. Si el proyecto ya contiene los scripts necesarios, utilice una nueva tabla para esta configuración.
3. En Apps Script, abra Configuración del proyecto y active la opción para mostrar appsscript.json en el editor. Vuelva al editor y sustituya ese archivo por el manifiesto incluido.
4. Guarde el proyecto y vuelva a cargar la hoja de cálculo. La función onOpen del script agrega el menú IBAN-Test. Google explica este mecanismo en el Guía de menú personalizado.
5. Seleccione IBAN-Test → Save my API token (Token API de tienda). Pasar por la autorización de Google para la tabla actual y solicitudes externas; ejecute el comando nuevamente si es necesario. Revise el script y los permisos solicitados antes de permitir el acceso. Las políticas del espacio de trabajo pueden requerir asistencia del administrador; ver Documentación de autorización de Google.
6. Pegue el token API de su cuenta IBAN-Test en el cuadro de diálogo. Introduzca solo el token, sin Bearer. La entrada es visible: evite compartir la pantalla mientras lo escribe.

2. Seleccione y verifique los IBAN

Ingrese un encabezado como IBAN en A1. Formatee las celdas de entrada como texto sin formato e ingrese el IBAN debajo. Para una primera demostración, utilice el ejemplo documentado DE89370400440532013000, la variante con espacios DE89 3704 0044 0532 0130 00 y una suma de comprobación modificada deliberadamente como DE00370400440532013000.

Seleccione solo el rango de entrada completo, por ejemplo A2:A4, y luego IBAN-Test → Validate selected IBANs (verifique los IBAN seleccionados). Esta selección contiene dos valores normalizados diferentes, por lo que la plantilla intenta dos solicitudes. No seleccione toda la columna, los encabezados ni varias secciones separadas. No edite las celdas seleccionadas durante la ejecución.

Una vez que todas las consultas arrojan resultados reconocidos, el script crea una nueva hoja de cálculo. Su nombre comienza con IBAN check, seguido de la marca de tiempo UTC y un identificador corto. Ábralo y verifique la marca COMPLETE en A1. Los informes antiguos siguen siendo instantáneas históricas y nunca se actualizan automáticamente.

3. Lee el informe

El informe contiene nueve columnas: Hoja de origen, Fila de origen, IBAN original, IBAN normalizado, Estado, Código API, Nombre del banco, BIC y Hora de comprobación en UTC. Los campos bancarios vacíos significan que no se entregó ningún valor; no invalidan un IBAN válido.

Este ejemplo abreviado muestra la asignación de estado esperada cuando la API proporciona los códigos especificados. Tiene fines ilustrativos y no es una prueba en vivo autenticada:

La plantilla solo acepta VALID en HTTP 200, código 2100 y error: false. INVALID solo aplica para los códigos 3100, 3101 o 3102 con error: true. La autenticación, la cuota, los errores de red y las respuestas inesperadas detienen el proceso. Ver la códigos de resultados documentados.

Mantenga la privacidad de los tokens y los datos de las tablas

Su token se almacena en las propiedades del script del usuario actual, separado de las celdas y el código fuente. Cada contribuyente debe depositar su propio token. Google documenta este alcance en PropertiesService.

Las propiedades del usuario no protegen contra cambios de script maliciosos. Los editores de tablas también pueden editar el script vinculado; El código modificado podría acceder a su token la próxima vez que lo ejecute. Utilice la plantilla sólo con editores de confianza o en una tabla privada separada. Google describe estas relaciones de acceso en el guía de scripts vinculados.

El script envía IBAN normalizados a IBAN-Test a través de HTTPS. Los informes contienen los IBAN originales y están sujetos a los derechos de acceso al libro de trabajo. Limite el uso compartido y conserve los informes solo durante el tiempo que sea necesario. Remove my API token elimina su token almacenado localmente; Además, revoque un token comprometido en su cuenta IBAN-Test.

Cuotas, errores y reintentos

No hay reintentos automáticos ni caché en varias ejecuciones. Una nueva ejecución vuelve a verificar cada valor diferente. Es posible que las solicitudes completadas antes de un error ya hayan agotado la cuota. El script utiliza Google URL Fetch; También se aplican el cuotas y límites de ejecución de Apps Script.

• Error de token o acceso: Verifique el token y el estado de la cuenta antes de reiniciar.
• Límite de cuota o tasa: Espere hasta que se permitan solicitudes nuevamente. Preste atención a los intervalos de repetición especificados y no haga clic continuamente en el comando del menú.
• Error de red, servidor o respuesta ilegible: Espere y rehaga la pequeña selección manualmente. Se deben investigar los errores permanentes.
• No hay menú ni acceso denegado: Guarde el guión, vuelva a cargar las hojas y verifique los derechos de edición y las restricciones del espacio de trabajo.

Una comprobación interrumpida no produce un nuevo informe completo. Una escritura interrumpida puede dejar una hoja de cálculo incompleta: deséchela y nunca utilice un informe anterior para reemplazar la ejecución fallida. El script protege contra la sobrescritura de entradas, ejecuciones simultáneas de scripts y fórmulas inyectadas en los textos de salida.