Correspondências¶
A tela de Correspondências permite registrar, consultar e atualizar o status de correspondências recebidas na portaria, além de controlar entregas e gerar relatórios para auditorias.
Objetivo desta tela
Gerenciar o recebimento e a entrega de correspondências das unidades do condomínio, incluindo cadastro individual ou em lote, controle de status e rastreabilidade de entregas.
Visão Geral da Tela¶
Ao acessar a tela de Correspondências, você encontra:
- Indicadores resumidos: Exibem métricas como total de correspondências, pendentes, entregues, lidas e não lidas
- Cards de filtro rápido: Funcionam como filtros visuais (Todas, Cadastros Recentes, Pendentes, Entregues, Não lidas, Lidas)
- Barra de ferramentas: Botões para as principais ações (Nova Correspondência, Cadastrar Múltiplas, Filtros, Exportar, Colunas, Busca, Relatório, Opções, Ajuda)
- Campo de busca: Permite localizar correspondências por apartamento, morador ou protocolo
- Tabela de correspondências: Lista todos os registros com colunas configuráveis
- Paginação: Controles para navegar entre as páginas de resultados
Indicadores e Cards de Filtro¶
Os cards no topo da página funcionam simultaneamente como indicadores e filtros rápidos:
| Card | Descrição |
|---|---|
| Todas | Exibe o total de correspondências registradas |
| Cadastros Recentes | Correspondências registradas nos últimos 30 dias |
| Pendentes | Correspondências aguardando retirada pelo morador |
| Entregues | Correspondências com registro de entrega confirmado |
| Não lidas | Correspondências que o morador ainda não visualizou no app |
| Lidas | Correspondências visualizadas pelo morador |
Dica
Clique em qualquer card para aplicar automaticamente o filtro correspondente na tabela.
Registrar Nova Correspondência¶
Para cadastrar uma correspondência individualmente:
- Clique no botão Nova Correspondência na barra de ferramentas
- Preencha os campos do formulário:
Campos do Formulário¶
| Campo | Obrigatório | Descrição |
|---|---|---|
| Apartamento | Sim | Unidade destinatária da correspondência |
| Morador Principal | Não | Morador principal da unidade |
| Morador Adicional | Não | Morador adicional (opcional) |
| Tipo de Correspondência | Sim | Categoria da correspondência (Ex: Caixa de Correio Normal, Correio Registrado) |
| Recebido Por | Não | Nome de quem recebeu na portaria (máx. 120 caracteres) |
| Observação | Não | Observações adicionais (máx. 500 caracteres) |
| SIG / Protocolo | Não | Número de protocolo, quando existir (máx. 500 caracteres) |
| Foto da Correspondência | Não | Imagem da correspondência para registro visual |
- Caso deseje anexar uma foto, clique em Capturar Foto
- Clique em Cadastrar para salvar o registro
Notificação ao Morador
Ao cadastrar a correspondência, o morador será notificado automaticamente através do aplicativo, de acordo com o texto configurado para o tipo de correspondência.
Cadastrar Múltiplas Correspondências¶
Para cadastrar várias correspondências de uma só vez:
- Clique no botão Cadastrar Múltiplas na barra de ferramentas
- No modal exibido, utilize uma das opções disponíveis:
- Cole os dados no campo de texto, uma correspondência por linha
- Utilize vírgula como separador entre os campos
- Formato:
Apartamento, Tipo, Morador Principal, Morador Adicional, Recebido Por, Observação
Exemplo de dados
A101, Correio Registrado, João Silva, , Porteiro Carlos, Pacote grande
- Clique em Baixar CSV de Exemplo para obter o modelo
- Preencha o arquivo seguindo o formato esperado
- Clique em Fazer Upload CSV para enviar o arquivo
Opções Adicionais¶
| Campo | Descrição |
|---|---|
| Apartamento padrão | Define um apartamento padrão para linhas sem essa informação |
| Tipo padrão | Define um tipo de correspondência padrão para linhas sem essa informação |
- Clique em Validar Dados para verificar se os registros estão corretos
- Após validação, clique em Criar em lote para finalizar
Limite de registros
O sistema permite no máximo 15 linhas por operação de cadastro em lote.
Gerenciar Tipos de Correspondência¶
Os tipos de correspondência definem categorias e o texto de notificação enviado ao morador. Para gerenciá-los:
- Clique no botão Opções na barra de ferramentas
- Selecione Gerenciar Tipos de Correspondência
Criar Novo Tipo¶
- No modal de tipos, clique em Novo
- Preencha os campos:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Tipo de Correspondência | Sim | Nome identificador do tipo |
| Texto de Aviso | Não | Mensagem enviada ao morador quando uma correspondência deste tipo é registrada |
Variáveis disponíveis
Utilize <dthr_chegada> no texto de aviso para incluir automaticamente a data e hora de chegada da correspondência.
- Clique em Salvar
Editar ou Excluir Tipo¶
Na tabela de registros cadastrados, utilize os botões de ação em cada linha:
- Editar registro: Abre o formulário com os dados do tipo para edição
- Excluir registro: Remove o tipo de correspondência do sistema
Atenção
Antes de excluir um tipo de correspondência, verifique se não existem correspondências vinculadas a ele.
Ações por Registro¶
Na coluna Ações de cada linha da tabela, clique no botão para acessar as opções disponíveis:
| Ação | Descrição |
|---|---|
| Ver detalhes | Exibe informações completas do registro, incluindo dados do morador e da unidade |
| Editar | Abre o formulário de edição da correspondência |
| Excluir | Remove a correspondência do sistema |
| Marcar como lida | Define o status de leitura da correspondência |
| Registrar entrega | Registra a entrega da correspondência ao morador |
| Visualizar foto | Exibe a foto anexada à correspondência (quando disponível) |
| Histórico de auditoria | Exibe o registro de alterações realizadas |
Fluxo sugerido
- Registre a chegada da correspondência com os dados mínimos
- Anexe a foto quando disponível
- Utilize Registrar entrega quando o morador retirar a correspondência
Busca e Filtros¶
Busca Rápida¶
Utilize o campo de busca para localizar correspondências por:
- Número do apartamento
- Nome do morador
- Número de protocolo
Filtros Avançados¶
Para buscas mais específicas:
- Clique no botão Filtros na barra de ferramentas
- Configure os critérios desejados:
| Filtro | Descrição |
|---|---|
| Apartamento | Filtrar por número da unidade |
| Morador | Filtrar por nome do morador |
| Tipo | Filtrar pelo tipo de correspondência |
| Status | Filtrar por status (Todos, Pendente, Entregue) |
| Leitura | Filtrar por status de leitura (Todos, Lida, Não lida) |
| Recebido Por | Filtrar pelo nome de quem recebeu na portaria |
| Período de Chegada | Define intervalo de datas de chegada (De/Até) |
| Período de Entrega | Define intervalo de datas de entrega (De/Até) |
- Clique em Aplicar Filtros para visualizar os resultados
- Use Limpar Filtros para remover todos os critérios
- Clique em Salvar Filtro para reutilizar a combinação posteriormente
Configurar Colunas¶
Para personalizar as colunas exibidas na tabela:
- Clique no botão Colunas na barra de ferramentas
- Marque ou desmarque as colunas desejadas:
- Seleção (obrigatória)
- Apartamento (obrigatória)
- Morador
- Tipo
- Chegada
- Entrega
- Status
- Ações (obrigatória)
- Clique em Aplicar Configuração
Colunas obrigatórias
As colunas marcadas como obrigatórias não podem ser ocultadas. O limite máximo é de 20 colunas visíveis.
Exportar Dados¶
Para exportar as correspondências cadastradas:
- Clique no botão Exportar na barra de ferramentas
- Selecione o formato desejado:
- Exportar PDF: Gera um relatório em formato PDF
- Exportar CSV: Gera um arquivo separado por vírgulas
- Exportar XLSX: Gera uma planilha Excel
Filtros aplicados
A exportação considera os filtros ativos no momento. Aplique os filtros desejados antes de exportar para obter um relatório específico.
Tabela de Correspondências¶
A tabela exibe as correspondências cadastradas com as seguintes colunas padrão:
| Coluna | Descrição |
|---|---|
| Seleção | Checkbox para seleção de múltiplos registros |
| Apartamento | Número da unidade (clicável para ver detalhes) |
| Morador | Nome do morador destinatário (clicável para ver detalhes) |
| Tipo | Categoria da correspondência |
| Chegada | Data e hora do registro de chegada |
| Entrega | Data e hora da entrega ao morador (ou "—" se pendente) |
| Status | Status atual (Pendente ou Entregue) |
| Ações | Menu com opções de gerenciamento |
Ordenação¶
Clique nos cabeçalhos das colunas com o botão Alternar ordenação para ordenar os resultados de forma crescente ou decrescente.
Paginação¶
Na parte inferior da tabela, utilize os controles para:
- Alterar a quantidade de Registros por página (10, 25, 50, 100)
- Navegar entre as páginas usando os botões de navegação