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 o cadastro igual dos dois lados. Traz tudo que está na Kobana; daqui, envia só os clientes.
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.

Esta sincronização só traz. O card leva o selo "Do gateway": ela importa as contas cadastradas na Kobana e não cria nada lá. Ainda assim há uma confirmação, porque a rodada pode reescrever contas que já existem aqui — e o modal mostra exatamente quais, e quais campos mudam, antes de você autorizar.

O caminho de volta é conta a conta. Para mandar uma conta daqui para a Kobana, abra a conta e use "Adicionar no Gateway Bancário" — veja Contas financeiras. Criar conta no gateway altera o sistema externo, então quem escolhe o que vai é você, uma conta por vez, e não uma rodada em massa.

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 da empresa selecionada que ainda não existem na Kobana. O card também traz o selo "Bidirecional".

informação

Fornecedor não é enviado. O cadastro na Kobana é de quem paga — um fornecedor ocuparia lugar lá sem nunca ser cobrado. Quem é cliente e fornecedor ao mesmo tempo é enviado normalmente, por ser cliente também.

Na volta não há esse filtro, porque a Kobana não separa papel: quem vem de lá entra aqui como cliente. Se a pessoa importada for, na verdade, um fornecedor seu, marque o papel na ficha dela — a marcação é sua e as sincronizações seguintes não a desfazem.

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, e os endereços cadastrados no próprio título recebem o comprovante anexado; o sino avisa de qualquer forma. Ver Quem recebe por e-mail.

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.

Na sincronização de pessoas, que corre nos dois sentidos, o resultado os separa: 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. A de contas só traz, então ali só há criadas e atualizadas.