Sincronização com o banco
Nos bancos que oferecem extrato por API, a Kobana busca as movimentações e o saldo da conta diretamente no banco. A busca usa a conexão associada à conta de extrato (veja Contas de serviço).
Pré-requisitos
- Banco com extrato por API. Nos outros bancos, o item Extrato da aba Serviços fica desabilitado com a dica "Extrato não disponível para este banco."; use a importação de arquivos.
- Produto de extrato no plano.
- Conexão ativa associada à conta de extrato.
Configurar a sincronização automática
- Na tela da conta financeira, abra Serviços > Extrato.
- Se não houver conexão, clique em Associar Conexão e escolha uma conexão do mesmo banco.
- Clique em Editar configurações. A tela Editar Extrato Automático tem os campos abaixo.
- Clique em Atualizar. A mensagem "Serviço de Extrato atualizado com sucesso." confirma a alteração.
| Campo | Descrição |
|---|---|
| Tipo de Sincronização | Nenhum desliga a sincronização automática. Diária busca o extrato uma vez por dia. De 1h em 1h busca o extrato a cada hora; essa opção só aparece quando está habilitada para a sua conta. |
| Ignorar lançamentos futuros | Quando marcado, impede a gravação de lançamentos com data futura para esta conta. |
Quando você escolhe um tipo de sincronização, o cartão Extrato passa a mostrar Sincronização automática ativada em. Contas criadas com o produto de extrato no plano já começam com a sincronização Diária.
Horários
Os horários são de Brasília.
| Tipo | Quando roda |
|---|---|
| Diária | Todos os dias, às 8h. |
| De 1h em 1h | De segunda a sexta, de hora em hora das 7h às 19h, e uma vez no sábado às 8h. Não roda no domingo. |
A sincronização automática só roda para contas Kobana com assinatura ativa e conta de extrato com conexão. Se o banco estiver instável, a Kobana pode pular a sincronização daquele banco temporariamente; a próxima execução programada tenta de novo.
O tráfego de linhas de extrato é um serviço cobrado conforme o seu plano. Sem conexão associada à conta de extrato, a sincronização automática fica inativa e nada é cobrado.
Sincronizar manualmente
Na tela da conta financeira, abra o menu Ações:
| Ação | O que faz |
|---|---|
| Sincronizar Extrato | Pede ao banco o extrato da conta. Mensagem: "Comando de sincronização de extrato requisitado com sucesso.". |
| Sincronizar Saldo | Pede ao banco o saldo da conta. Mensagem: "Comando de Sincronização de Saldo requisitado com sucesso". |
As duas ações só aparecem quando a conexão de extrato está ativa e o banco oferece a operação. Cada pedido vira um comando, processado em segundo plano; acompanhe o andamento na aba Comandos da conta. Quando o comando termina, as linhas novas aparecem na aba Extrato e o saldo é atualizado no cartão lateral.
Permissões
| Ação | Módulo de permissão | Permissão |
|---|---|---|
| Ver a configuração do extrato | Financeiro > Contas de Extrato | Ações Básicas |
| Editar a configuração do extrato | Financeiro > Contas de Extrato | Alterar |
| Associar a conexão de extrato | Financeiro > Contas | Ativar API |
| Sincronizar Extrato e Sincronizar Saldo | Financeiro > Contas | Ativar API |
Eventos de webhook
| Evento | Quando |
|---|---|
financial.account.statement_sync.requested, .confirmed, .failed, .error | Andamento do comando de sincronização de extrato. |
financial.account.balance_sync.requested, .confirmed, .failed, .error | Andamento do comando de sincronização de saldo. |
financial.account.statement.updated | O extrato da conta foi atualizado. |
financial.account.balance.updated | O saldo atual da conta mudou. |
Veja o formato dos eventos em Webhooks.
Pela API
A sincronização de extrato também pode ser solicitada pela API v2.