> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mundialtelhastermicas.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrações Bancárias

> Como conectar a Cora, sincronizar movimentações e operar o motor de conciliação com segurança.

## 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.

<Warning>
  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.
</Warning>

## Conectar uma conta da Cora

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Informe o ambiente e as credenciais">
    Escolha **Homologação** ou **Produção** e preencha **Client ID**, **Certificado (PEM)** e **Chave privada (PEM)**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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.

<Note>
  **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.
</Note>

## 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.

<Warning>
  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.
</Warning>

## 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.
