Saltar ligações

Verifique o IBAN online com o FileMaker e o plugin MBS.

Pedir um código de autenticação em iban-test.de

Verificar IBAN online com FileMakerDesde há alguns meses, os antigos números de conta e códigos de classificação tornaram-se obsoletos na banca - IBAN e BIC são as palavras mágicas na banca atual. Para os programadores da FileMaker, isto significa implementar novas funções relacionadas com o IBAN e o BIC nas suas soluções FileMaker. Já existem várias funções personalizadas disponíveis na Internet para calcular um IBAN a partir de um código de classificação bancária e número de conta. No entanto, devido a casos especiais não insignificantes no cálculo de um IBAN, nem sempre é possível ter a certeza de que o IBAN foi realmente calculado corretamente com uma fórmula pura. Por este motivo, pode ser útil verificar online a plausibilidade do IBAN calculado, de modo a evitar calcular e guardar um IBAN incorreto. Neste artigo, mostramos como um IBAN pode ser verificado online diretamente na FileMaker usando o serviço iban-test.de e a API fornecida. O ficheiro de exemplo mostrado no artigo pode ser descarregado no final do artigo na secção formato fmp12 pode ser descarregado. O ficheiro de exemplo utiliza funções do plugin MBS FileMaker para acesso à API.

Passo 1: Solicitar uma chave API em iban-test.de

Para poder verificar um IBAN através da API iban-test.de, precisamos primeiro de um código de autorização correspondente para a API. Para tal, aceda à seguinte página no seu navegador de Internet iban-test.com e clicar no botão Barra de navegação no botão [API].

Pedir um código de autenticação em iban-test.de

Introduza agora o seu nome, endereço eletrónico, sítio Web e tipo de utilização na coluna da esquerda. Depois de clicar no botão [Criar chave API] abre-se uma nova janela com o seu código de autenticação para a API. É preferível copiar o código para um editor de texto e guardar o ficheiro.

Passo 2: Criar um subscrito para verificação do IBAN na FileMaker

A API de iban-test.de pode ser acedida através de um pedido HTTP GET/POST normal. Neste passo, criamos um script parcial que se chama ScriptO parâmetro - aceita um IBAN e devolve um 1 (válido) ou um 0 (inválido) como resultado. No nosso ficheiro de exemplo, é apresentada uma caixa de diálogo no final do script que mostra se o IBAN introduzido é válido ou inválido.

Script: ts.IBAN_check

Definir registo de erros [Ligado]
# Parâmetro do guião: IBAN
Definir variável [$iban; Value:Get(ScriptParameter)]
Definir variável [$authcode; value:ibancheck::Authcode]
Definir variável [$type; value:ibancheck:type]
#
Definir variável [$r; Value:MBS("Trace")]
# Preparar a transferência
Definir variável [$authcode; value:MBS("StringEncodeURLComponent"; $authcode; "utf8")]
Definir variável [$type; value:MBS("StringEncodeURLComponent"; $type; "utf8")]
Definir variável [$iban; value:MBS("StringEncodeURLComponent"; $iban; "utf8")]
Definir variável [$curl; Value:MBS("CURL.New")]
Definir variável [$result; value:MBS("CURL.SetOptionpost"; $curl; 1)]
Definir variável [$result; Value:MBS("CURL.SetOptionVerbose"; $curl; 1)]
Definir variável [$result; Value:MBS("CURL.SetOptionURL"; "http://www.iban-test.de/api.php")]
# Definir parâmetros de entrada
Definir variável [$content; valor: "authcode=" & $authcode & "&" & "type=" & $type & "&" & "iban=" & $iban]
Definir variável [$content; value:MBS("String.ReplaceNewline"; $content; 2 )]
Definir variável [$result; Value:MBS("CURL.SetOptionPostFields"; $curl; $content)]
# Iniciar a transferência
Definir variável [$result; Value:MBS("CURL.Perform"; $curl)]
# Controlo dos resultados
Definir variável [$debugText; valor:MBS("String.ReplaceNewline"; MBS("CURL.GetDebugAsText"; $curl); 1)]
Definir variável [$resultText; Value:MBS("String.ReplaceNewline"; MBS("GetResultAsText"; $curl); 1)]
Definir variável [$r; valor:MBS("CURL.Cleanup"; $curl); 1)]
Definir variável [$result; Value:If(PatternNumber($resultText; "200") > 0; 1; 0)]
Definir variável [$result text; value:If($result=0; "invalid"; "valid")]
# Diálogo de ensaio
Mostrar a própria caixa de diálogo ["IBAN" & $result text; "O IBAN introduzido é " & $result text

O script aceita inicialmente o IBAN como um parâmetro de script. Para evitar quaisquer espaços no IBAN, recomenda-se que adicione o comando Substituir($iban; " "; "") para acrescentar.

Introduzir código de autenticação

Introduzir o código de autenticação na FileMakerOs campos Authcode e Type são retirados do layout do ficheiro de exemplo - antes de testar a função, deve primeiro introduzir o seu Authcode no campo correspondente que solicitou no website iban-test.de. Para o tipo, deixe o valor predefinido controlo estão disponíveis. Outro tipo é a função criar que também pode ser utilizado para calcular um IBAN, especificando o código de ordenação bancária (&blz=), o número de conta (&ktn=) e o código de país ($cc=). O procedimento é o mesmo que no nosso ficheiro de exemplo, com a diferença de que os três parâmetros mencionados devem ser fornecidos em vez do IBAN.

Preparar a transferência

Na secção do programa Transferência os três parâmetros são definidos para a forma correta e o URL de consulta é definido. No nosso exemplo, o URL

http://www.iban-test.de/api.php

está permanentemente integrado no guião - também pode, naturalmente, ser obtido dinamicamente a partir de um campo.

Iniciar a transferência

Nas partes Definir parâmetros de entrada e Iniciar a transferência os parâmetros são reunidos, os campos são transferidos e a transferência é iniciada. A verificação do resultado verifica se o código de resultado 200 é um IBAN válido ou se é inválido.

Incluímos um diálogo de teste na nossa base de dados de amostra que mostra se o IBAN introduzido é válido ou inválido.

Diálogo IBAN válido

Integração nas suas próprias soluções FileMaker

No nosso script de exemplo, a última linha é o comando

Sair do script atual [Resultado: $result]

Este comando não é necessário para o nosso ficheiro de exemplo. No entanto, se integrar o script incluído na sua solução, recomenda-se que o integre como um script parcial que devolve o valor que indica se o IBAN fornecido é válido ou não. Não se esqueça de remover o diálogo de exemplo durante a integração ;-)

