Ligações bancárias

Este guia descreve a ligação em direto a um banco (open banking PSD2): como efetuar a ligação, como associar as contas do banco ao seu razão, como fazer com que cada sincronização crie parceiros, faça a correspondência de faturas e contabilize encargos através de um modelo de importação, e ainda o que a sincronização devolve. Os detalhes da API encontram-se em Importações de bancos e pagamentos. Se pretender utilizar ficheiros de extrato em vez de uma ligação em direto, consulte Importar extratos bancários (camt.053).

1. Conectar o banco

Em Banco → Ligações, selecione o país e prima Mostrar bancos. Escolha o seu banco e o tipo de titular da conta (empresarial ou particular) e, em seguida, prima Conectar. Será redirecionado para a página de consentimento do próprio banco, onde deve iniciar sessão e aprovar o acesso; o banco devolve-o depois ao Nordlet. A ligação aparece na lista juntamente com a respetiva data de validade do consentimento. Os consentimentos têm uma validade limitada pelo banco (habitualmente 90 ou 180 dias); quando um consentimento caducar, volte a efetuar a ligação.

A lista de bancos provém do fornecedor de open banking configurado para a instância do Nordlet. Se o país não apresentar nenhum banco, significa que o fornecedor ainda não o abrange.

2. Associar as contas do banco

Na ligação, cada conta disponibilizada pelo banco é apresentada com o respetivo IBAN e moeda. Para cada uma, selecione uma conta bancária existente no razão ou Criar uma nova conta bancária, defina opcionalmente a data a partir da qual pretende sincronizar e prima Associar. Apenas as contas associadas são sincronizadas. Sem uma data de início de sincronização, a primeira sincronização obtém os últimos 90 dias.

3. Criar o modelo de importação

Em Banco → Modelos de importação, prima Novo modelo de importação, escolha o tipo Ligação bancária e atribua-lhe um nome. As linhas correspondem aos atributos que o canal (feed) do banco devolve por transação. A caixa Obrigatório no ficheiro é mantida por questão de integridade; um canal em direto não é validado contra a mesma.

Conta do razão. A linha de montante simples transaction_amount.amount e as linhas de regras podem ser associadas a uma conta do razão; cada transação sincronizada gerada a partir de uma linha associada é contabilizada de imediato e marcada como correspondida ao lançamento no diário. As linhas de regras selecionam transações por código de transação bancária ou direção:

Linha	Seleciona	Conta típica
Encargos bancários (código CHRG)	transações cuja família de códigos seja CHRG	gasto com comissões bancárias (6800 no plano padrão)
Juros (código INTR)	família de códigos INTR	proveitos ou custos de juros
Impostos (código TAXE)	família de códigos TAXE	pagamentos de impostos
Outras saídas de dinheiro	qualquer outro débito	deixar como "Não contabilizado" para que os pagamentos correspondam às faturas de compra
Outras entradas de dinheiro	qualquer outro crédito	deixar como "Não contabilizado" para que os recebimentos correspondam às faturas de venda
transaction_amount.amount	todas as transações não abrangidas por nenhuma regra	habitualmente "Não contabilizado"

Uma transação é contabilizada na conta da primeira linha com a qual corresponder: primeiro a família de códigos, depois a direção e, por fim, a linha de montante simples. O código provém de bank_transaction_code do banco; os bancos que não enviam nenhum deixam as linhas de código sem correspondências.

Criar clientes / fornecedores em falta. Selecione Criar clientes em falta na linha debtor.name para criar um cliente por cada pagador desconhecido de fundos recebidos, e Criar fornecedores em falta na linha creditor.name para cada beneficiário desconhecido de fundos enviados. Os parceiros são reconhecidos por IBAN (debtor_account.iban / creditor_account.iban, guardado nas contas bancárias do parceiro) e, em seguida, por nome exato; a um parceiro encontrado por nome é adicionado o IBAN. Um novo parceiro é uma empresa quando o seu nome contém uma forma jurídica (UAB, MB, SIA, GmbH, Ltd, …) e uma pessoa singular nos restantes casos.

