Pular para o conteúdo principal

Unificação de Bases

Introdução​

Considerando a necessidade de um cenário cada vez mais digital e interconectado para assegurar a qualidade e a eficiência da Estratégia e-SUS APS, a Secretaria de Atenção Primária à Saúde (Saps) do Ministério da Saúde desenvolveu uma ferramenta inovadora que permite aos municípios ajustar suas conformações de cenários, assegurando o funcionamento a partir de uma única instalação do Prontuário Eletrônico e-SUS APS em cada município.

Esta ferramenta consolida as bases descentralizadas do Prontuário Eletrônico e-SUS APS (atualmente distribuídas entre diversas instalações locais em cada município) em uma estrutura única e centralizada. Esse avanço permite que todos os estabelecimentos de saúde integrem e implementem o conceito de Prontuário Eletrônico e-SUS APS de forma unificada no âmbito municipal.

Assim, independentemente de onde o cidadão receba atendimento, seu histórico clínico será acessível e completo, promovendo um cuidado contínuo e possibilitando decisões rápidas e precisas pela equipe de saúde que conduzirá o seu acompanhamento.

nota

A Unificação de Bases reúne as bases de dados de diferentes instalações em uma única instalação. Ela não deve ser confundida com a Unificação de Prontuários (módulo Gestão de Cadastros), utilizada para unificar os prontuários duplicados de um mesmo cidadão dentro de uma instalação (ver Capítulo 8 - Gestão de Cadastros).

Modalidades de instalação do Prontuário Eletrônico e-SUS APS (conceitos)​

O Prontuário Eletrônico e-SUS APS pode ser utilizado no município de duas formas: Centralizado (instalação única) ou Descentralizado (diversas instalações).

Prontuário Eletrônico e-SUS APS Descentralizado​

Na modalidade descentralizada, cada Unidade de Saúde possui o seu próprio Prontuário Eletrônico e-SUS APS, NÃO compartilha dados no município, e as informações ficam disponíveis apenas em cada Unidade de Saúde.

Cenário com bases de dados descentralizadas: cada Unidade de Saúde registra os atendimentos no seu próprio servidor do Prontuário Eletrônico e-SUS APS, instalado na própria unidade. Cada servidor envia, separadamente, os seus dados ao Centralizador Nacional (CN), que os repassa ao Siaps.

As características e as desvantagens desta modalidade estão descritas no item Arquitetura descentralizada, na página Orientações Gerais do Apoio à Implantação.

Prontuário Eletrônico e-SUS APS Centralizado​

Ao contrário da modalidade descentralizada, na arquitetura centralizada uma única instalação do Prontuário Eletrônico e-SUS APS é externa e compartilhada, podendo várias Unidades de Saúde ter acesso simultâneo e em tempo real à aplicação, para todos os registros do cidadão.

As características, o funcionamento e as vantagens desta modalidade estão descritos no item Arquitetura centralizada, na página Orientações Gerais do Apoio à Implantação.

Proposta de cenário após a unificação das bases​

Após a unificação das bases de dados, todas as Unidades de Saúde acessarão uma única base de dados no município, com prontuário compartilhado:

Cenário com base de dados centralizada após a unificação das bases

Quando NÃO utilizar uma instalação centralizada do e-SUS APS​

É importante ressaltar que, apesar dos vários benefícios e vantagens da adoção do Prontuário Eletrônico e-SUS APS na modalidade centralizada, o seu uso em alguns cenários não é recomendado. Por exemplo:

  • Ausência de infraestrutura adequada para garantir a eficiência do uso do Prontuário Eletrônico e-SUS APS em todas as Unidades de Saúde;
  • Ausência de equipe de TI com habilidades específicas para atender às demandas da Estratégia e-SUS APS e garantir a eficácia da implementação e manutenção do sistema;
  • Instabilidade na conexão de internet no município;
  • Quedas constantes na rede elétrica municipal;
  • Ambientes que não tenham rotinas de backup automatizado implementadas;
  • Locais com ausência de Política de Segurança da Informação (PSI).

Portanto, considere todas as situações acima antes de efetivamente iniciar um processo de unificação de bases para a criação de uma estrutura centralizada do Prontuário Eletrônico e-SUS APS.

Desejo unificar as bases de dados do meu município. O que fazer?​

Os benefícios da unificação de bases são significativos para uma Atenção Primária mais digital e bem qualificada. No entanto, é crucial um planejamento assertivo para garantir a disponibilidade contínua do cenário e a consistência dos dados.

Após a unificação das bases, qualquer reversão para o cenário anterior (descentralizado) exigirá uma infraestrutura descentralizada em cada instalação do Prontuário Eletrônico e-SUS APS, com requisitos computacionais robustos para suportar o volume total de dados resultantes dessa unificação.

nota