Plugin MBS FileMaker

Esta solução utiliza as funções CURL do MBS Plugin FileMaker. Dica: Até 30 de abril, o plugin MBS FileMaker está disponível como parte do 20º aniversário na K&K Verlag (Revista FileMaker) em Hamburgo, a preços reduzidos. Mais informações sobre o MBS FileMaker Plugin podem ser encontradas na página Sítio Web do fabricante.

Descarregar ficheiro de amostra para FileMaker 12/13

Descarregar ficheiro de amostra FileMaker

Como transferir scripts do ficheiro de amostra para a sua solução

Os scripts podem ser facilmente transferidos de uma solução FileMaker para outra através da área de transferência. Basta abrir a caixa de diálogo Gerir guiõesSelecione o script pretendido com o rato e copie-o para a área de transferência utilizando o menu [Editar - Copiar] ou a combinação de teclas [Ctrl/Cmd-C]. Em seguida, abra a mesma caixa de diálogo na solução de destino e simplesmente cole novamente o script copiado anteriormente usando o comando de menu [Editar - Colar].

Para transferir tabelas do ficheiro de amostra para a sua solução

As tabelas podem ser inseridas numa solução existente de várias formas. A maneira mais fácil é importar a tabela Tabela através do botão [Importar...] da caixa de diálogo Base de dados Gerir. Todas as tabelas a importar da solução de origem podem então ser selecionadas num diálogo subsequente. Este método é, portanto, particularmente adequado se várias tabelas tiverem de ser importadas ao mesmo tempo. Se apenas uma tabela tiver que ser importada, isso também pode ser feito através da área de transferência como um script. Se uma tabela tiver de ser importada juntamente com os seus dados, isso pode ser feito com o comando [Ficheiro > Importar registos > Ficheiro]. Na caixa de diálogo de importação, a tabela de destino Nova mesa deve ser especificado.

Para transferir listas de valores do ficheiro de exemplo para a sua solução

As listas de valores podem ser facilmente importadas de uma solução FileMaker para outra através da área de transferência. Basta abrir a caixa de diálogo em [Ficheiro/Arquivo > Gerir > Listas de valores], selecionar a lista de valores pretendida e clicar em [Importar]. Lista de valores com o rato e copiar a lista de valores para a área de transferência utilizando o menu [Editar - Copiar] ou a combinação de teclas [Ctrl/Cmd-C]. Em seguida, abra a mesma caixa de diálogo na solução de destino e cole a lista de valores copiada anteriormente usando o comando de menu [Editar - Colar].

Como transferir as suas próprias funções do ficheiro de exemplo para a sua solução

Clique no botão [Importar] na caixa de diálogo [Ficheiro > Gerir > Funções personalizadas...] e, em seguida, selecione o ficheiro de amostra. Selecione as funções personalizadas desejadas na caixa de diálogo seguinte e confirme a caixa de diálogo. Tenha em atenção que esta função só está disponível na FileMaker Pro Advanced, mas não na FileMaker Pro.

Deixar um comentário

  1. Isto faz-me lembrar os bons velhos tempos em que escrevíamos listagens para o C=64. Muito obrigado pelo artigo e pelo ficheiro de exemplo :-)

  2. Olá e bom dia,

    Estou atualmente a testar este script e recebo um "inválido" para cada IBAN. O script ainda está atualizado?

    1. Aqui poderá ter de verificar se a interface do fornecedor ainda está actualizada ou se foi entretanto alterada.

Partilhar esta página:

Um software ERP tão flexível como a sua empresa.
Teremos todo o prazer em o aconselhar.

Software ERP personalizável para Mac, Windows e iOS.

Está aqui: Instruções: Verificar o IBAN com FileMaker e o plugin MBS online