Conectar o banco ao vivo – um guia de Scratch

Se você tiver um acordo com o seu banco, você pode receber transações de conta Direto do banco sem baixar um arquivo de declaração. o administrador do sistema estabelece a conexão uma vez abaixo Settings › Informações da empresa › Conectividades bancárias; As transações, em seguida, chegam no intervalo escolhido (ou com FETCH agora) e passe por O mesmo Mesmo que a mesma transação veja tanto da conexão como de um arquivo, nunca é escrito duas vezes.

1. O que faz e não faz

É Só leem do banco: lista de contas, balanço e transações. não envia pedidos de pagamento e não mova dinheiro.
Transacções de terra em curso no Transacções bancárias janela e estão correspondentes lá; você (ou a configuração de receita automática) ainda escreve a receita.
O serviço bancário mais velho que lê notificações por e-mail (e-mail/PDF A expressão é um caminho separado e continua a funcionar.

2. Métodos de conexão

Método	O que precisa	Status
Atividades bancárias abertas (ÖHVPS · Serviço de Informação de Conta)	Uma empresa não pode se conectar diretamente ao banco: precisa de uma licenciada YÖS (Provedor de Serviços de Pagamento) como intermediário, um consentimento aprovado na aplicação bancária e um token de acesso.	Atividade: se torna ativa com a YÖS acordo.
Serviço de transação de conta corporativa de bancos turcos (Garanti) BBVA, O Banco de İş, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, Banco do Sul, Kuveyt Türk)	Um ERP acordo de integração com a sucursal; nome de usuário/password de serviço web, número de cliente, permissão IP para o servidor (para Garanti BBVA um ID/secreto do cliente e um número de consentimento criado na banca na internet).	Enumera-se no catálogo; o motorista é concluído quando o banco envia o seu documento de serviço. até então o status é "Acordo bancário exigido".
Banco da Indonésia SNAP (BCA, Banco de Mandiri, BNI, BRI)	Registo no portal do desenvolvedor do banco e um contrato corporativo; X-CLIENT-KEY, O segredo do cliente, a chave pública de um RSA O par de chaves que geramos é dado ao banco, X-PARTNER-ID, CHANNEL-ID, Números de contas.	As assinaturas e pontos finais escritos para o padrão; o primeiro teste com um banco real vem após o acordo.
Simulação (banco de teste)	Nome do usuário `demo`, Ele nunca chega a um banco real; ele sempre produz as mesmas transações de amostra para cada dia.	Para reescrever a configuração e para a formação.

3. A chave de criptografia de credencial

A senha, o segredo do cliente e a chave privada dada pelo banco são escritas na base de dados. Criptografado (AES-256-GCM). A chave de criptografia não está na base de dados, mas no ambiente do servidor: HNR_BANKA_KIMLIK_ANAHTARI. A chave é mantida com a proteção de usuário do Windows (java\gpt\tls\banka-kimlik.dpapi.xml) e o lançador de nódulos fornece-o no começo. sem a chave, a tela avisa "A chave de criptografia de credenciamento não é definida"; credenciais não podem ser salvos e o banco não pode ser alcançado. Se as mudanças de chave, credenciais salvos não podem ser descriptografados - a tela diz "A chave de criptografia mudou" e as credenciais são inseridas novamente.

4. Construir uma conexão - 4 passos

Bancos e métodos de ligação: Settings › Informações da empresa › Conectividades bancárias › Nova conexão. Escolha o banco/metodo da lista; abaixo aparece o documento fonte e o Informações a solicitar do banco Lista — aplicável ao banco com esta lista.
Configurações e configurações de conexão: dê a conexão um nome, preencha os campos que o banco lhe deu e pressione Salve e continue. Os campos secretos (password, secreto, chave privada) nunca mais são mostrados após a salvação; a caixa lê "Salvado - digite um novo valor para alterá-lo".
Testes de conexão: Testes de conexão Insira no banco e traz a lista de contas e balanços. se isso sucede o status torna-se "Conectar está funcionando"; caso contrário, a razão é mostrada (sezione 7).
Ficha de conta e ficha: Além de cada conta bancária, escolha a conta em dinheiro/banco em HNR (Não há uma conta não emmarcada; uma HNR Cartões de conta para apenas uma conta bancária). 5-60 minutos, dias para voltar no primeiro feto 0-90. Se FETCH AUTOMÁTICO em Não é ticked, as transações chegam apenas com FETCH agora. Salve e feche.

Configure primeiro uma ligação de ensaio com o controlador Simulação, usando o utilizador demo: verá as quatro etapas, a obtenção e a correspondência, sem esperar por um banco real. Escreva linhas giris|amount|description|counterparty|tax id na caixa «Transações de exemplo» para testar a correspondência com as suas próprias faturas em aberto. Elimine a ligação depois do ensaio.