Criar parceiro para o banco. Selecione esta opção na linha da regra de encargos bancários. A sincronização cria um fornecedor com o nome do banco conectado e regista todos os encargos no diário com esse parceiro.

Associar faturas por este campo. Selecione esta opção na linha remittance_information ou reference_number. Cada nova transação cujo texto de remessa ou referência contenha o número de uma fatura de venda emitida em aberto (entrada de dinheiro) ou de uma fatura de compra registada (saída de dinheiro) é associada à mesma e o pagamento é contabilizado. Quando o pagador é um parceiro conhecido, através de um IBAN guardado ou pelo nome exato ou código do parceiro, a fatura tem de pertencer a esse parceiro. Um pagamento de um pagador desconhecido apenas é associado quando coincide com o saldo remanescente e o número da fatura inclui o respetivo prefixo de série. Um pagamento superior ao saldo remanescente nunca é associado. As transações que falham estas verificações permanecem sem correspondência para que as possa reconciliar manualmente. A opção Criar faturas de adiantamento para recebimentos entrados sem correspondência converte um recebimento sem correspondência de um parceiro conhecido numa fatura de adiantamento emitida pelo montante, com data na do pagamento, à taxa de IVA indicada ou ao artigo de catálogo escolhido; requer a opção Criar clientes em falta para que o parceiro seja conhecido.

Guarde o modelo.

4. Aplicar o modelo e escolher a periodicidade

Novamente em Banco → Ligações, cada conta associada dispõe de um seletor de modelo e de um seletor de periodicidade. Escolha o modelo, selecione Sincronizar manualmente, Sincronizar diariamente, Sincronizar semanalmente ou Sincronizar mensalmente e prima Aplicar. Uma conta associada sem modelo continua a ser sincronizada, mas apenas regista as transações; nada é contabilizado, correspondido ou criado.

Com uma periodicidade diária, semanal ou mensal, a API sincroniza a conta de forma autónoma: de hora a hora, procura contas cuja última sincronização seja mais antiga do que o respetivo período (24 horas, 7 dias ou 30 dias) e sincroniza-as exatamente como faria a opção Sincronizar agora, executando o modelo de seguida. Uma sincronização agendada conta para os limites de utilização da mesma forma que uma sincronização manual (cada 10 transações obtidas equivalem a um pedido). Se o banco rejeitar a sincronização, por exemplo por o consentimento ter caducado, a ligação fica marcada com o erro e é ignorada até que volte a efetuar a ligação.

5. Sincronizar

Prima Sincronizar agora na ligação. O Nordlet obtém novas transações contabilizadas para cada conta associada; as transações pendentes são ignoradas até que o banco proceda à respetiva contabilização. A aplicação obtém-nas (desde a última sincronização, com uma sobreposição de uma semana para garantir que não se perdem movimentos tardios), regista-as uma única vez - as transações são reconhecidas pela referência de movimento do banco - e executa depois o modelo da conta. A linha de resultado indica quantas transações foram importadas e quantas já existiam; através da API, a sincronização devolve também o número de movimentos contabilizados, parceiros criados, faturas associadas e criadas, pagamentos correspondidos e avisos relativos a pagamentos que não puderam ser associados.

As sincronizações podem ser acionadas a partir da API (bank/feeds/sync) segundo uma calendarização; cada 10 transações obtidas contam como um pedido à API.

6. Onde consultar posteriormente

• Banco → Transações - todas as transações sincronizadas, com separadores por conta; as transações correspondidas incluem uma hiperligação para a fatura ou para o lançamento no diário.
• Faturas - faturas de adiantamento criadas para recebimentos sem correspondência.
• Parceiros - clientes e fornecedores criados, cada um com o IBAN registado nas respetivas contas bancárias.
• Razão → Diário - os lançamentos contabilísticos relativos a encargos (com o banco como parceiro), juros, impostos e pagamentos.

Quando a ligação deixa de funcionar

Uma sincronização que falhe marca a ligação com a mensagem de erro do banco. Um consentimento caducado é a causa mais comum: prima Conectar novamente para o mesmo banco e aprova o acesso; as contas associadas e os respetivos modelos são mantidos. A opção Desconectar remove a ligação e as respetivas associações de contas, mas não as transações já registadas.