Contas financeiras
A conta financeira liga uma conta bancária da sua empresa à Kobana. Ela guarda os dados bancários e do titular, o saldo e o extrato, e serve de base para as carteiras de cobrança, os pagamentos e as transferências feitos a partir dessa conta. Você pode cadastrar várias contas financeiras, inclusive de bancos diferentes.
Onde fica no painel
Financeiro > Contas > Gerenciar abre a lista Contas Financeiras. Cada linha mostra:
| Coluna | Conteúdo |
|---|---|
| Conta Financeira | Nome da conta (ou agência e conta, quando não há nome). Contas incompletas aparecem como "Conta em rascunho". |
| Provedor | Banco ou provedor da conta. |
| Tipo | Conta Corrente, Conta Poupança ou Conta Pagamento. |
| Última atualização | Data e hora da última atualização do saldo. |
| Saldo | Saldo atual da conta. |
No topo da lista, Saldo Consolidado soma o saldo de todas as contas listadas.
Cadastrar uma conta financeira
- Em Financeiro > Contas > Gerenciar, clique em Nova Conta Financeira.
- Escolha o banco e preencha os dados abaixo.
- Clique em Criar Nova Conta Financeira.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Banco | Sim | Banco da conta, escolhido na lista "Escolha um Banco". |
| Selecione a modalidade | Quando aparece | Alguns bancos têm mais de uma modalidade de integração; nesse caso a tela pede que você escolha uma. |
| Número da Agência | Sim | Somente números, até 5 dígitos. |
| Dígito (agência) | Depende do banco | Obrigatório nos bancos que usam dígito de agência. |
| Número da Conta | Sim | Somente números, até 15 dígitos. |
| Dígito (conta) | Sim | Dígito verificador da conta. Aceita números ou "X". |
| Tipo | Sim | Conta Corrente, Conta Poupança ou Conta Pagamento. |
| CNPJ | Sim | Documento do titular da conta, em Dados do Titular da Conta. Ao digitar o CNPJ, a tela tenta preencher a razão social. |
| Razão social | Sim | Nome do titular da conta. |
Depois de salvar, o painel abre a tela da conta com a mensagem "Conta Financeira cadastrada com sucesso.".
O que acontece no cadastro
- Se você não informar um nome, a conta recebe um nome no formato "Banco CC: conta-dígito". Você pode trocá-lo depois em Alterar.
- Junto com a conta financeira são criadas uma conta de pagamento, uma conta de transferência e uma conta de extrato, ainda sem conexão com o banco. Veja Contas de serviço.
- O evento
financial.account.db.createdé emitido.
Regras
- O mesmo número de conta não pode ser cadastrado duas vezes para o mesmo banco na mesma conta Kobana.
- O banco não pode ser alterado depois do cadastro. Para trocar de banco, cadastre outra conta financeira.
- Bancos sem integração disponível podem ser cadastrados, mas na aba Serviços os itens Pagamentos, Transferências e Extrato ficam desabilitados, e carteiras de cobrança não podem ser criadas para essa conta.
A tela da conta financeira
Clique no nome da conta na lista para abrir a tela de detalhes. O cabeçalho mostra banco, agência e conta, e o menu Ações tem as operações da conta. A tela tem as abas:
| Aba | O que mostra |
|---|---|
| Extrato | Linhas de extrato da conta. Veja Extrato. |
| Importações | Arquivos de extrato importados. Veja Importação de extrato. |
| Saque Automático | Configuração do saque automático. Veja Saque automático. |
| Comandos | Comandos enviados ao banco para esta conta, como as sincronizações de extrato e de saldo. Só aparece em contas de bancos com integração. |
| Serviços | Carteiras de cobrança (Recebimento de Boleto), Extrato, Pagamentos e Transferências desta conta. Veja Contas de serviço. |
A coluna lateral mostra o saldo (veja Saldo), o UID da conta com botão para copiar, agência, conta, tipo, CNPJ, razão social e as datas da última sincronização do extrato e da última atualização do saldo.
Alterar uma conta financeira
Em Ações > Alterar:
| Campo | Descrição |
|---|---|
| Nome da Conta | Identificação da conta dentro da Kobana. Até 120 caracteres. |
| Nome / Razão social | Nome do titular. |
| CPF/CNPJ | Documento do titular. |
| Número da Agência e Dígito | Dados da agência. |
| Número da Conta e Dígito | Dados da conta. |
Clique em Atualizar. Quando agência, conta ou dígitos mudam, as carteiras de cobrança vinculadas a esta conta financeira recebem os novos dados. Se a mudança não for válida para alguma carteira, a alteração não é salva e a tela mostra o motivo. Cada alteração emite o evento financial.account.db.updated.
Excluir uma conta financeira
Em Ações > Excluir, o painel lista o que será excluído junto com a conta: carteiras de boleto, transações de extrato, comandos, arquivos retorno (CNAB), saldos, importações de extrato e de transferência, transferências e lotes de transferência, pagamentos e lotes de pagamento, URLs de callback e a conta de pagamento.
Para confirmar, marque TENHO CERTEZA que quero APAGAR a conta financeira e clique em APAGAR Permanentemente. A operação é definitiva. A remoção roda em segundo plano e pode levar alguns instantes: recarregue a página para confirmar. Ao final, o evento financial.account.db.deleted é emitido.
Caixa Postal EDI
O menu Ações também tem a seção Caixa Postal EDI, com Ver Caixas Postais e Configurar EDI, para configurar a troca automática de arquivos de remessa e retorno da conta com o banco.
Permissões
As telas de contas financeiras exigem o produto de contas financeiras no plano e as permissões do módulo Financeiro > Contas:
| Ação | Permissão |
|---|---|
| Ver lista, extrato, importações, comandos e serviços | Ações Básicas |
| Cadastrar conta | Criar |
| Alterar conta | Alterar |
| Excluir conta | Excluir |
| Sincronizar extrato e saldo, associar a conexão de extrato | Ativar API |
Eventos de webhook
| Evento | Quando |
|---|---|
financial.account.db.created | Conta financeira cadastrada. |
financial.account.db.updated | Conta financeira alterada. |
financial.account.db.deleted | Conta financeira excluída. |
Veja o formato dos eventos em Webhooks.
Pela API
As contas financeiras podem ser cadastradas e consultadas pela API v2.