Considerando as boas práticas da Lei Geral de Proteção de Dados (LGPD - Lei nº 13.709/2018), é importante salientar que a unificação de bases de dados é um processo crítico e envolve a manipulação de dados de diversos cidadãos, Unidades de Saúde e/ou municípios (instalações multimunicipais). É muito relevante considerar as melhores práticas de segurança da informação, previstas na Política de Segurança da Informação (PSI), com vistas à manutenção do sigilo e da confidencialidade dos dados, para que se evite o vazamento de dados pessoais e sensíveis.

info

Recomenda-se que, na Instalação Descentralizada, todas as doses de vacina com inconsistências identificadas no Relatório do Siaps de Vacinas Registradas no e-SUS APS sejam retificadas (editadas ou removidas) antes de iniciar o processo de unificação das bases (ver item 5.3.6 do Capítulo 5). Caso essa etapa não seja realizada, não será possível retificar as doses registradas de origem PEC na Instalação Central, pois a retificação deve ocorrer na mesma instalação em que a dose foi registrada. No entanto, para as doses de origem CDS, não há impedimentos para exclusão ou retificação após a unificação, podendo o processo ser feito via Vacinação do módulo CDS.

Requisito obrigatório​

A Instalação Central, que receberá as bases de dados, deve obrigatoriamente possuir acesso por endereço de domínio via protocolo HTTPS (ver manual Habilitação do HTTPS).

Procedimentos a serem realizados antes do processo de Unificação de Bases​

Na Instalação Descentralizada:

  • Atualize para a mesma versão da Instalação Central que receberá esta base;
  • Baixe o XML no e-Gestor APS e importe-o na instalação;
  • Sincronize todas as instalações de aplicativos da Estratégia e-SUS APS dos profissionais da Unidade/Equipe que utilizam a Instalação Descentralizada;
  • Force o envio de lotes ao Centralizador Nacional em Transmissão de dados e aguarde a sua conclusão. Aguarde também o fim do processamento dos relatórios;
  • Se houver Agenda Online habilitada, desabilite-a;
  • Realize o backup da base de dados da instalação.

Na Instalação Central:

  • Verifique se a versão é a mesma da Instalação Descentralizada;
  • Baixe o XML no e-Gestor APS e importe-o na instalação;
  • Force o envio de lotes ao Centralizador Nacional em Transmissão de dados e aguarde a sua conclusão. Aguarde também o fim do processamento dos relatórios;
  • Se houver Agenda Online habilitada, desabilite-a;
  • Realize o backup da base de dados da instalação.

Etapas de unificação de bases de dados no Prontuário Eletrônico e-SUS APS​

Considerações importantes:

Destaca-se que o processo de unificação de bases de dados foi desenvolvido para operar de forma remota, em que uma instalação do Prontuário Eletrônico e-SUS APS (Instalação Descentralizada, que será unificada) remete dados para outra instalação do Prontuário Eletrônico e-SUS APS (Instalação Central, que receberá os dados) a partir de um link de internet. Durante o processo de unificação, caso haja queda no link de internet ou interrupção de energia, o processo de unificação será interrompido e deverá ser reiniciado, restaurando-se os backups da Instalação Descentralizada e da Instalação Central realizados antes de iniciar o processo, para assim realizar uma nova tentativa.

Sempre que possível, considere preparar um ambiente na rede local da Instalação Central, com uma "instalação alternativa do Prontuário Eletrônico e-SUS APS", para receber o backup das Instalações Descentralizadas, um por vez, e realizar a unificação dentro da mesma infraestrutura. Tal ação permitirá maior agilidade, segurança e rapidez no processo de unificação das bases de dados e evitará transtornos advindos de quaisquer interrupções.

Também é altamente recomendado que o processo de unificação de bases seja realizado fora do horário de expediente das Unidades de Saúde ou que, no momento da unificação, nenhum profissional tenha acesso à Instalação Central nem à Instalação Descentralizada.

atenção

Não orientamos realizar o processo diretamente em ambiente de PRODUÇÃO! Realize-o sempre, primeiro, em ambiente de HOMOLOGAÇÃO e, uma vez bem-sucedido, valide o êxito da unificação e, na sequência, realize todo o processo em ambiente de PRODUÇÃO.

Fluxo de homologação e produção no processo de Unificação de Bases (sugestão)​

Fluxo de homologação e produção no processo de Unificação de Bases

Fonte: SAPS / UFMG (Educa e-SUS APS)

Processo de Unificação de Bases no Prontuário Eletrônico e-SUS APS​

Passo 1 - Instalação Descentralizada (que enviará a base para unificação)

O Administrador da Instalação deverá clicar no menu lateral Configurações da instalação, aba Unificação de base. O sistema apresentará as opções abaixo:

Aba Unificação de base em Configurações da instalação

