Ir para o conteúdo

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:

  1. 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.

  2. Pesquisa e ensino — dados anonimizados (sem identificadores pessoais) podem ser compartilhados com residentes, docentes e pesquisadores sem violar a LGPD ou o sigilo profissional.

  3. 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

  1. Clique no botao Exportar XLSX.
  2. Na janela de dialogo do sistema, navegue ate a pasta desejada, nomeie o arquivo e clique em Salvar.
  3. Sugestao de nome: producao-AAAA-MM-profissional.xlsx
  4. O Anotae exibe uma barra de progresso. Para periodos longos (> 500 atendimentos) pode levar alguns segundos.
  5. 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-2 esta preenchida (linhas sem CIAP-2 podem indicar atendimentos registrados sem codificacao).
  • Se voce usou k-anonymity, a aba Resumo mostra quantas linhas foram suprimidas — avalie se a supressao e aceitavel para sua finalidade.
  • Se for auditoria, compare a coluna Hash_SHA256 com 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 (ou MM/AAAA com 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 Resumo permite verificar que o XLSX nao foi alterado apos a exportacao:

sha256sum producao-2026-05.xlsx    # Linux/macOS
Get-FileHash producao-2026-05.xlsx # Windows PowerShell

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+H abre o painel de historico de audit events com filtro por periodo e acao.