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.
A publicação inicial mantém o interruptor geral desligado e todas as conexões em SHADOW. O modo AUTO, o corte produtivo e qualquer reanálise real exigem autorização posterior e explícita.

​
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.
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 avalia as movimentações pendentes elegíveis dentro do escopo operacional da conexão. O histórico não é reanalisado automaticamente. Uma reanálise real só pode ser executada depois de autorização específica, com período definido e a conexão em SHADOW; nesse modo, ela 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.

​
Modos SHADOW e AUTO

No modo SHADOW, o motor lê, compara e registra o rastro da decisão, mas não solicita baixa automática, não ativa conciliação e não altera conta a receber ou a pagar. No modo AUTO, o motor só pode solicitar a baixa normal do ERP e concluir a conciliação quando todas estas condições forem atendidas ao mesmo tempo:
  • a conexão está ativa;
  • o ambiente da conexão é Produção;
  • a conexão está em AUTO;
  • o interruptor geral BANK_RECONCILIATION_ENABLED está ligado;
  • a última sincronização terminou com sucesso;
  • a movimentação não é anterior ao corte configurado;
  • a conta financeira está corretamente vinculada;
  • a movimentação e os títulos pertencem ao mesmo workspace;
  • existe uma única correspondência válida;
  • não há duplicidade, conflito, reversão ou pagamento equivalente.
Se qualquer condição falhar, o motor não solicita a baixa automática. O caso permanece como sugestão, pendência ou revisão, conforme o motivo. Contas a pagar continuam sempre manuais, mesmo em AUTO. O interruptor geral BANK_RECONCILIATION_ENABLED permanece desligado na publicação inicial. Com ele desligado, até uma conexão marcada como AUTO se comporta como SHADOW. Ligar o interruptor não ativa uma conexão por si só: o modo da conexão e todas as demais regras também precisam autorizar o fechamento. O corte do automático considera data, hora, minuto e segundo. Movimentações anteriores ao corte nunca produzem baixa automática; movimentações a partir dele ainda dependem de todos os outros gates. Configurar o corte produtivo, mudar uma conexão para AUTO ou executar reanálise real depende de autorização posterior e explícita.
Nenhum modo envia comandos ao banco. A integração não cria boleto, não paga boleto, não inicia Pix, pagamento ou transferência e não movimenta dinheiro na Cora. O automático atua somente dentro do ERP, usando a rotina normal de baixa e conciliação.

​
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.
  • Não existe uma nova tela de extrato bancário nem uma fila separada de exceções.
  • O interruptor geral permanece desligado e as conexões permanecem em SHADOW.
  • O modo AUTO, o corte produtivo e a reanálise do histórico real só podem ser usados depois de autorização posterior e explícita.
  • A reanálise autorizada deve ocorrer em SHADOW, com período definido, e produzir relatório sem alterar títulos nem solicitar baixa automática.
  • Qualquer caso ambíguo, conflito, possível duplicidade ou reversão sem origem inequívoca exige revisão humana.