Clique na opção Envio de dados para a instalação central do município e preencha os campos:

  • Nome da minha instalação: nome da Unidade de Saúde da Instalação Descentralizada;
  • Link da instalação central: domínio da Instalação Central que receberá a base de dados (exemplo: https://esusaps.municipio.uf.gov.br);
  • Senha na instalação central: senha do usuário que está realizando o processo na Instalação Central. O usuário Administrador da Instalação que realiza a unificação deve ser o mesmo nas duas instalações, tanto na que envia quanto na que recebe a base.

Em seguida, clique em Solicitar unificação.

Solicitação de envio para a instalação central do município

A solicitação ficará com o status Aguardando aprovação:

Solicitação com status Aguardando aprovação

Passo 2 - Instalação Central (que receberá a base a ser unificada)

Na aba Unificação de base, clique na opção Recebimento de dados de instalações locais, localize a solicitação da Instalação Descentralizada, clique em Aceitar e confirme em Sim, aceitar solicitação:

Aceite da solicitação na Instalação Central

Passo 3 - Instalação Descentralizada (que enviará a base para unificação)

Aguarde até que o botão Unificar esteja disponível para ser selecionado (em alguns casos, pode demorar alguns minutos). Clique em Unificar e confirme a ação. O status passará a Unificando base:

Início da unificação na Instalação Descentralizada

Passo 4 - Instalação Central (que receberá a base a ser unificada)

Verifique o status e a conclusão do processo em Recebimento de dados de instalações locais:

Status Unificando base na Instalação Central

Ao final, o status passará a Base unificada:

Status Base unificada

nota

O tempo de unificação poderá variar conforme o tamanho da base de dados da Instalação Descentralizada e a qualidade da conexão, podendo levar algumas horas para ser concluído. A depender do tamanho da base de dados, considere realizar o procedimento no final de semana.

atenção

Realize somente um processo de unificação por vez.

atenção

Em caso de erro no processo, NÃO faça uma nova tentativa. Abra um chamado no Canal de Suporte dos sistemas da Estratégia e-SUS APS, enviando os arquivos pec.log (encontrados no diretório C:\Program Files\e-SUS\webserver\logs, no Windows, ou /opt/e-SUS/webserver/logs, no Linux) e o backup das duas instalações (Instalação Central e Instalação Descentralizada). Aguarde o retorno do chamado para a resolução do erro. Nesse ínterim, restaure nas instalações os backups realizados antes de iniciar todo o processo, evitando, assim, qualquer situação de inconsistência dos dados e de inacessibilidade das instalações.

Após a unificação ser realizada com sucesso, valide o êxito do processo e repasse o novo link de acesso da Instalação Central do Prontuário Eletrônico e-SUS APS aos profissionais de saúde da(s) Unidade(s) que teve(tiveram) a(s) sua(s) base(s) unificada(s).

Vale ressaltar que todos os profissionais que acessavam a Instalação Descentralizada terão suas senhas redefinidas.

dica

Se a Instalação Central tiver o serviço de SMTP ativado e os profissionais tiverem seus e-mails cadastrados corretamente no CNES municipal ou no Prontuário Eletrônico e-SUS APS, basta que eles utilizem a opção Esqueci minha senha na tela de login para recuperar o acesso.

Procedimentos a serem realizados após a Unificação de Bases​

  • Desative imediatamente a Instalação Descentralizada que teve sua base de dados unificada, para evitar novos acessos e registros;

  • A(s) Unidade(s) de Saúde que acessava(m) a Instalação Descentralizada passarão a acessar o Prontuário Eletrônico e-SUS APS unicamente pelo novo endereço da Instalação Central (exemplo: https://esusaps.municipio.uf.gov.br). Também é necessário alterar o endereço do servidor em todos os dispositivos que utilizam os aplicativos da Estratégia e-SUS APS;

  • Os perfis que foram customizados manualmente na Instalação Descentralizada não serão enviados para a Instalação Central, pois apenas são cadastradas as lotações no sistema de acordo com o XML importado. Caso avalie necessário, os perfis cadastrados manualmente deverão ser recadastrados na Instalação Central;

  • Caso os cidadãos possuam vínculo com equipes na Instalação Descentralizada, este vínculo será enviado à Instalação Central. As consultas agendadas dos cidadãos também serão enviadas normalmente. Contudo, as agendas individuais dos profissionais (fechamento, dias e horários de trabalho) não serão enviadas, sendo necessário reconfigurá-las;

  • Após realizar a unificação de todas as Instalações Descentralizadas, verifique e unifique os cadastros em duplicação na Instalação Central. Para isso, utilize a própria ferramenta do e-SUS APS: clique em Gestão de Cadastros e, depois, em Unificação de bases - Cadastros duplicados.

Módulo Unificação de bases - Cadastros duplicados

atenção

Para que não ocorram inconsistências nos Cadastros Individuais e em seus núcleos familiares, é necessária a verificação e a adequação dos documentos de identificação dos cidadãos replicados. Consideramos esta etapa final imprescindível, sendo necessário definir prazos para a sua conclusão, além de garantir o envolvimento dos profissionais das equipes, incluindo Agentes Comunitários de Saúde (ACS) e recepção, bem como o matriciamento e o monitoramento da execução pela gestão da APS e pela equipe de tecnologia envolvida no processo.

3ª versão. Atualizado em 06 de novembro de 2026.