Tutorial: Exportar Relatório XLSX¶
Aprenda a exportar seus atendimentos para planilha Excel — desde a entrega mensal de produção SUS até relatórios anonimizados para pesquisa e auditoria interna.
O que você vai aprender¶
Ao concluir este tutorial, você saberá como:
- Gerar o relatório de produção mensal exigido pela gestão SUS.
- Escolher o template certo para cada finalidade.
- Aplicar anonimização e k-anonymity antes de compartilhar dados.
- Verificar o arquivo gerado antes de entregar.
Tempo estimado: 5 minutos.
Pré-requisito: pelo menos um atendimento registrado no vault.
Por que exportar?¶
O Anotae armazena todos os atendimentos localmente em seu vault cifrado. A exportação XLSX serve a três finalidades principais:
-
Entrega de produção SUS — a maioria das Unidades Básicas e ambulatórios exige planilha mensal com data, profissional, CBO, tipo de atendimento e códigos CIAP-2/CID-10 para comprovação de metas pactuadas.
-
Pesquisa e ensino — dados anonimizados (sem identificadores pessoais) podem ser compartilhados com residentes, docentes e pesquisadores sem violar a LGPD ou o sigilo profissional.
-
Auditoria interna — o relatório completo com hash SHA-256 por linha permite confrontar a planilha com o audit log do vault para detectar qualquer adulteração.
Nota de privacidade: a exportação nunca sai do seu computador de forma automática. O arquivo fica onde você escolher salvar. O Anotae não envia dados para nenhum servidor.
Passo 1 — Abrir o painel de exportação¶
Abra o menu Arquivo → Exportar XLSX... ou pressione Ctrl+E.
O painel de exportação abre sobre a janela principal. Você não precisa fechar nenhum atendimento aberto — a exportação lê diretamente do vault.
Passo 2 — Configurar filtros de período e profissional¶
Filtro de data¶
No topo do painel você encontra dois campos:
- Data inicial — primeiro dia do período. Para entrega mensal, use o
primeiro dia do mês (ex.:
01/05/2026). - Data final — último dia do período. Para entrega mensal, use o último
dia do mês (ex.:
31/05/2026).
Clique no ícone de calendário ao lado de cada campo ou digite a data no
formato DD/MM/AAAA.
Filtro de profissional¶
Se o vault contiver registros de mais de um profissional (por exemplo, em equipe multiprofissional com vault compartilhado), o menu Profissional aparecerá. Selecione:
- Todos — inclui todos os profissionais no relatório.
- Apenas meu CBO — filtra pelo CBO vinculado ao seu perfil (Arquivo → Meu Perfil).
- Selecionar individualmente — marque os profissionais desejados na lista que aparece.
Se o vault for individual (configuração padrão), o filtro mostra apenas seu nome e pode ser ignorado.
Passo 3 — Escolher o template¶
O menu Template oferece três opções. Escolha de acordo com a finalidade da exportação.
Producao Mensal¶
Quando usar: entrega obrigatória à gestão SUS, consolidação de produção para o sistema SISAB/e-Gestor ou relatórios para a coordenação de Atenção Básica.
Campos gerados:
| Coluna | Descrição |
|---|---|
| Data | Data do atendimento (DD/MM/AAAA) |
| Profissional | Nome do profissional |
| CBO | Código Brasileiro de Ocupações |
| CNS Profissional | CNS do profissional (nunca do paciente neste template) |
| Tipo de atendimento | Consulta, visita domiciliar, procedimento, etc. |
| CIAP-2 | Código(s) CIAP-2 registrados |
| CID-10 | Código(s) CID-10 (quando registrado) |
| SIGTAP | Código de procedimento SIGTAP (quando aplicável) |
O que este template não inclui: dados de identificação do paciente (nome, CPF, CNS, data de nascimento).
Relatorio CIAP-2¶
Quando usar: análise epidemiológica do perfil de demanda da sua unidade; apresentações para equipe, residentes ou gestores; publicações com dados agregados.
O que este template gera:
- Uma linha por código CIAP-2 distinto encontrado no período.
- Colunas:
Capitulo,Codigo,Descricao,Total_atendimentos,Percentual_do_periodo. - Aba adicional Por_profissional com o mesmo cruzamento segmentado por CBO.
Este template já agrega os dados — não há linha por atendimento. Ideal para ser colado diretamente em apresentações.
Relatorio Completo¶
Quando usar: auditoria interna, exportação para backup analítico, cruzamento com dados externos, ou quando você precisa de todos os campos para alguma finalidade específica.
Campos gerados: tudo dos templates anteriores, mais:
| Coluna adicional | Descrição |
|---|---|
| ID_encuentro (hash) | SHA-256 do ID interno (não expõe PK do banco) |
| Hora | Horário de início do atendimento |
| Duracao_min | Duração em minutos (se registrada) |
| SOAP_S | Subjetivo — queixa principal anonimizada |
| SOAP_O | Objetivo — dados de exame (sem valores de referência externos) |
| SOAP_A | Avaliação (impressão diagnóstica) |
| SOAP_P | Plano (encaminhamentos, prescricoes, retorno) |
| Hash_SHA256 | Hash da linha inteira para verificação de integridade |
Atenção: o Relatório Completo com anonimização desativada contém dados sensíveis. Use-o apenas para auditoria interna e nunca compartilhe sem aplicar as opções de privacidade descritas no Passo 4.
Passo 4 — Opções de privacidade¶
Esta seção aparece abaixo do seletor de template. Leia com atenção antes de exportar para qualquer finalidade que envolva terceiros.
Anonimizar dados¶
Ative esta opção para remover ou substituir todos os identificadores pessoais do arquivo gerado.
O que acontece quando ativada:
- CPF e CNS do paciente são removidos.
- Nome do paciente é substituído por um token
PAC-<hash8>— um hash de 8 caracteres derivado de HMAC-SHA256 com salt aleatório gerado no momento da exportação. O mesmo paciente recebe o mesmo token dentro de um único export, mas tokens diferentes em exports distintos. Isso garante que a planilha não possa ser cruzada com outras exportações para re-identificar o paciente. - Data de nascimento é substituída por faixa etária (0–4, 5–9, 10–14, ..., 80+).
- Endereço é removido.
O salt aleatório por export é gravado apenas em memória e descartado ao fechar o painel. Ele não é salvo no vault nem na planilha. Isso é intencional: impede re-identificação por cruzamento.
Generalizar datas¶
Disponível apenas com Anonimizar dados ativado.
Quando marcada, a coluna Data exibe apenas MM/AAAA (ex.: 05/2026)
em vez de DD/MM/AAAA. Útil quando a data exata do atendimento, combinada
com outros campos, poderia identificar o paciente (ex.: paciente com doenca
rara atendido em data especifica).
k-Anonymity (slider k)¶
O slider k-anonymity aparece apenas com Anonimizar dados ativado. Ele controla o nivel minimo de indistinguibilidade entre registros.
| Valor de k | O que o Anotae garante | Quando usar |
|---|---|---|
| k = 1 | Sem supressao adicional | Apenas para uso proprio; nao compartilhar |
| k = 2 | Cada combinação (CIAP-2, faixa etária, sexo) aparece ≥ 2 vezes | Uso interno limitado |
| k = 5 | Cada combinação aparece ≥ 5 vezes | Pesquisa e ensino — recomendado pela LGPD para dados de saude |
| k = 10 | Cada combinação aparece ≥ 10 vezes | Publicacoes academicas, dados publicos |
Registros que nao atingem o limiar k sao suprimidos da planilha (removidos,
nao zerados). A aba Resumo registra quantas linhas foram suprimidas e o
motivo (k-anonymity threshold).
Para pesquisa: use k ≥ 5 com Anonimizar dados + Generalizar datas. Essa combinacao e considerada boa pratica pela ANPD para dados de saude anonimizados (Guia de Boas Praticas LGPD, 2021).
Passo 5 — Exportar e verificar o arquivo¶
- Clique no botao Exportar XLSX.
- Na janela de dialogo do sistema, navegue ate a pasta desejada, nomeie o arquivo e clique em Salvar.
- Sugestao de nome:
producao-AAAA-MM-profissional.xlsx - O Anotae exibe uma barra de progresso. Para periodos longos (> 500 atendimentos) pode levar alguns segundos.
- Ao concluir, aparece a mensagem "Exportacao concluida. N atendimentos exportados." com um botao Abrir pasta para localizar o arquivo imediatamente.
Verificar o arquivo antes de entregar¶
Abra o arquivo em Excel, LibreOffice Calc ou Google Sheets e confira:
- O numero de linhas bate com o esperado para o periodo.
- A coluna
CIAP-2esta preenchida (linhas sem CIAP-2 podem indicar atendimentos registrados sem codificacao). - Se voce usou k-anonymity, a aba
Resumomostra quantas linhas foram suprimidas — avalie se a supressao e aceitavel para sua finalidade. - Se for auditoria, compare a coluna
Hash_SHA256com o audit log exportado separadamente (Ctrl+H → Exportar audit log).
Sobre o arquivo gerado¶
O arquivo XLSX contem sempre duas abas:
Aba Dados¶
Contém as linhas de atendimento (ou de codigos CIAP-2, no template Relatorio CIAP-2). Formatação:
- Cabecalho na linha 1, fundo azul Anotae (
#1A56DB), texto branco, fonte em negrito. - Linhas alternadas em branco e cinza-claro para facilitar leitura.
- Colunas de data formatadas como
DD/MM/AAAA(ouMM/AAAAcom Generalizar datas). - Colunas numericas alinhadas a direita com formatacao de numero inteiro.
Aba Resumo¶
Gerada automaticamente em todos os templates. Contem:
- Total de atendimentos no periodo exportado.
- Distribuicao por tipo de atendimento (consulta, visita, procedimento).
- Top 10 codigos CIAP-2 mais registrados, com contagem e percentual.
- Top 10 codigos CID-10 (quando presentes).
- Distribuicao por profissional (quando o vault tiver mais de um).
- Linhas suprimidas por k-anonymity (quando k > 1).
- Metadados da exportacao: data/hora, versao do Anotae, opcoes de privacidade aplicadas, hash SHA-256 do arquivo gerado.
O hash SHA-256 do arquivo na aba
Resumopermite verificar que o XLSX nao foi alterado apos a exportacao:
Compatibilidade¶
- Microsoft Excel 2016+
- LibreOffice Calc 7.0+
- Google Sheets (importar via Arquivo → Importar)
- Numbers (macOS) — importar como XLSX
Proximos passos¶
- Configurar a extensao de navegador para injetar dados no e-SUS APS PEC automaticamente: veja Configurar a extensao.
- Fazer backup do vault antes de entregas importantes para garantir que voce possa regenerar o relatorio se necessario: veja Backup e restauracao.
- Auditar o historico de acesso ao vault:
Ctrl+Habre o painel de historico de audit events com filtro por periodo e acao.