Pular para o conteúdo principal

Extrato automático (integração bancária)

Para que serve​

Nos bancos integrados, o Tesselys busca o extrato da conta sozinho, sem você exportar arquivo. A cada busca, ele grava as linhas na conciliação do mês, sem duplicar, lança as tarifas bancárias como despesa e dá baixa no que casa com certeza com os títulos em aberto. O que não casar fica pendente, para você tratar na Conciliação Bancária.

Onde fica​

  • Ligar e ajustar: Sistema › Integrações › Marketplace, no cartão do banco conectado, ação Editar, aba Extrato.
  • Acompanhar: Financeiro › Conciliação Bancária, na conciliação da conta. Se o módulo não aparecer na raiz de Módulos, procure em Módulos › Ver todos.

Antes de começar​

  • O extrato automático existe para Cora, Sicoob, Inter, Efí e Asaas. Nos outros provedores, a aba avisa "Este banco não oferece extrato automático pela API."
  • O banco precisa estar conectado no Marketplace (veja Bancos e gateways de pagamento).
  • A conta bancária que vai receber as linhas precisa estar cadastrada em Financeiro › Conta Bancária (veja Contas Bancárias).
  • Se quiser as tarifas numa categoria própria, crie-a antes em Financeiro › Categoria Financeira.
  • Você precisa de permissão de editar na configuração do provedor (no Marketplace) e na Conciliação Bancária.

Como ligar​

  1. Em Sistema › Integrações › Marketplace, abra o cartão do banco conectado e use Editar. A janela abre na aba Extrato.
  2. Clique em Ligar.
  3. Escolha a Conta do extrato (a conta bancária do Tesselys que recebe as linhas).
  4. Escolha a Categoria das tarifas. As tarifas que vierem no extrato viram despesa nessa categoria; vazio usa a categoria padrão.
  5. Em Credencial, use a mesma credencial da cobrança (recomendado) ou outra credencial.
  6. Se quiser, abra os Ajustes da sincronização (os padrões servem para a maioria das contas).
  7. Clique em Testar e ligar. O banco testa a conexão antes de salvar. Se recusar, a tela avisa O banco recusou a conexão.
  8. Ligado, aparece Extrato automático ligado: o extrato do mês começa a chegar em segundo plano e pode levar alguns minutos.

Depois de ligado, o cartão da aba mostra a conta, a categoria das tarifas, a credencial, a data em que foi ligado e a Última leitura no banco. Para mudar algo, use Configurar. Ao trocar a credencial, o banco testa de novo antes de salvar, e o histórico do extrato não se perde.

Ajustes da sincronização​

AjustePadrãoLimites
Buscar a cada (minutos)60de 30 a 1440
Só em horário comercialLigadoDe segunda a sexta, das 7h às 20h (horário de Brasília).
Dias para trás em cada busca5de 1 a 31
Janela de busca do título (dias)5de 0 a 31. É a tolerância de datas para procurar o título de cada linha.
Dar baixa automáticaLigado
Lançar as tarifasLigado
Avisar o que ficar pendenteLigado
Ler extrato CNAB (só Efí)LigadoTraz do arquivo diário do banco o que a API não traz: boleto e bolix liquidados, tarifas e TED. O agendamento do arquivo no banco é feito automaticamente.

Como a busca funciona​

  • A cada 30 minutos o sistema verifica as contas com extrato ligado e busca o dia de hoje nas que já passaram do intervalo de Buscar a cada. Com Só em horário comercial, a busca fica entre 7h e 20h, de segunda a sexta.
  • Todo dia, às 6h30, ele relê os Dias para trás até ontem, porque o banco às vezes lança com data retroativa. Reler não duplica: uma linha que já chegou é reconhecida e ignorada.
  • Cada linha vai para a conciliação da conta que cobre aquele dia. Se ainda não existir, a conciliação do mês é criada sozinha.
  • Com Lançar as tarifas, cada tarifa do extrato vira uma despesa já conciliada, com o título "Tarifa bancária (banco) — (descrição)".

O que a baixa automática concilia​

Com Dar baixa automática ligado, o sistema só concilia quando o valor bate centavo a centavo, e para na primeira regra que resolve:

  1. Recebimento já baixado pelo gateway (por exemplo, boleto pago): só concilia, sem baixar de novo. Vale também para o crédito em lote da cobrança, quando o banco credita de uma vez a soma dos boletos pagos num dia (até 4 dias antes da linha).
  2. CPF ou CNPJ da linha igual ao da pessoa do título, com um único título desse valor na janela: dá baixa e concilia.
  3. Soma exata de títulos em aberto da mesma pessoa, quando só existe uma combinação possível: dá baixa em todos e concilia.
  4. Pagamento enviado pelo próprio Tesselys (veja Pagamento automático): a saída com o valor exato do título enviado, perto da data do pagamento, é conciliada.

Só entram títulos desta conta, ainda não conciliados. Despesas no cartão de crédito ficam de fora, porque saem na fatura. O que não casar fica pendente, e você pode pedir sugestões na conciliação.

Onde acompanhar​

