Skip to main content

​
O que a integração faz

A integração bancária traz o extrato e o saldo da Cora para o ERP. Com esses dados, o motor compara movimentações do banco com contas a receber, contas a pagar e transações financeiras. Ela serve para leitura e conciliação dentro do ERP. A integração não gera nem paga boleto, não inicia Pix, pagamento ou transferência e não envia comandos para movimentar dinheiro no banco.
O modo automático permanece desligado nesta publicação. Mantenha as conexões em sombra e não use Ligar automático. A liberação do automático depende de outra decisão e de uma publicação específica.

​
Conectar uma conta da Cora

Somente administradores podem criar e gerenciar conexões bancárias.
1

Abra as integrações

Acesse Configurações > Integrações e escolha Cora. O Itaú aparece como indisponível porque ainda não faz parte desta integração.
2

Escolha a conta financeira

Selecione a conta do ERP que representa a conta bancária da Cora. Uma conta que já possui conexão ativa não aparece para uma nova conexão.
3

Informe o ambiente e as credenciais

Escolha Homologação ou Produção e preencha Client ID, Certificado (PEM) e Chave privada (PEM).
4

Conecte e guarde o token

Clique em Conectar. Copie o token do webhook e guarde-o em local seguro antes de fechar a janela. Ele é exibido somente uma vez e permite que a Cora avise o ERP sobre uma movimentação nova.
O certificado e a chave privada também não voltam a ser exibidos depois de salvos. Se o certificado for substituído, use Reenviar certificado e informe o novo par completo.

​
Sincronizar agora

Abra o cartão da Cora e clique em Sincronizar agora para pedir uma leitura do saldo e das movimentações disponíveis no banco. A sincronização pode continuar em segundo plano. Use Último sync, o saldo apresentado e qualquer mensagem de erro para acompanhar o resultado. Repetir a sincronização não deve criar outra movimentação, decisão, baixa ou conciliação para o mesmo registro bancário. Depois de uma sincronização concluída, o motor reavalia as movimentações pendentes elegíveis da conexão, inclusive as antigas. No modo sombra, essa reavaliação apenas registra candidatos, decisões, ambiguidades e conflitos para conferência.
Pausar suspende as sincronizações automáticas e os sinais enviados pelo banco, mas mantém Sincronizar agora disponível para uma execução manual. Retomar volta a permitir o processamento automático. Desconectar encerra a conexão e libera a conta financeira para uma nova configuração; a ação não apaga o histórico já importado.

​
Modo sombra e trava geral

No modo sombra, o motor lê, compara e registra o rastro da decisão, mas não cria baixa automática, não ativa conciliação e não altera conta a receber ou a pagar. Existem duas travas independentes contra fechamento automático:
  1. O modo da conexão deve permanecer em sombra.
  2. O interruptor geral BANK_RECONCILIATION_ENABLED permanece em false nesta publicação.
Com o interruptor geral desligado, até uma conexão marcada como automática se comporta como sombra. Ligar o interruptor não liga uma conexão por si só: o modo da conexão e todas as demais regras de segurança também precisariam autorizar o fechamento. O corte do automático, quando vier a ser autorizado em outra publicação, considera o instante completo da ativação. Movimentações anteriores continuam apenas como sugestão; movimentações no instante da ativação ou posteriores ainda dependem das outras travas e regras.

​
Segurança das credenciais e dos dados

  • Trate Client ID, certificado, chave privada e token do webhook como segredos.
  • Não cole esses dados em conversa, tarefa, comentário, captura de tela ou manual.
  • Certificado e chave não são devolvidos pela API nem reaparecem na tela depois de salvos.
  • O token do webhook aparece uma única vez. Se ele for perdido, a conexão precisa ser refeita.
  • Cada conexão, movimentação e decisão pertence ao workspace que a criou. Uma unidade não pode consultar nem alterar os dados bancários de outra.
  • Uma falha da Cora, da fila ou do banco de dados do ERP deve resultar em erro ou nova tentativa, nunca em comando financeiro externo.

​
Reversões bancárias

O ERP só pode ligar uma reversão à movimentação original quando houver um sinal bancário comprovado e uma única origem válida. Sem origem ou com mais de uma possibilidade, o caso deve permanecer em revisão, sem escolher por aproximação. Mesmo quando o vínculo for inequívoco, a reversão alcança somente a conciliação bancária original. Ela não estorna automaticamente a baixa nem reabre uma conta a receber ou a pagar. Confira o lançamento original e faça qualquer correção financeira pela rotina apropriada do ERP.
A identificação automática de reversão da Cora ainda está pendente. A documentação e os dados medidos não apresentam um campo confiável que identifique o evento e sua origem. Enquanto essa evidência não existir, o ERP não deve inferir reversão por descrição, valor ou proximidade de data.

​
Limites desta publicação

  • Somente a Cora está disponível.
  • Itaú e importação por OFX ou CSV não fazem parte desta entrega.
  • Não existe uma nova tela de extrato bancário nem uma fila separada de exceções.
  • O modo automático não está autorizado.
  • A reavaliação do histórico real de Uruaçu só pode acontecer depois da publicação segura, em sombra e com autorização separada. Ela deve produzir relatório sem alterar títulos nem criar baixa automática.
  • Qualquer caso ambíguo, conflito, possível duplicidade ou reversão sem origem inequívoca exige revisão humana.