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
- Em Sistema › Integrações › Marketplace, abra o cartão do banco conectado e use Editar. A janela abre na aba Extrato.
- Clique em Ligar.
- Escolha a Conta do extrato (a conta bancária do Tesselys que recebe as linhas).
- Escolha a Categoria das tarifas. As tarifas que vierem no extrato viram despesa nessa categoria; vazio usa a categoria padrão.
- Em Credencial, use a mesma credencial da cobrança (recomendado) ou outra credencial.
- Se quiser, abra os Ajustes da sincronização (os padrões servem para a maioria das contas).
- 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.
- 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
| Ajuste | Padrão | Limites |
|---|---|---|
| Buscar a cada (minutos) | 60 | de 30 a 1440 |
| Só em horário comercial | Ligado | De segunda a sexta, das 7h às 20h (horário de Brasília). |
| Dias para trás em cada busca | 5 | de 1 a 31 |
| Janela de busca do título (dias) | 5 | de 0 a 31. É a tolerância de datas para procurar o título de cada linha. |
| Dar baixa automática | Ligado | |
| Lançar as tarifas | Ligado | |
| Avisar o que ficar pendente | Ligado | |
| Ler extrato CNAB (só Efí) | Ligado | Traz 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:
- 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).
- 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.
- Soma exata de títulos em aberto da mesma pessoa, quando só existe uma combinação possível: dá baixa em todos e concilia.
- 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ção | O que faz |
|---|---|
| Sincronizar agora | Busca o extrato na hora e mostra o resultado: novas, repetidas ignoradas, conciliadas sozinhas e tarifas lançadas. |
| Tentar baixa automática | Roda 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ções | Lista cada busca com origem (Agendada, Manual ou Ao ligar), situação (Em andamento, Concluída, Parcial, Falhou, Pulada), período e resultado. |
| Ajustes do extrato | Leva 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:
| Aviso | Quando |
|---|---|
| Extrato automático com erro | Na 3ª falha seguida de leitura. A mensagem traz o código que o banco devolveu. |
| Extrato em período fechado | Quando 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 fechou | Quando 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 vencendo | Quando 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
| Regra | O que acontece |
|---|---|
| Linha repetida | Uma linha que já chegou pelo extrato automático não entra de novo, nem por OFX. |
| Período fechado | Linhas 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ática | Só concilia o que casa com valor exato. O resto fica pendente. |
| Sincronizar duas vezes ao mesmo tempo | Recusado: "Já existe uma sincronização do extrato em andamento para esta conta. Aguarde alguns minutos." |
| Tentar baixa automática em período fechado | Recusado: "O período desta conciliação está fechado." |
| Ajustes fora dos limites | Recusados (intervalo de 30 a 1440 minutos, dias para trás de 1 a 31, janela de 0 a 31). |
| Saldo no banco | Ver 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ção | Permissão necessária |
|---|---|
| Ligar, configurar, desligar (Marketplace) | Editar na configuração do provedor |
| Sincronizar agora, Tentar baixa automática | Editar em Conciliação Bancária |
| Histórico de sincronizações | Leitura 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.
A nossa equipe ajuda você a configurar e usar esse recurso.