Omoplata - Documentação

O Omoplata se integra diretamente ao seu banco por meio do protocolo FinTS, que é suportado pela maioria dos bancos alemães. Isso permite buscar transações bancárias, conciliar pagamentos recebidos com faturas em aberto automaticamente e reconciliar sua contabilidade -- tudo sem sair do aplicativo.

O que é FinTS

O FinTS é um padrão bancário seguro usado principalmente por bancos alemães. Ele permite que o Omoplata se comunique com o seu banco para buscar extratos de conta, ver saldos e conciliar pagamentos. A maioria dos grandes bancos alemães suporta o FinTS.

As credenciais do seu banco são armazenadas com segurança no Omoplata, criptografadas com um código de segurança que você escolhe durante a configuração.

Conectando sua conta bancária

Para configurar a conexão bancária, vá até as configurações do FinTS e siga estes passos:

Passo 1: Inserir credenciais

Preencha os seguintes campos:

Campo	Descrição
URL do banco	a URL do endpoint FinTS do seu banco (o seu banco fornece isso).
Código do banco	o número de roteamento do seu banco (Bankleitzahl).
Nome de usuário	seu nome de usuário do banco online.
Senha	sua senha do banco online.

Clique em Salvar. Um modal solicitará que você crie um código de segurança. Esse código de segurança criptografa suas credenciais e será exigido toda vez que você realizar uma operação bancária.

Após salvar, o Omoplata se conecta ao seu banco e busca os modos de TAN disponíveis e as contas bancárias. Se a conexão falhar, nenhum dado é armazenado e você verá uma notificação de erro.

Passo 2: Configurar TAN e conta

Uma vez estabelecida a conexão, um segundo formulário aparece, onde você pode selecionar:

Opção	Descrição
Modo TAN	o método de autenticação que seu banco usa (por exemplo, pushTAN, chipTAN ou SMS-TAN).
Meio de TAN	o dispositivo ou número de telefone específico usado para a entrega do TAN.
Conta padrão	qual conta bancária usar nas transações.

Essas opções podem ser salvas e alteradas independentemente das credenciais.

Modos TAN desacoplados

Se o seu banco usa um modo TAN desacoplado, como pushTAN, o Omoplata mostra um modal pedindo que você confirme a operação no seu aplicativo bancário. O modal pode consultar o banco automaticamente em busca da confirmação ou deixar você acionar a verificação manualmente.

Importando transações bancárias

Uma vez conectado, você pode buscar transações bancárias diretamente da página do FinTS. O processo de importação funciona assim:

Navegue até Finanças > Integração bancária (a página do FinTS).
Insira seu código de segurança para descriptografar as credenciais armazenadas.
Acione a busca de um extrato bancário. Se a autenticação por TAN for necessária, siga as instruções.
O Omoplata baixa suas transações bancárias recentes e as armazena localmente.

Formato do extrato

O Omoplata suporta dois formatos de extrato bancário:

Formato	Descrição
CAMT (padrão)	o formato moderno suportado pela maioria dos bancos. Fornece dados mais ricos, incluindo referências de pagamento e informações detalhadas das partes.
MT940 (legado)	um formato mais antigo. Disponível como alternativa caso o seu banco não suporte CAMT.

O padrão é CAMT. Você pode alterar o formato nas configurações do FinTS se o seu banco exigir.

Conciliação automática de transações

Depois que as transações bancárias são importadas, o Omoplata tenta conciliar automaticamente os pagamentos recebidos (créditos) com faturas em aberto. O sistema usa um pipeline de conciliadores, cada um com uma estratégia e um nível de confiança diferentes.

Como funciona a conciliação

A conciliação é executada automaticamente após cada importação. O Omoplata processa os pagamentos recebidos e os compara com as faturas em aberto (pendente, pendente de nova tentativa, enviada ao banco, vencida ou em espera).

Estratégias de conciliação

O Omoplata usa três estratégias de conciliação, aplicadas em ordem de confiabilidade:

1. Conciliação por ID end-to-end (maior confiança)

Quando um pagamento SEPA é feito com um ID end-to-end que referencia uma fatura (por exemplo, INV-1000042), esse conciliador encontra a fatura exata. Confiança: 90-100%.

2. Conciliação por IBAN (alta confiança)

Compara o IBAN do remetente com os dados bancários armazenados nos métodos de pagamento dos seus alunos. Se o IBAN corresponder e o valor estiver correto, a fatura é identificada. Confiança: 85-95%.

3. Conciliação por nome e valor (alternativa)

Para pagamentos sem um IBAN ou ID end-to-end reconhecível, o sistema busca faturas com um valor correspondente e então pontua a semelhança de nome entre o remetente e seus alunos. Isso suporta variações como a ordem "Sobrenome Nome", comum em transferências bancárias alemãs. Confiança: 50-80%.

Limiares de confiança

A pontuação de confiança determina o que acontece com cada conciliação:

Confiança	Ação
95% ou mais	Confirmada automaticamente. A fatura é marcada como paga.
70% a 94%	Revisão pendente. Exibida no painel de conciliação para confirmação manual.
Abaixo de 70%	Baixa confiança. Ainda é armazenada para revisão, mas com menor probabilidade de estar correta.

