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 autorizadas, 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. 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.

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 Kobana Finance."

Sincronizações

observação

As duas 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 Kobana Finance, 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.

Autorização de pagamentos

Quando a autorizaçã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 autorizado por uma pessoa em Autorizar pagamentos. Com a autorizaçã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 autorizado, 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.

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 ou Extrato) e Resultado — com quantas foram criadas, atualizadas, enviadas ou puladas.