Contas de transferência
A conta de transferência é o serviço de uma conta financeira que habilita transferências. Ela liga a conta financeira de origem a uma conexão com o banco e guarda as configurações de envio: número do convênio, remessa e validação de saldo. Toda transferência sai por uma conta de transferência.
Uma conta financeira pode ter mais de uma conta de transferência, por exemplo quando o banco emite uma credencial para TED e outra para Pix.
A Kobana não guarda uma agenda de favorecidos. Os dados do beneficiário (nome, CPF/CNPJ, chave Pix ou dados bancários) são informados em cada transferência.
Onde fica no painel
Financeiro > Contas > Gerenciar, abra a conta financeira, aba Serviços, item Transferências.
O item Transferências aparece desabilitado, com a dica "Transferências não disponíveis para este banco.", quando o banco da conta financeira não está integrado à Kobana.
Se ainda não há conta de transferência, a tela mostra "Ainda não há contas de transferência vinculadas a esta conta financeira." e o botão Nova Conta de Transferência. Com contas já criadas, cada uma aparece em um cartão com o botão Nova Conta e o botão Editar configurações.
Campos
| Campo | Obrigatório | Descrição |
|---|---|---|
| Número do Convênio de Transferência | Não | Código do convênio de transferência fornecido pelo banco, quando o banco exige. |
| Remessa habilitada | Não | Quando ativa, permite geração de arquivos de remessa. Desative para contas que operam apenas via API. |
| Validação de Saldo Habilitada | Não | Quando ativa, o saldo disponível é verificado antes de enviar transferências, impedindo operações sem fundos suficientes. |
Alguns bancos pedem campos próprios, que aparecem no mesmo formulário (por exemplo, CNPJ da Cooperativa e Número do Ponto de Atendimento).
O cartão da conta de transferência mostra ainda o UID, com botão para copiar, e a Conexão associada. Use Associar Conexão (quando não há conexão) ou Alterar Conexão para escolher a conexão com o banco. Uma conexão desabilitada aparece com um ícone de alerta.
Validação de saldo
Com Validação de Saldo Habilitada, a Kobana compara o valor da transferência com o saldo atual da conta financeira:
- na criação, a transferência é recusada com a mensagem "Saldo insuficiente" quando o valor passa do saldo;
- na edição, só o aumento de valor é verificado: a diferença entre o valor novo e o anterior não pode passar do saldo.
Com a validação desligada, a transferência é criada sem consultar o saldo.
Passo a passo
- Abra a conta financeira em Financeiro > Contas > Gerenciar.
- Vá na aba Serviços e clique em Transferências.
- Clique em Nova Conta de Transferência (ou Nova Conta, se já existir outra).
- Preencha os campos e clique em Criar Conta de Transferência.
- No cartão da conta criada, clique em Associar Conexão e escolha a conexão com o banco.
Para alterar uma conta existente, clique em Editar configurações, ajuste os campos e clique em Atualizar.
Permissões
Módulo Financeiro, produto Contas de Transferência: Ações Básicas para ver, Criar para criar e Alterar para editar. A conta também precisa do produto Transferências contratado.
Pela API
Contas de transferência têm endpoints de listagem, consulta, criação e alteração na API v2.