Integração Gateway Bancário (Kobana)

Sistema > Integrações > Kobana (/settings/integrations/kobana). A integração permite:

1. Envio de pagamentos ao banco — despachar contas a pagar aprovadas, título a título ou em lote.
2. Sincronização de contas bancárias — entre a Kobana e o Financeiro Inteligente.
3. Sincronização de extrato — trazer os lançamentos das contas vinculadas.
4. Sincronização de pessoas — manter clientes e fornecedores iguais dos dois lados, nos dois sentidos.
5. Liquidação automática — confirmado o pagamento, a conta é baixada e o lançamento criado. Depende de o título ter "Pagar via" definida: sem saber de qual conta o dinheiro saiu, o sistema não adivinha, e a baixa fica para você fazer na mão.
6. Geração de cobranças — emitir boleto ou Pix a partir de uma conta a receber, para o cliente pagar.
7. Comprovantes de pagamento — capturar sozinho o comprovante de cada pagamento confirmado.

Conectar

A faixa do topo mostra o Status — Conectado, Não conectado ou Erro de conexão — e o token.

Sem conexão, o botão é "Conectar": cole o token de API gerado no painel da Kobana. "O token é armazenado criptografado." O sistema valida e informa quantas contas estão visíveis.

Já conectado, o botão vira "Gerenciar conexão".

"Desconectar" não fica na página. Ele mora dentro do diálogo "Gerenciar conexão Kobana", junto de "Atualizar". A confirmação tranquiliza: "Apenas a conexão é desfeita. As contas e dados já sincronizados permanecem no Financeiro Inteligente."

Sincronizações

observação

As sincronizações exigem uma empresa específica no seletor do topo: "Selecione uma empresa específica no seletor do topo, não 'Todas as empresas'. As contas sincronizadas entram na empresa que você escolher."

Contas bancárias

Não existe listagem para vincular contas à mão. Há um botão — "Sincronizar contas bancárias" — que faz o trabalho inteiro e vincula sozinho.

aviso

Esta sincronização é bidirecional e ESCREVE na Kobana. O card traz o selo "Bidirecional", e não é enfeite: além de importar as contas cadastradas na Kobana, ela cria na Kobana as contas que só existem aqui. Por isso há uma confirmação obrigatória, que diz o que está em jogo: "Criar contas na Kobana altera o sistema externo."

É a única operação da integração que modifica o sistema externo sem ser um pagamento. Se você só quer trazer as contas de lá, saiba que o caminho de volta acontece junto.

Extrato

"Sincronizar extrato" "importa o extrato das contas vinculadas (na empresa selecionada): traz os lançamentos da Kobana para o Financeiro Inteligente, sem duplicar os já importados."

O botão é um só e cobre todas as contas vinculadas da empresa — não há um botão por conta. As linhas importadas alimentam a Conciliação.

Pessoas

"Enviar pessoas" sincroniza o cadastro nos dois sentidos: traz da Kobana quem só existe lá e envia daqui os clientes e fornecedores da empresa selecionada que ainda não existem na Kobana. O card também traz o selo "Bidirecional".

aviso

Também ESCREVE na Kobana, e por isso pede confirmação: "Criar cadastros na Kobana altera o sistema externo."

Ninguém é duplicado. O encontro é pelo CPF/CNPJ — e, para quem já foi enviado daqui antes, pelo próprio vínculo gravado no envio anterior. Quem já existe dos dois lados apenas passa a ficar vinculado; os dados que você cadastrou aqui não são sobrescritos.

informação

Pessoa sem CPF/CNPJ não é enviada. Sem o documento não há como saber se ela já está lá, e o envio prefere deixar de fora a arriscar um cadastro repetido. Ao final, a sincronização diz quantas ficaram nessa situação — basta completar o documento e rodar de novo. A importação não tem esse limite.

Cada execução envia até 200 pessoas. Se a sua base for maior, rode outra vez: o que já foi não é reenviado.

Aprovação de pagamentos

Quando a aprovação está ligada (o padrão do espaço de trabalho), um título criado por formulário, CSV ou API não fica disponível para envio até ser aprovado por uma pessoa em Aprovar pagamentos. Com a aprovação desligada, o título já nasce oficial e enviável. Ver Ciclo de vida.

Envio de pagamentos

Com a integração ativa e o título aprovado, use "Enviar para o banco" — ação manual, na tela de detalhe. Da listagem, o caminho é "Enviar pagamentos", que despacha em lote. Ver Envio ao banco.

Geração de cobranças

A integração também funciona na direção do dinheiro que entra: de uma conta a receber, "Gerar cobrança" emite um boleto ou um Pix para o cliente pagar, e a cobrança paga baixa o título sozinha.

Cada trilho tem o seu pré-requisito na conta do gateway — o boleto precisa de um convênio, o Pix de uma conta Pix de cobrança —, e o boleto ainda exige o endereço completo do cliente. Ver Cobrança por boleto e Pix.

Comprovantes

Confirmado um pagamento enviado ao banco, o comprovante é capturado sozinho: fica guardado na biblioteca de Anexos, aparece na tela do título e é listado em Comprovantes. Quem estiver marcado em "Configurar envio" recebe um e-mail; o sino avisa de qualquer forma.

Sincronização automática

observação

Esta seção só aparece se o servidor tiver um endereço público de webhook configurado. Sem isso não há como o gateway avisar de nada, e nem ela nem as duas seções seguintes são desenhadas.

Um interruptor: "Atualiza o status dos pagamentos enviados sozinho, sem você precisar clicar em 'Atualizar status'."

É opcional, e desligada você não fica sem informação — só precisa buscar o status na mão, pelo "Atualizar status" de cada título.

Notificações

Outro interruptor: "Receba um aviso no sino quando o status de um pagamento mudar (confirmado, agendado, recusado…)."

Os dois interruptores conversam: sem a sincronização automática ligada, "os avisos podem chegar com atraso" — o sino só avisa quando o sistema descobre a mudança.

Entregas do webhook

Tabela de diagnóstico: "Registro de cada evento de mudança de status que o gateway de pagamentos da Kobana envia. Se algum falhar, você pode reenviá-lo." Tem "Atualizar" e, por linha, o reenvio.

É onde olhar quando um pagamento parece travado: se o evento não chegou, o status daqui fica para trás do banco.

Esta tabela só existe com a sincronização automática ligada. É ela que faz o gateway mandar os eventos — desligada, não há entrega para registrar, e a seção some da página.

Histórico

Registro das sincronizações executadas, por Data, Tipo (Contas, Extrato ou Pessoas) e Resultado — com quantas foram criadas, atualizadas, enviadas ou puladas.

Nas duas sincronizações bidirecionais, o resultado separa os dois sentidos: o que veio da Kobana aparece como criado ou atualizado, e o que foi daqui aparece como enviado. As pessoas deixadas de fora por não ter CPF/CNPJ entram como puladas.