5. Fetching, a garda duplicada e o matching

Cada um dos clientes pede para as transações de Um dia antes o último sucesso de feto até hoje (no primeiro feto, tantos dias como "días para voltar"; na maioria 31 O dia de sobrecarga é deliberado: a mesma transação é reconhecida pela referência bancária, data, montante e direção, contada como uma duplicado e não escrito.
Novas transações no território Transacções bancárias janela com a fonte "Live" e são ajustados de uma vez (exato / sugestão / não ajustado). A receita automática não funciona durante o ganho ao vivo: você escreve as receitas de jogos exatos da janela.
Se você carregar a declaração do mesmo dia mais tarde como um MT940 arquivos também, as fileiras com o mesmo banco de referência mostram como duplicados.

6. Conhecimento automático e notificações

O feto automático é Desligado por default no servidor; o administrador do sistema o envia com BANKA_CANLI_GOREV=1. Quando em, cada conexão é sincronizada a seu próprio intervalo. após um erro o tempo de espera duplica em cada tentativa (na maioria dos casos). 6 horas) em Permanente erros como credenciais rejeitados, um acordo ausente ou configurações incompletas, retrases automáticas param e esperam para o administrador. Quando novas transações chegam, o administrador que estabelece a conexão recebe uma "... novas transações bancárias recebidas,... transações esperando para corresponder." mensagem em Mensagens; no terceiro erro consecutivo um alerta vem uma vez. Queimados A parte da tela do pulso.

7. Estatutos e razões de erro

em tela	Significado e o que fazer
Configurado, aguardando teste	Apresentação; Press Testes de conexão.
A conexão está funcionando	O último teste ou fetch foi bem sucedido.
Contrato com o banco necessário	Não há documento de serviço para este banco ainda, ou o banco não abriu o serviço. 2.
Credenciais recusadas	A senha/secreto/consentimento expirou ou está errada.Entre o novo valor e teste novamente.O retorno automático parou com este erro.
O banco não podia ser alcançado; o serviço bancário não responde temporariamente	Um problema temporário na rede ou no banco; retrasos de fogo automáticos em intervalos de crescimento.
Configurações da conexão incompletas	Um campo necessário é vazio, o endereço não é https ou não há cartografia de conta.

8. A tabela ao vivo e o log de sincronização

O que Transacções bancárias › Live tab mostra o estado de cada conexão, última sincronização, último sucesso de fetição, número de contas mapeadas e intervalos de fetição; o número vermelho no nome da tab é o número de conexões falhas. FETCH agora e abri o Síntese do log: Cada linha contém o tempo, a razão (manual / calendário / quando a janela é aberta / conexão teste), o status, o recebido, novo, duplicado, exato e sugestão contam e a mensagem de erro se houver.

9. Permissões e Segurança

Criação, mudança, eliminação e teste de conexões; FETCH agora E o log: Administrador de sistema apenas. Outros usuários com permissão bancária só vêem o status na guia Live.
As credenciais nunca são lidas de volta através da API; A tela mostra apenas um sinal "encriptado, salvo". se o valor criptografado é copiado para outra conexão ou empresa, não pode ser descripto.
Os endereços bancários só podem ser https://; As chamadas de leitura são feitas apenas para o banco; cada ação é escrita para a pista de auditoria (quem, quando, que IP).

10. No telefone

Na janela de transações bancárias, a terceira tab é Viva: cartões de conexão, status, última sincronização e um grande FETCH agora O botão.
No telefone, o formulário de conexão em Settings abre passo a passo: Banco → Credenciais → Testes → Contas.

11. Perguntas frequentes

Pergunta	Resposta
Posso inserir minha própria senha de banco na internet?	A conexão funciona com o usuário do serviço da web que tem problemas bancários separadamente para ERP Integração, ou com um consentimento bancário aberto. Nunca dê a sua senha bancária da internet a qualquer sistema.
O meu banco está na lista, mas o status é "Acordo bancário exigido".	O documento de serviço do banco ainda não foi integrado no controlador. Contacte a agência com a lista «Informações a pedir ao banco» da secção 2; quando o documento chegar, o controlador será concluído e o teste de ligação ficará disponível.
Por que as transações não chegam por si mesmas?	ou FETCH AUTOMÁTICO em não é ticked para a conexão, ou a tarefa de captura automática é desligada no servidor (não `BANKA_CANLI_GOREV=1`). A parte superior da tabela Live diz que aplica; no entanto, FETCH agora pode ser usado.
O que acontece com transações feitas se eu excluir a conexão?	Somente a conexão e as suas credenciais salvas são excluídas; transações, jogos e receitas escritas permanecem.

Guia relacionada: Transacções bancárias · Finanças · Settings · Mobiliário.