Na tela de trabalho da conciliação da conta, uma faixa Extrato automático mostra:

  • Última sincronização (ou Ainda não sincronizou) e Saldo no banco;
  • a situação do mês: Mês aberto, Mês fechado · saldo confere ou Mês fechado · diferença de saldo;
  • se a baixa automática está Ligada ou Desligada;
  • o aviso A última sincronização falhou, quando for o caso.

As linhas que o sistema conciliou sozinho levam a marca Conciliado automaticamente.

Ações da faixa:

AçãoO que faz
Sincronizar agoraBusca o extrato na hora e mostra o resultado: novas, repetidas ignoradas, conciliadas sozinhas e tarifas lançadas.
Tentar baixa automáticaRoda de novo as regras de baixa automática nas linhas pendentes, lança as tarifas e gera sugestões para o resto. Não aparece em conciliação concluída e não funciona em período fechado.
Histórico de sincronizaçõesLista cada busca com origem (Agendada, Manual ou Ao ligar), situação (Em andamento, Concluída, Parcial, Falhou, Pulada), período e resultado.
Ajustes do extratoLeva ao Marketplace, onde ficam os ajustes.

O saldo lido no banco também aparece nos detalhes da conta bancária, em Saldo atual em conta.

Avisos​

Os avisos vão como notificação para os usuários com papel Dono da empresa:

AvisoQuando
Extrato automático com erroNa 3ª falha seguida de leitura. A mensagem traz o código que o banco devolveu.
Extrato em período fechadoQuando chegam linhas de um mês com período fechado: "(N) linha(s) do extrato de (mês) não entraram porque o período está fechado. Reabra o período para recebê-las."
Extrato do mês não fechouQuando o saldo do banco não bate com a soma das linhas do mês: "O extrato de (mês) não fechou: diferença de R$ (valor) entre o saldo do banco e as linhas."
Certificado vencendoQuando a credencial própria do extrato usa certificado, a 30, 15, 7 e 1 dia do vencimento. Com a credencial da cobrança, o aviso é o do gateway.

Desligar​

Em Sistema › Integrações › Marketplace › Editar › aba Extrato, use Desligar e confirme. O extrato deixa de chegar sozinho. Nada é apagado: extrato, histórico e conciliações continuam, e dá para ligar de novo quando quiser.

Regras importantes​

RegraO que acontece
Linha repetidaUma linha que já chegou pelo extrato automático não entra de novo, nem por OFX.
Período fechadoLinhas de um mês com período fechado não entram, e os donos são avisados. Reabra o período para recebê-las (veja Fechamento de período).
Baixa automáticaSó concilia o que casa com valor exato. O resto fica pendente.
Sincronizar duas vezes ao mesmo tempoRecusado: "Já existe uma sincronização do extrato em andamento para esta conta. Aguarde alguns minutos."
Tentar baixa automática em período fechadoRecusado: "O período desta conciliação está fechado."
Ajustes fora dos limitesRecusados (intervalo de 30 a 1440 minutos, dias para trás de 1 a 31, janela de 0 a 31).
Saldo no bancoVer o saldo lido no banco exige permissão de leitura no Financeiro. Se o banco não responder: "Não foi possível ler o saldo no banco agora. Tente de novo em alguns minutos."

Permissões​

AçãoPermissão necessária
Ligar, configurar, desligar (Marketplace)Editar na configuração do provedor
Sincronizar agora, Tentar baixa automáticaEditar em Conciliação Bancária
Histórico de sincronizaçõesLeitura em Conciliação Bancária
Ajustes do extrato (atalho da faixa)Editar na configuração do provedor

Perguntas frequentes​

Liguei e o extrato não apareceu.​

A primeira busca roda em segundo plano e pode levar alguns minutos. Confira em Histórico de sincronizações se ela terminou ou falhou. Se a última sincronização falhou, a faixa do extrato avisa.

O sistema vai dar baixa em títulos errados?​

A baixa automática só acontece quando o valor bate exatamente e a regra identifica um único título (ou uma única combinação). O resto fica pendente. Se quiser conferir tudo à mão, desligue Dar baixa automática nos ajustes.

Preciso continuar importando OFX?​

Não para a conta com extrato automático. Se importar mesmo assim, as linhas que já vieram do banco são ignoradas.

O extrato não busca à noite nem no fim de semana.​

Só em horário comercial está ligado: a busca fica entre 7h e 20h, de segunda a sexta. A releitura das 6h30 recupera o que o banco lançou fora desse horário. Desligue o ajuste se quiser buscas o tempo todo.

Recebi "Extrato em período fechado".​

O período daquele mês está fechado e as linhas não entraram. Reabra o período em Financeiro › Período, use Sincronizar agora e refeche depois.

Recebi "Extrato do mês não fechou".​

O saldo informado pelo banco não bate com o saldo de abertura mais as linhas do mês. Confira se falta alguma linha (por exemplo, tarifa ou boleto que só vem pelo arquivo CNAB) e se o saldo de abertura da conta está certo.

Recebi "Extrato automático com erro".​

O banco recusou a leitura três vezes seguidas. Confira a credencial e o certificado no Marketplace (Configurar › Trocar credencial) e use Sincronizar agora para testar.

Desligar apaga o que já veio?​

Não. Extrato, histórico e conciliações continuam.

Ainda com dúvida?

A nossa equipe ajuda você a configurar e usar esse recurso.