Contas de serviço

Cada conta financeira tem contas de serviço, uma para cada uso da conta bancária. Cada conta de serviço tem a sua própria conexão com o banco, ou seja, as credenciais de API usadas naquela operação.

Conta de serviço	Para que serve
Conta de pagamento	Pagar boletos, contas de consumo, tributos e Pix a partir da conta financeira.
Conta de transferência	Fazer transferências Pix, TED e entre contas a partir da conta financeira. Também é usada pelo saque automático.
Conta de extrato	Buscar o extrato e o saldo no banco. Veja Sincronização com o banco.

As carteiras de cobrança (boleto) também ficam vinculadas à conta financeira e aparecem na mesma aba; elas são tratadas na seção de boletos.

Ao cadastrar uma conta financeira, a Kobana cria uma conta de pagamento, uma conta de transferência e uma conta de extrato, todas sem conexão. Para usar o serviço, associe uma conexão a ele.

Onde fica no painel

Na tela da conta financeira, abra a aba Serviços. O menu à esquerda tem:

• Recebimento de Boleto: carteiras de cobrança da conta.
• Extrato: a conta de extrato. Só aparece com o produto de extrato no plano; fica desabilitado com a dica "Extrato não disponível para este banco." quando o banco não oferece extrato por API.
• Pagamentos: contas de pagamento. Só aparece com o produto de pagamentos no plano e a permissão de contas de pagamento.
• Transferências: contas de transferência. Só aparece com o produto de transferências no plano e a permissão de contas de transferência.

Pagamentos e Transferências ficam desabilitados, com a dica "não disponíveis para este banco", em contas de bancos sem integração.

Contas de pagamento e de transferência

Cada conta aparece num cartão com:

Item	Descrição
UID	Identificador da conta de serviço, com botão para copiar.
Conexão	Conexão associada, ou "Não associada". Um ícone de alerta indica conexão desabilitada.
Número do Convênio de Pagamento / de Transferência	Convênio informado, ou "Não configurado".
Remessa habilitada	Ativo ou Inativo.
Validação de Saldo Habilitada	Ativo ou Inativo.
Dados para o provedor	Campos adicionais exigidos por alguns bancos.

Uma conta financeira pode ter mais de uma conta de pagamento ou de transferência, por exemplo, uma para cada convênio com o banco. Use Nova Conta no cabeçalho do cartão para criar outra.

Criar ou editar

Clique em Nova Conta (ou Nova Conta de Pagamento / Nova Conta de Transferência quando não há nenhuma) para criar, ou em Editar configurações no cartão para alterar.

Campo	Obrigatório	Descrição
Número do Convênio de Pagamento / de Transferência	Não	Número do contrato ou convênio fornecido pelo banco.
Remessa habilitada	Não	Quando ativa, permite gerar arquivos de remessa. Desative para contas que operam apenas por API.
Validação de Saldo Habilitada	Não	Quando ativa, o saldo disponível é verificado antes de enviar pagamentos ou transferências, impedindo operações sem fundos suficientes.
Dados para o Provedor	Depende do banco	Campos específicos do banco. Quando o banco não pede nada, a tela mostra "Este provedor não possui dados adicionais configuráveis."

Clique em Criar Conta de Pagamento / Criar Conta de Transferência, ou Atualizar na edição.

info

A validação de saldo compara o valor da operação com o saldo atual da conta financeira registrado na Kobana. Mantenha o saldo atualizado (veja Saldo) para que a validação reflita o saldo real do banco.

Como a conta de serviço é usada

Ao criar um pagamento ou uma transferência, o painel lista as contas de pagamento ou de transferência disponíveis, com banco, conta financeira e conexão. A conta escolhida define a conta financeira de origem e a conexão usada para enviar a operação ao banco. Nas listas de pagamentos, transferências e lotes, a coluna da conta mostra o nome da conta financeira e o convênio, com link para a conta de serviço usada.

Conta de extrato

O cartão Extrato mostra:

Item	Descrição
UID	Identificador da conta de extrato.
Conexão para Extrato	Conexão associada, ou "Não associada".
Tipo de Sincronização de Extrato	Diária, De 1h em 1h, ou "Não configurado".
Ignorar lançamentos futuros	Ativo ou Inativo.
Sincronização automática ativada em	Data em que a sincronização automática foi ligada.
Última sincronização	Data da última atualização do extrato.

Para mudar o tipo de sincronização e a opção de lançamentos futuros, clique em Editar configurações. Os detalhes estão em Sincronização com o banco.

caution

O tráfego de linhas de extrato é um serviço cobrado. Sem conexão associada, a sincronização automática do extrato fica inativa e nada é cobrado. Ao associar uma conexão, a sincronização é ativada e o uso passa a ser cobrado conforme o seu plano.

Associar uma conexão

1. No cartão da conta de serviço, clique em Associar Conexão (ou Alterar Conexão, quando já há uma).
2. A tela lista as conexões ativas do mesmo banco da conta financeira. Clique em Associar na conexão desejada.
3. Para remover a conexão atual, clique em Desassociar, quando a opção estiver disponível.

Se ainda não existe conexão com o banco, a tela oferece criar uma. Conexões são cadastradas e validadas na área de conexões do painel.

Permissões

Ação	Módulo de permissão	Permissão
Ver contas de pagamento	Financeiro > Contas de Pagamento	Ações Básicas
Criar / alterar conta de pagamento	Financeiro > Contas de Pagamento	Criar / Alterar
Associar conexão à conta de pagamento	Financeiro > Contas de Pagamento	Ativar API
Ver contas de transferência	Financeiro > Contas de Transferência	Ações Básicas
Criar / alterar conta de transferência	Financeiro > Contas de Transferência	Criar / Alterar
Associar conexão à conta de transferência	Financeiro > Contas de Transferência	Ativar API
Ver a conta de extrato	Financeiro > Contas de Extrato	Ações Básicas
Editar configurações da conta de extrato	Financeiro > Contas de Extrato	Alterar
Associar conexão de extrato	Financeiro > Contas	Ativar API

Pela API

As contas de serviço podem ser consultadas e configuradas pela API v2.