A conciliação automática economiza tempo

Conciliações de alta confiança são confirmadas automaticamente, então as faturas pagas por transferência bancária são liquidadas sem nenhum trabalho manual. Você só precisa revisar as conciliações em que o sistema está menos certo.

Conciliação manual e reconciliação

Para conciliações que não são autoconfirmadas, ou para transações que o sistema não conseguiu conciliar de jeito nenhum, você pode reconciliar manualmente.

Revisando conciliações pendentes

A página de transações bancárias mostra as transações importadas junto com seu status de conciliação. Para cada conciliação pendente, você pode:

Ação	Descrição
Confirmar	aceitar a conciliação. A fatura é marcada como paga e quaisquer outras conciliações pendentes para a mesma transação são rejeitadas.
Rejeitar	descartar a conciliação. A transação permanece não conciliada e pode ser emparelhada com uma fatura diferente.

Status de conciliação

Status	Significado
Pendente	Precisa de revisão manual.
Confirmada	Confirmada manualmente por um aluno da equipe.
Rejeitada	Rejeitada manualmente.
Conciliada automaticamente	Confirmada automaticamente por alta confiança.

Estatísticas de transações bancárias

A página de transações bancárias mostra estatísticas resumidas para ajudar você a entender o estado da sua reconciliação:

Quantas transações foram importadas na busca atual.
Quantas foram conciliadas (automática ou manualmente).
Quantas ainda estão pendentes de revisão.

Fluxo de autenticação do FinTS

As operações do FinTS autenticam em etapas. Veja o que acontece quando você aciona qualquer ação bancária:

Um modal solicita o código de segurança que você criou durante a configuração. Isso descriptografa as credenciais bancárias armazenadas.
A ação é executada usando as credenciais descriptografadas.
Se o banco exigir autenticação de dois fatores (TAN), o sistema pausa a operação e armazena a ação pendente.
Dependendo do seu modo TAN:
- TAN desacoplado (pushTAN): um modal pede que você confirme no seu aplicativo bancário. O Omoplata pode consultar o banco automaticamente ou esperar você clicar em um botão de verificação.
- TAN clássico (chipTAN, SMS-TAN): uma imagem ou código de desafio é exibido e você insere o TAN manualmente.
Após a verificação do TAN, a ação armazenada é retomada e concluída.
O resultado é retornado e a interface é atualizada de acordo.

Mantenha seu código de segurança em segurança

O código de segurança que você cria criptografa suas credenciais bancárias. Se você esquecê-lo, precisará inserir novamente suas credenciais bancárias e criar um novo código de segurança. O Omoplata não armazena o código de segurança em si e não pode recuperá-lo para você.

Códigos de erro do FinTS

Ao se comunicar com o seu banco, o FinTS pode retornar códigos de erro. O Omoplata mostra uma notificação com a descrição do problema e um link para a seção relevante abaixo.

Erros de autenticação e PIN

9942 PIN inválido

O PIN armazenado não corresponde mais ao PIN do seu banco online. Atualize-o em Configurações > Cobrança > FinTS. A maioria dos bancos bloqueia seu acesso após 3 tentativas malsucedidas, então verifique seu PIN no banco online primeiro.

9930 PIN bloqueado

Seu PIN está bloqueado ou o modo TAN selecionado não corresponde ao contrato do seu banco. Entre em contato com seu banco para desbloquear, ou verifique se o modo TAN nas configurações do FinTS corresponde ao que seu banco suporta.

9931 Acesso bloqueado

Seu acesso ao FinTS foi bloqueado após tentativas malsucedidas em excesso. Apenas o seu banco pode desbloqueá-lo -- entre em contato diretamente com ele.

9933 Banco online bloqueado

Todo o seu acesso ao banco online está bloqueado, afetando o FinTS, o banco online e os terminais de autoatendimento. Entre em contato com seu consultor bancário para reativá-lo.

9941 TAN inválido

O TAN que você inseriu está incorreto. Verifique se há erros de digitação e tente novamente. Entradas erradas repetidas podem bloquear seu acesso.

9943 TAN já utilizado

Cada TAN é de uso único. Reinicie a operação para gerar um novo desafio de TAN.

9951 TAN expirado

O desafio de TAN expirou (os bancos normalmente permitem de 5 a 30 minutos). Reinicie a operação e envie o TAN prontamente.

Erros de SEPA e de ordem

9210 Ordem rejeitada (validação)

O banco rejeitou a ordem devido a um erro de validação -- por exemplo, um IBAN inválido, data de execução errada ou campos ausentes no arquivo SEPA. Revise os detalhes do arquivo e tente novamente.

9230 Limite de crédito excedido

O valor total excede o limite de crédito de débito direto da sua conta. Entre em contato com seu banco para aumentar o limite ou divida o arquivo SEPA em lotes menores.

9380 Não autorizado para SEPA

Sua conta bancária não está autorizada para débitos diretos SEPA via FinTS. Entre em contato com seu banco para habilitar esse tipo de transação na sua conta.