Visão geral
Visão geral mostra as correspondências não lidas dos últimos 30 dias.
- A linha de destaque conta as correspondências não lidas e as que estão não lidas há mais de 15 dias. Abrir caixa de entrada abre as correspondências não lidas.
- Não lidos há mais de 3 dias, Não lidos há mais de 7 dias e Não lidos há mais de 15 dias abrem, cada um, as correspondências não lidas correspondentes em Caixa de entrada.
- A seção Recebidos por tipo mostra as correspondências por tipo, a atividade por dia e Remetentes no período.
GET /api/v1/correios/dashboard/summary e GET /api/v1/correios/dashboard/categories. As duas exigem plugin-bc-correios-viewer-group.
Pastas de correspondência
Caixa de entrada, Enviados, Arquivados e Cancelados listam as correspondências de uma pasta.
- As colunas incluem Assunto, Tipo, Remetente ou Destino, Anexos e a data. Enviados mostra também Transmissão.
- Buscar correios busca no assunto, no remetente e no conteúdo.
- Filtre por Tipo (Resolução, Circular, Comunicado ou Outro), Leitura (exceto em Enviados) e período.
- Restaurar no menu de uma linha de Arquivados devolve a correspondência para Caixa de entrada. Enviados e Cancelados não oferecem ação em uma linha.
GET /api/v1/correios/mails, que exige plugin-bc-correios-viewer-group.
Detalhe da correspondência
Uma linha abre a correspondência. A tela tem três abas.
- Conteúdo mostra o corpo da correspondência.
- Anexos lista os anexos. Um clique baixa um deles com
GET /api/v1/correios/mails/{id}/attachments/{attachmentId}. - Resumo IA mostra o status e o resumo da análise de IA. Reanalisar pede uma nova análise com
POST /api/v1/correios/mails/{id}/reanalyze. Ela exige um provedor de IA em Configurações.
- Abrir uma correspondência não lida a marca como lida com
PUT /api/v1/correios/mails/{id}/read. - Responder abre Escrever correio como resposta à correspondência. Uma mensagem enviada não tem Responder.
- Arquivar move uma correspondência de Caixa de entrada para Arquivados com
PUT /api/v1/correios/mails/{id}/archive. Restaurar a devolve comPUT /api/v1/correios/mails/{id}/restore. As duas mudam apenas a cópia local da correspondência.
GET /api/v1/correios/mails/{id} e GET /api/v1/correios/mails/{id}/ai-status leem a correspondência. plugin-bc-correios-viewer-group pode ler, baixar e marcar como lida. Arquivar, Restaurar e Reanalisar exigem plugin-bc-correios-contributor-group.
Escrever
Escrever correio envia uma mensagem a um departamento do BACEN. Preencha Assunto e Mensagem. Destino (opcional) substitui o destino padrão, e Palavras-chave (opcional) aceita até 10 palavras-chave, separadas por vírgulas. Revisar envio abre a revisão. Depois que você confirma, o Cabine envia a mensagem com
POST /api/v1/correios/mails/send. Ela exige plugin-bc-correios-contributor-group.
Auditoria
Auditoria lista a trilha de auditoria da instituição com as colunas Quando, Ação, Correio e Operador. Filtre por Ação e Período. Exportar CSV e Exportar PDF baixam a trilha do período selecionado. Elas exigem um período. O Cabine chama
GET /api/v1/correios/audit e GET /api/v1/correios/audit/export. As duas exigem plugin-bc-correios-viewer-group.
Configurações
Configurações tem quatro seções.
- Credenciais: Usuário Sisbacen, Senha Sisbacen e Destino padrão (BCB). Para um segredo armazenado, escolha Manter, Substituir ou Remover. Testar credenciais testa as credenciais salvas com
POST /api/v1/correios/settings/test-connectione mostra as Pastas autorizadas. - Coleta: Intervalo de coleta é de 5, 15, 30 ou 60 minutos.
- IA: Provedor, Modelo, Endpoint, Prompt de sistema e Chave da API (BYOK). Testar provedor chama
POST /api/v1/correios/settings/test-ai-connection. - Retenção: Retenção (dias) aceita de 1825 a 36500 dias. Um período menor permite que o Lerian BC Correios apague os correios e anexos mais antigos que o novo período na próxima execução da retenção. O Cabine a salva com
PATCH /api/v1/correios/settings/retention.
PATCH /api/v1/correios/settings. Quando não há configuração, a tela mostra um formulário de primeiro uso, e Criar configuração a cria com POST /api/v1/correios/settings.
O Cabine lê a configuração com GET /api/v1/correios/settings, que exige plugin-bc-correios-viewer-group. Salvar ou criar a configuração e os dois testes exigem plugin-bc-correios-editor-group.

