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
TransmitirCorreiodo 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.
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.
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 flagNEXT_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 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 comotrue, 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.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.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.