Guia de integração do IBAN-Test

Validar IBAN no n8n com um fluxo de trabalho para descarregar

Importe um pequeno fluxo manual, configure as credenciais da API IBAN-Test e encaminhe os resultados para os ramos VALID ou INVALID. O modelo verifica um IBAN de cada vez e para quando não consegue obter um resultado fiável.

Estado dos testes: O relatório incluído documenta 24 testes off-line aprovados com Node.js: casos de teste de JavaScript, normalização, duplicatas, limites, classificação estrita de resultados, rejeição de respostas conflitantes e configuração e conexões de fluxo de trabalho. As definições dos nós foram verificadas em relação à documentação oficial do n8n e ao código-fonte. Um tempo de execução n8n instalado e credenciais de API não estavam disponíveis. Importação, execução em n8n, mapeamento de elementos vinculados e chamadas de API autenticadas ainda não foram testadas. Antes de confiar no fluxo de trabalho, execute o teste manual descrito abaixo em sua instância.

O que o modelo faz

Use-os como ponto de partida antes de conectar um formulário de cliente, tabela ou banco de dados interno. O fluxo de trabalho é iniciado manualmente e contém quatro linhas de exemplo: um exemplo de IBAN publicado, uma variante com um dígito de verificação alterado, uma duplicata e um valor vazio. Ele remove espaços em branco, converte letras em maiúsculas, ignora valores vazios e agrupa duplicatas. As posições originais das linhas são mantidas em sourceRows, para que um resultado possa ser atribuído a diversas linhas.

São permitidos dez IBANs diferentes e não vazios por execução. Se houver mais de dez, o fluxo de trabalho será interrompido antes da primeira solicitação; valores excedentes não são descartados silenciosamente. Valores ausentes ou vazios são ignorados, mas valores sem tipo de string interrompem a preparação. Mesmo uma entrada completamente vazia leva à parada. Guarde os IBANs na sua fonte como texto.

Uma solicitação REST separada é feita para cada IBAN restante. Esta integração não utiliza um endpoint de coleta REST: dez IBANs diferentes significam até dez chamadas de verificação. A remoção de duplicados se aplica em uma única execução. Uma reinicialização verifica os mesmos valores novamente. Leve o documentação da API IBAN-Test em consideração ao planejar.

1. Importar ficheiro de fluxo de trabalho

Descompacte o ficheiro ZIP e abra um novo fluxo de trabalho em n8n. No menu de três pontos no canto superior direito, selecione Import from File e depois iban-test-n8n-workflow.json. Guarde o fluxo de trabalho com um nome significativo. Essas etapas correspondem a instruções de importação do fluxo de trabalho n8n.

Devem aparecer nove nós, começando por Run manually. O nó central One IBAN at a time processa lotes de um elemento. A saída loop conduz ao pedido HTTP e ao classificador, que regressa ao ciclo. A saída done conduz aos ramos dos resultados. Não altere estas ligações durante o teste.

2. Armazene o token da API como dados de acesso

Abra Validate IBAN. A autenticação é configurada como Generic Credential Type com Header Auth. Crie credenciais de autenticação de cabeçalho com os seguintes campos ou selecione os existentes:

• Name: Authorization
• Value: Bearer YOUR_API_TOKEN. Substitua o espaço reservado pelo seu token e mantenha o espaço após Bearer.

Guarde e selecione essas credenciais. O download intencionalmente não contém um ID de dados de acesso nem um segredo. Armazene seu token apenas no formato de credencial, não no código de exemplo ou em parâmetros de nó comuns. Veja o referência n8n para credenciais de solicitação HTTP.

A solicitação já está configurada como POST https://www.iban-test.eu/api/v2/iban/validate. A expressão para o corpo JSON é {{ { iban: $json.iban } }}. Uma resposta JSON incluindo o status HTTP é solicitada para que o próximo nó possa verificar a transmissão e o resultado da API. As configurações estão descritas no Documentação do nó de solicitação HTTP.

3. Execute exemplos manualmente

Abra Sample rows e verifique os valores de exemplo. Em seguida, inicie todo o fluxo de trabalho por meio do gatilho manual. Dois elementos de consulta são criados a partir das linhas fornecidas. Se a API for executada com sucesso, o exemplo inalterado deverá aparecer em VALID results, a variante com um dígito de verificação alterado em INVALID results. Estes são os resultados esperados do seu primeiro teste ao vivo, e não uma afirmação de que o download já foi testado com uma conta autenticada.

Para cada item de saída, verifique iban, sourceRows, status e code. As ramificações atualmente terminam em nós sem operação, onde você pode visualizar os resultados sem gravar em outro sistema. Substitua os exemplos por alguns valores de teste liberados antes de conectar uma fonte de dados real.

Distinguir entre resultados de testes e erros técnicos

A classificação requer um código numérico inteiro e um campo de erro booleano. O código de autenticação 4002, o código de quota 4003 e o código de acesso bloqueado 4004 interrompem o fluxo. Um tempo limite, status HTTP diferente de 200 ou conteúdo de resposta incorreto nunca são registrados como um IBAN inválido. A base é o códigos de resultados de API documentados. Um IBAN válido não prova a titularidade da conta nem garante o pagamento.

O Loop de nó sobre itens aguarda a classificação antes de solicitar o próximo item. Em caso de erro técnico, os IBANs posteriores não serão mais solicitados e as ramificações do resultado final não serão executadas. A saída do nó anterior ainda pode estar visível no editor. Trate a execução como incompleta.

As repetições automáticas estão desativadas. Solucione problemas de autenticação ou quota antes de reiniciar. Uma reinicialização manual pode consumir chamadas adicionais para linhas que já foram verificadas. Se você adicionar novas tentativas posteriormente para erros temporários, limite o número e os tempos de espera. Nunca repita entradas ou solicitações inválidas em um loop quando a quota estiver esgotada.

Antes de conectar dados produtivos

O modelo desativa o salvamento de dados e progresso de sucesso e falha de execução manual. Verifique este Configurações de fluxo de trabalho após a importação. Os IBANs e as respostas da API ainda podem ficar visíveis durante a execução; Regras de hospedagem, registro e backup também desempenham um papel. Não fixe dados reais de clientes em nós nem compartilhe exportações de fluxo de trabalho que contenham esses dados.

Após um teste manual bem-sucedido, conecte cada ramificação de resultado ao destino pretendido. Preserve os identificadores de origem e evite registros duplicados em execuções repetidas. Adicione uma programação somente depois que o fuso horário, o orçamento da quota, as mensagens de erro e o comportamento de reinicialização tiverem sido determinados.

As instruções para Verificação de IBAN no Google Sheets e Verificando um CSV IBAN com Python fornecem mais informações.