Python · CSV · Validação de IBAN

Validar IBAN de um ficheiro CSV com Python

Verifique uma lista de IBAN exportada e crie um novo ficheiro CSV com estado da validação, nome do banco e BIC. O script para download usa a biblioteca padrão Python, preserva a ordem das linhas e verifica IBANs duplicados apenas uma vez por execução.

Este é um fluxo de linha de comando local para Python versão 3.10 ou posterior. Cada IBAN diferente e não vazio é enviado para a API IBAN-Test. Você precisa de seu próprio token de API e de uma quota de solicitação suficiente.

Estado dos testes: Nove testes locais automatizados abrangem construção de solicitações, linhas duplicadas e vazias, resultados de verificação, proteção de quotas, tratamento de erros, mascaramento de CSV e preservação de ficheiros existentes. Uma passagem autenticada na API Live não foi executada neste exemplo.

1. Prepare o ficheiro de entrada

Exporte seus dados de origem como CSV UTF-8. Use o cabeçalho da coluna em letras minúsculas iban e, opcionalmente, uma coluna reference para mapear os resultados para seus registros. O script inclui apenas essas duas colunas de entrada na saída; outras colunas não são levadas em consideração. Mantenha sua exportação original.

reference,iban
example-valid,DE89 3704 0044 0532 0130 00
example-duplicate,de89370400440532013000
example-invalid-checksum,DE00370400440532013000
example-empty,

Estas são amostras de teste, não instruções de pagamento. As duas primeiras linhas resultam no mesmo IBAN normalizado. A linha vazia obtém MISSING sem uma solicitação de API. Guarde IBANs e referências como texto ao exportar de uma folha de cálculo.

2. Faça uma primeira pequena verificação

Descompacte o pacote, abra um terminal em seu diretório e verifique se o Python está disponível:

python3 --version
python3 iban_csv.py sample.csv results.csv

No Windows, use py -3 em vez de python3 se necessário, dependendo da sua instalação. O programa consultará seu token de API sem exibir os caracteres inseridos. Você pode encontrar o token na visão geral da API da sua conta IBAN-Test. Não está gravado no ficheiro CSV.

O limite padrão é 10 IBANs diferentes e não vazios. O script os conta antes da primeira solicitação e para quando são excedidos. O exemplo acima requer duas solicitações de API se ambas forem concluídas regularmente.

Se for bem-sucedido, o programa exibirá o número de linhas e solicitações. Ele só cria o ficheiro de saída quando há um resultado de verificação utilizável para cada IBAN solicitado. Portanto, um erro de API não deixa um resultado CSV parcialmente verificado.

3. Leia a edição

VALID requer o código 2100 e error: false. Os códigos 3100, 3101 e 3102 com error: true resultam em INVALID. Falha de autenticação, quota esgotada, erros de servidor e respostas inesperadas param o programa com um código de saída diferente de zero.

4. Processe outras exportações e listas maiores

Para exportar com ponto e vírgula, selecione o separador explicitamente. Aplica-se a entrada e saída:

python3 iban_csv.py customers.csv checked-customers.csv --delimiter ";"

Verifique sua quota de API restante e aumente o limite de solicitações por execução, se necessário:

python3 iban_csv.py customers.csv checked-customers.csv --max-requests 100

As solicitações individuais são enviadas uma após a outra; não é um endpoint REST para pedidos em lote. Uma execução com falha pode já ter consumido solicitações. Uma reinicialização verifica a lista novamente: a remoção de duplicados se aplica em uma execução, não em várias execuções. Este modelo não possui repetições automáticas nem status intermediários recuperáveis.

Para execuções autônomas, forneça IBAN_TEST_API_TOKEN por meio da configuração de segredos do sistema de tarefas. Não armazene tokens reais no controle de versão nem os passe como argumento de linha de comando. Para execuções manuais, a entrada interativa oculta é mais fácil.

Problemas comuns

• “CSV must have an iban header”: Verifique a ortografia exata do título da coluna, a codificação e o separador. XLSX não é CSV.
• “Choose a new output filename”: O script não substitui ficheiros existentes ou sua entrada. Use um novo nome de ficheiro para cada execução.
• HTTP 401 ou código API 4002: Verifique seu token. Não tente novamente autenticações com falha continuamente.
• Código API 4003: A quota foi esgotada. Pare o trabalho e verifique sua quota antes de iniciá-lo novamente.
• Erro de rede ou JSON inválido: O fluxo para. Verifique a conexão e a disponibilidade da API; Um erro de transmissão nada diz sobre a validade do IBAN.

Proteja os dados exportados

Apenas o IBAN é enviado para a API; a referência permanece no seu fluxo local. Mantenha os ficheiros de entrada e saída em um local privado apropriado. O script prefixa valores de tabela potencialmente executáveis ​​com um apóstrofo para reduzir o risco de injeção de fórmula. Isso pode alterar a representação literal de uma referência como =1+1. Mantenha a exportação original para uma correspondência precisa.

Um IBAN válido não prova a existência, propriedade, saldo da conta ou sucesso do pagamento. Informações sobre procedimentos SEPA individuais podem ser encontradas nas instruções do Participação SEPA de um banco. O instruções n8n é adequado para um processo visual.

Execute testes off-line incluídos

python3 -m unittest -v

Os testes utilizam respostas controladas e não consomem solicitações de API. Eles analisam as decisões do programa, não o seu token ou informações bancárias atuais.

Referências: documentação da API IBAN-Test, Referência CSV Python, Referência Python em solicitações HTTP.

Criar conta API Compare quotas de API