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

# BC Correios no Lerian Console

> Opere o provider BC Correios no Módulo Reporter — receba, envie, pesquise e audite a correspondência regulatória do Banco Central do Brasil (BCB).

O **BC Correios** é um provider do [Módulo Reporter](/pt/lerian-console/reporter-console/reporter-module) que automatiza a comunicação regulatória com o **Banco Central do Brasil (BCB)** por meio do seu sistema de correio eletrônico, o *BC Correio*.

Instituições supervisionadas pelo BCB precisam monitorar essa caixa de correspondência diariamente em busca de diretivas, circulares e resoluções oficiais. O BC Correios traz esse fluxo para o Lerian Console: ele recebe a correspondência de entrada, permite que você transmita respostas e novas comunicações ao BCB e mantém um registro imutável como evidência de conformidade — sem que ninguém precise lidar com o protocolo SOAP/XML subjacente do BCB.

<Warning>
  O BC Correios só está disponível se a sua organização adquiriu o provider e ele estiver habilitado para o seu ambiente. Se você não o vê, [entre em contato com nossa equipe](https://lerian.studio/contact).
</Warning>

## O que o BC Correios cobre

***

Uma vez habilitado, o BC Correios adiciona uma seção à barra lateral do Reporter com as seguintes áreas:

* **Painel** — KPIs de correspondências recebidas e pendentes, um gráfico de categorias, status de sincronização e atividade recente.
* **Caixa de entrada** — lista de correspondências de entrada, pesquisável e filtrável, com uma visão de detalhes que mostra anexos e um painel opcional de insights de IA.
* **Escrever mensagem** — envie uma nova comunicação ao BCB (destinatário, assunto, conteúdo e palavras-chave) via a operação `TransmitirCorreio` do BCB.
* **Enviados** — comunicações transmitidas ao BCB.
* **Cancelados** — correspondências em estado cancelado. Esta pasta é **somente leitura**, pois o estado é reportado pelo próprio BCB.
* **Arquivados** — correspondências que você arquivou localmente para organização.
* **Auditoria** — uma trilha de auditoria imutável de eventos, com exportação em CSV para evidência de conformidade.
* **Configurações** — credenciais do BCB, intervalo de polling, provedor de IA, webhook e configuração de retenção.

<Note>
  Arquivar e restaurar são ações organizacionais **apenas locais** — atualizam o banco de dados do BC Correios e nunca alteram nada no lado do BCB. A correspondência regulatória é retida para atender ao requisito mínimo de retenção; não há exclusão disponível ao usuário.
</Note>

## Tipos de correspondência

***

O BC Correios categoriza a correspondência de entrada para ajudar você a triar as comunicações regulatórias:

| Tipo       | Significado                                                    |
| ---------- | -------------------------------------------------------------- |
| Circular   | Uma circular do BCB.                                           |
| Resolução  | Uma resolução do BCB.                                          |
| Comunicado | Uma comunicação geral do BCB.                                  |
| Outro      | Qualquer comunicação que não se enquadre nas categorias acima. |

## Como a disponibilidade é controlada

***

O BC Correios tem dois níveis de ativação:

### 1. Flag de infraestrutura (definida pelo seu time de DevOps/deploy)

A flag `NEXT_PUBLIC_BC_CORREIOS_ENABLED` controla se o BC Correios fica visível no Console. Ela vem **desabilitada por padrão** e precisa ser definida no nível do contêiner do Console — via valores do Helm ou variáveis de ambiente — antes que qualquer coisa apareça na interface.

Essa é uma configuração de **tempo de deploy**, não algo alterado dentro do próprio Console. Veja [Lerian Console via Helm](/pt/platform/helm/console/console-helm) para onde defini-la.

Como a flag é lida em runtime, alterná-la requer reiniciar o contêiner do Console — sem necessidade de rebuild. Quando a flag está desligada, todas as páginas do BC Correios ficam ocultas.

### 2. Toggle da organização (definido por um administrador do Console)

Uma vez que a flag de infraestrutura esteja como `true`, um **card BC Correios** aparece em **Reporter → Configurações → Plugins**. Um administrador pode usar o toggle nesse card para habilitar ou desabilitar o BC Correios para a organização sem tocar no deploy.

### Onde o BC Correios aparece

Quando ambos os níveis estão ativos, o BC Correios aparece como uma seção recolhível em **PLUGINS** na barra lateral do Reporter, com os seguintes itens: Painel, Caixa de entrada, Enviados, Arquivados, Cancelados, Auditoria e Configurações.

<Note>
  Se você espera ver o BC Correios mas ele não aparece na barra lateral do Reporter, verifique nesta ordem: (1) confirme que a flag de infraestrutura está como `true` para o seu ambiente; (2) confirme que o plugin está ligado em Reporter → Configurações → Plugins. Se ambos estiverem definidos e ele ainda não aparecer, contate a equipe Lerian.
</Note>

## Console vs API

***

Use o **Console** quando um operador precisar ler, enviar, pesquisar e auditar a correspondência do BCB pela interface visual. Use a **API** da integração com o BCB quando um sistema precisar automatizar a recepção ou a transmissão de forma programática. Os mesmos conceitos se aplicam em ambos os lugares — o Console abstrai a caixa de correio SOAP/XML do BCB por trás de um fluxo de operação limpo.