Integração Fintera
Sistema > Integrações > Fintera (/settings/integrations/fintera). Importa dados de uma conta Fintera para o Financeiro Inteligente — para quem está migrando ou mantém as duas plataformas em paralelo.
Conectar
A faixa do topo mostra Status, Token e quantas Empresas estão vinculadas. Sem conexão, "Conectar": cole o token de API da Fintera. Uma vez conectado, o diálogo "Gerenciar conexão Fintera" mostra o token como "Armazenado criptografado" — ele nunca é exibido de volta.
Conectado, o botão vira "Gerenciar conexão" — e é dentro desse diálogo que ficam o vínculo de empresas, Atualizar o token e Desconectar.
Vínculo de empresas
A Fintera traz as empresas, não as contas. "Essas empresas vêm da Fintera (pelo seu token). Aqui você só escolhe pra qual empresa cadastrada no Kobana Finance cada uma vai mandar os dados."
Dois portões
As importações ficam bloqueadas até que ambos estejam satisfeitos:
- Token válido — "Salve um token válido da Fintera para liberar as importações."
- Pelo menos uma empresa vinculada — "Vincule pelo menos uma empresa Fintera a uma empresa do Kobana Finance para liberar as importações."
O que é importado
Onze recursos, em dois grupos. A ordem importa: Movimentações "dependem dos cadastros acima".
Cadastros base
| Recurso | Observações |
|---|---|
| Categorias | Replicadas por empresa; categorias bidirecionais geram um par (receita + despesa) |
| Centros de classificação | Para todas as empresas vinculadas |
| Pessoas | Clientes e fornecedores |
| Impostos | Catálogo do espaço de trabalho. Precede contas a pagar/receber, cujos impostos por título resolvem contra ele |
| Contas financeiras | Contas bancárias da Fintera |
Movimentações
| Recurso | Depende de |
|---|---|
| Contas a pagar | Pessoas + categorias + centros |
| Contas a receber | Pessoas + categorias + centros |
| Lançamentos | — (importa o período escolhido) |
| Conciliações | Títulos + lançamentos |
| Anexos | Títulos + lançamentos |
| Extratos | Lançamentos |
Extratos não baixa arquivo OFX. A importação "espelha o histórico de importação de extratos do Fintera e vincula cada lançamento ao seu extrato" — mas o arquivo em si não vem: a API da Fintera não o fornece. Você recebe a estrutura e os vínculos, não o documento.
Conciliações preserva o n:m. O vínculo da Fintera entre títulos e lançamentos é espelhado como está. Ver Conciliação — uma conciliação importada é somente leitura.
Importar
"Importar tudo" roda os onze em sequência, respeitando a dependência. Cada linha também tem seu "Importar", para rodar um recurso isolado.
As importações rodam em segundo plano e seguem os vínculos de empresa. Cada linha mostra o progresso e o resultado — quantos criados, atualizados, com erro, ou "sem mudanças" / "nada a importar".
Não existe um botão "Importar dados" com seletor de período. São os onze recursos, cada um com o seu, mais o "Importar tudo".
Modo token do módulo Financeiro
Um token restrito ao módulo Financeiro da Fintera não lista empresas. Nesse caso não há o que vincular, e a tela avisa: "Imports disponíveis aplicados às empresas ativas do espaço de trabalho." Só um subconjunto dos recursos fica habilitado.
Agendamentos
"Configure execuções automáticas das importações." Com "Novo agendamento", uma importação passa a rodar sozinha na frequência escolhida.
Cada linha mostra o recurso, a frequência, a próxima execução e o resultado da última, com o selo Ativo ou Desativado e as ações Editar, Pausar / Retomar e Excluir.
É o que diferencia a Fintera das ferramentas de Manutenção: aqui existe agendamento.
Histórico de importações
Registro das execuções, em quatro colunas: Data, Importações, Resultado e Usuário — quem disparou.
Desconectar
Dentro de "Gerenciar conexão". Os dados já importados permanecem.