**Validação de compatibilidade entre planilha e tabela** Durante a etapa de configuração do upload, o upFiles realiza uma verificação automática de compatibilidade entre a estrutura da planilha enviada e a estrutura da tabela selecionada como destino. Essa validação considera, principalmente, a quantidade e a ordem das colunas, uma vez que o mapeamento dos dados ocorre por posição. A lista exibida contempla apenas tabelas originadas pelo upFiles, facilitando a identificação correta da base que receberá os novos dados. A seleção da tabela correta é essencial para garantir a integridade das informações e a continuidade das análises futuras no Metabase.
### Definição do comportamento do upload Após selecionar a tabela de destino, o usuário deve definir **como os novos dados serão tratados em relação aos registros já existentes**. Existem duas possibilidades principais: - **Substituir tudo (limpa e reinsere)**: remove os dados atuais da tabela e insere apenas os dados do novo arquivo. - **Adicionar aos dados existentes**: mantém os registros atuais e insere os novos dados na mesma tabela. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/LURimage.png) Quando a opção de adicionar aos dados existentes é selecionada, torna-se necessário definir o comportamento em caso de registros duplicados, com base na chave primária previamente configurada. ### Tratamento de duplicidades Nos casos em que um registro do novo arquivo possui a mesma chave primária de um registro já existente na tabela, o sistema permite duas abordagens: - **Ignorar e manter os dados antigos**: os registros existentes são preservados e os novos são descartados quando ocorre duplicidade. - **Atualizar (sobrescrever com novos)**: os registros existentes são substituídos pelos dados mais recentes do arquivo enviado. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/5ZDimage.png) Essa escolha deve considerar o objetivo da base de dados e a forma como os relatórios são atualizados ao longo do tempo. ### Identificação e auditoria do upload Antes da execução do upload, o sistema solicita a **identificação do responsável pelo envio**, por meio do CPF. Essa informação é utilizada exclusivamente para fins de rastreabilidade e auditoria, permitindo identificar quando e por quem determinado conjunto de dados foi inserido. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/FKnimage.png) Após a confirmação, o processo de upload é iniciado e os dados passam a integrar a tabela selecionada, ficando disponíveis para análise no Metabase. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/yE5image.png) ### Uso dos dados no Metabase Concluído o upload, o trabalho de estruturação no upFiles é finalizado. A partir desse ponto, a exploração, análise e visualização dos dados passam a ser realizadas diretamente no Metabase, por meio da criação ou atualização de painéis, gráficos e consultas. Essa separação entre **estruturação de dados** e **análise visual** reforça a lógica adotada pela Saúde Digital, garantindo maior controle sobre as bases de dados e mais segurança no uso das informações. --- # Metabase: análise e visualização de dados [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/1s7image.png) A análise de dados na Saúde Digital tem como objetivo transformar bases estruturadas em informações compreensíveis, capazes de apoiar o monitoramento de processos, a avaliação de resultados e a tomada de decisão. Essa análise ocorre a partir de dados previamente organizados e validados, sendo a visualização uma etapa final desse processo. Ferramentas de Business Intelligence, conhecidas como ferramentas de BI, são utilizadas para representar dados por meio de gráficos, tabelas e painéis interativos. Essas ferramentas não produzem nem corrigem dados, mas permitem explorar informações já existentes, facilitando sua leitura por diferentes perfis de usuários, como gestores, técnicos e equipes de apoio. Entre as ferramentas de BI mais conhecidas estão soluções amplamente difundidas no mercado, como o Power BI, além de alternativas open source. Todas compartilham o mesmo princípio, transformar dados estruturados em visualizações que auxiliam a compreensão da informação. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/yujimage.png) --- ### O Metabase no contexto da Saúde Digital No âmbito da Saúde Digital, o [Metabase](https://saudedigital.sorocaba.sp.gov.br/metabase) é a ferramenta adotada para análise e visualização de dados. Um dos fatores que motivaram sua escolha é o fato de se tratar de uma [**ferramenta open source**](https://www.metabase.com/start/oss/), sem custo de licenciamento para a administração pública, além de permitir integração direta com bancos de dados utilizados pelo setor. O [Metabase](https://saudedigital.sorocaba.sp.gov.br/metabase) é utilizado para criar gráficos e painéis a partir de bases estruturadas, seja por meio de tabelas preparadas no [upFiles](https://saudedigital.sorocaba.sp.gov.br/upFiles/) ou por conexões diretas a bancos de dados. Ele deve ser compreendido como uma ferramenta de apoio à análise, refletindo exatamente os dados disponíveis nas bases acessadas. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/SaWimage.png) --- ## Organização das informações no Metabase Antes de criar ou acessar visualizações no Metabase, é importante entender **como a ferramenta organiza os conteúdos**. Essa organização facilita a navegação, a interpretação das informações e o controle de acesso. - **Coleções** Funcionam como **pastas**. Servem para organizar painéis e gráficos por tema ou finalidade, como gestão, monitoramento ou apoio técnico.As coleções também ajudam no **controle de acesso**, pois os perfis de usuários podem ser configurados para acessar apenas determinadas coleções, garantindo que cada público visualize apenas as informações adequadas.
- **Painéis** São **telas que reúnem vários gráficos** sobre um mesmo assunto. Um painel permite acompanhar diferentes informações relacionadas a um processo em um único local, facilitando a análise e o acompanhamento. - **Gráficos** São as **visualizações dos dados**, como tabelas ou gráficos de barras. Cada gráfico apresenta um recorte específico da base de dados, definido por critérios como período, unidade de saúde ou situação do registro. Essa estrutura permite que o Metabase apresente informações de forma organizada e segura, desde análises simples até painéis mais completos, respeitando o perfil de acesso e a qualidade dos dados disponíveis. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/ITsimage.png)**Atenção à escolha da coleção ao criar painéis** Antes de criar um painel no Metabase, é importante definir em qual coleção ele será armazenado, pois essa escolha influencia diretamente a organização das análises e o controle de acesso às informações. No Metabase, os perfis de acesso são organizados por setor, e cada perfil visualiza apenas as coleções que lhe foram atribuídas. Dessa forma, manter os painéis nas coleções corretas facilita a configuração dos acessos e garante que cada setor veja apenas as informações pertinentes. A coleção Saúde Digital é destinada, em geral, a painéis de uso interno do setor, como análises técnicas, correções de cadastro, validações de dados e painéis em fase de teste, que não são voltados à divulgação ampla. Já a coleção Gestão SES concentra painéis consolidados e compartilhados, utilizados por mais de um setor da Secretaria da Saúde. Nela ficam análises que atendem simultaneamente áreas como Atenção Primária, Atenção Especializada e Vigilância, como painéis de absenteísmo ou de transmissão de vacinas à RNDS. Sempre que um painel tiver uso transversal ou interesse de múltiplos setores, a orientação é que ele seja criado ou organizado na coleção Gestão SES, facilitando o gerenciamento dos perfis de acesso e promovendo o uso seguro e consistente das informações.
--- ### Exemplo prático: criação de gráficos no Metabase a partir do zero Embora já existam painéis consolidados sobre a transmissão de dados de vacinas para a RNDS, este exemplo parte da criação de um **novo painel do zero**, na coleção **Gestão SES**, com finalidade exclusivamente didática. O objetivo é ilustrar conceitos básicos do Metabase e a lógica de construção de gráficos, sem aprofundar em análises complexas. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/mNlimage.png) [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/TBYimage.png) É importante destacar que o Metabase, assim como outras ferramentas de Business Intelligence, não depende apenas da ferramenta em si, mas principalmente de **testes, validações e análise crítica dos dados**. Muitas dessas validações se assemelham ao chamado *teste de mesa*, amplamente utilizado na formação em Tecnologia da Informação, no qual o comportamento dos dados é analisado antes de qualquer conclusão. O Metabase oferece diversos tipos de gráficos e visualizações, além de recursos como filtros, sumarizações, ordenações e junções entre tabelas. Neste exemplo, no entanto, será utilizada uma **estrutura simples**, baseada em uma única tabela, sem junções, apenas para demonstrar o funcionamento básico da ferramenta. --- ### Estratégia de construção dos gráficos Uma prática comum na construção de painéis é iniciar pela criação de um **gráfico base**, considerando todos os dados e filtros que poderão ser utilizados posteriormente. Esse gráfico inicial serve como modelo e pode ser duplicado, facilitando a criação de novas visualizações sem a necessidade de repetir configurações. Neste exemplo, serão criados **dois gráficos**, ambos a partir da mesma tabela de transmissão de dados: - o primeiro gráfico apresentará o **total de registros existentes na tabela**, independentemente do status da transmissão - o segundo gráfico será criado a partir da **duplicação do primeiro**, ajustando apenas a forma de apresentação da informação Essa abordagem torna o processo mais ágil e reduz a chance de inconsistências entre os gráficos do mesmo painel. --- ### Gráfico 1: total de registros por status de integração O primeiro gráfico tem como objetivo oferecer uma **visão geral da base de dados**, apresentando o total de registros existentes e sua distribuição por **status de integração**, como enviados, com erro ou outros estados disponíveis na tabela. Para iniciar a construção desse gráfico, acesse o painel previamente criado e inclua um novo conteúdo. Isso pode ser feito tanto pela opção de **criar uma nova pergunta** quanto pela opção de **adicionar um gráfico**, pois ambas conduzem ao mesmo ambiente de construção de análises do Metabase. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/SbEimage.png) Ao iniciar esse processo, o primeiro passo é **selecionar a tabela que será utilizada como base da análise**. É a partir dessa tabela que o Metabase irá explorar os dados, aplicar as sumarizações definidas e transformar as informações em visualizações gráficas. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/Ju3image.png) Neste momento, você estará visualizando a **tela de montagem visual de gráficos do Metabase**, que utiliza uma interface intuitiva e não exige conhecimento de codificação. Essa abordagem permite que a análise seja construída de forma guiada, facilitando o uso mesmo por usuários com menor familiaridade técnica. Nessa tela, já é possível identificar, na seção **Dados**, qual é a tabela que está sendo utilizada como base para a análise. Essa conferência é importante para garantir que a visualização está sendo construída a partir da fonte correta antes de avançar para as demais configurações. Para este exemplo, os outros botões de ação disponíveis na interface podem ser ignorados neste primeiro momento. Funcionalidades como **unir dados**, **criar colunas personalizadas**, **adicionar filtros para limitar os resultados**, **ordenar informações** ou **definir limite de linhas** serão exploradas posteriormente, conforme o usuário se familiarizar com a ferramenta e passar a trabalhar com outros conjuntos de dados. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/WNcimage.png) Prosseguindo com a criação do gráfico, ao clicar no botão **Resumir**, o Metabase passa a trabalhar os dados de forma agregada, ou seja, deixa de exibir os registros linha a linha e passa a **resumir a informação com base em funções e agrupamentos**. Essa etapa é fundamental para a construção de gráficos e indicadores, pois é nela que definimos “o que queremos contar, somar ou analisar” e “como esses dados devem ser agrupados”. Dentro do **Resumir**, o primeiro passo é escolher uma **função ou métrica**, que define qual tipo de cálculo será aplicado sobre os dados. Entre as opções disponíveis, estão, por exemplo: - **Contagem de linhas**, que contabiliza quantos registros existem na tabela ou em determinado recorte dos dados. É útil quando cada linha representa um evento, atendimento ou registro individual. - **Número de valores distintos**, que conta quantos valores únicos existem em uma coluna, como quantidade de pacientes diferentes ou unidades distintas. - **Contagem cumulativa de linhas**, que soma os registros de forma progressiva, normalmente utilizada em análises temporais. - **Mínimo de** e **Máximo de**, que identificam o menor ou maior valor de uma coluna numérica ou de data, ajudando a entender limites dos dados. - **Expressão personalizada**, que permite criar cálculos mais específicos, combinando campos ou aplicando regras customizadas, sendo mais utilizada em análises avançadas. Para este exemplo, será utilizada a função **Contagem de linhas**, pois cada linha da tabela representa um registro de transmissão. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/s7timage.png) Após escolher a função, o Metabase permite definir **por qual campo os dados serão agrupados**, criando as chamadas “quebras” da análise. É nesse ponto que informamos, por exemplo, que a contagem deve ser separada por **status**, **unidade de saúde**, **período** ou qualquer outra categoria relevante. Essa combinação entre função e agrupamento é o que dá sentido à visualização final. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/jlZimage.png) Ao combinar essa contagem com o campo **Status**, o Metabase passa a apresentar quantos registros existem em cada situação, como enviados, com erro ou em outros estados possíveis, oferecendo uma **visão geral simples e objetiva** do cenário de transmissão.Nesse ponto, as configurações necessárias para o gráfico já estão definidas. Ainda assim, é importante destacar que, a qualquer momento, é possível clicar em **Visualizar** para acompanhar como o gráfico está sendo montado e verificar se o resultado corresponde ao esperado.
Antes de salvar a análise, é necessário ajustar a **forma de visualização do gráfico**. Para isso, clique em **Visualizar** e, na tela seguinte, utilize novamente a opção **Visualizar** para escolher o tipo de gráfico mais adequado para representar os dados, como barras, rosca ou tabela, conforme o objetivo da análise. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/0lYimage.png) É recomendável utilizar o ícone de **engrenagem** para ajustar a forma como os dados são exibidos no gráfico. Nessa área, é possível configurar elementos visuais que facilitam a leitura e a interpretação da informação apresentada. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/W1Cimage.png) Com o gráfico finalizado, basta clicar em **Salvar** para definir um **nome** e, se necessário, incluir uma **descrição**, facilitando a identificação e o entendimento do gráfico dentro do painel e da coleção em que ele será armazenado. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/WGqimage.png) Após salvar o gráfico, você será redirecionado automaticamente ao **painel**, onde já será possível visualizar o gráfico inserido. Observe que, na parte superior da página, o painel se encontra em **modo de edição**, o que faz com que os botões de ação relacionados à edição estejam visíveis. Nesse modo, já é possível **redimensionar e reposicionar os gráficos** na tela, bem como **adicionar filtros ao painel**, que poderão ser utilizados posteriormente para refinar as visualizações. Essas funcionalidades permitem personalizar a apresentação das informações de acordo com a necessidade da análise. As configurações de layout e de filtros do painel não serão detalhadas neste material. A proposta é que você explore essas possibilidades diretamente na ferramenta, de forma gradual, à medida que se familiariza com o uso do Metabase. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/DNwimage.png) --- ### Gráfico 2: duplicação e reaproveitamento do gráfico base Agora que o primeiro gráfico já foi criado e salvo, o próximo passo é **sair do modo de edição do painel**. Essa etapa é necessária porque a criação de um novo gráfico a partir de um existente ocorre por meio da **edição do gráfico já criado**, e não diretamente dentro do painel em modo de edição. Com o painel em modo de visualização, selecione o gráfico já existente e acesse a opção de **edição**. A partir desse ponto, o Metabase permite alterar as configurações do gráfico conforme necessário, como ajustes de agrupamento, filtros ou tipo de visualização, reutilizando toda a estrutura já definida anteriormente. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/foJimage.png) Após realizar as alterações desejadas, ao clicar em **Salvar**, escolha a opção **Salvar como novo gráfico**. Dessa forma, o gráfico original é preservado, e uma nova visualização é criada a partir dele, reaproveitando a base de dados e as configurações iniciais, o que facilita a criação de novos gráficos de forma mais rápida e consistente. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/Uj8image.png) Essa abordagem permite trabalhar com um **gráfico base**, a partir do qual novas análises podem ser geradas, mantendo padronização e reduzindo retrabalho na construção dos painéis. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/7T7image.png) --- ### Considerações sobre validação e interpretação Este exemplo demonstra apenas o **uso básico do Metabase** para a criação de gráficos simples. Na prática, análises mais robustas exigem **testes contínuos**, avaliação cuidadosa dos resultados, possíveis **uniões entre tabelas** e, sempre que necessário, a comparação com outras fontes de informação, garantindo que os dados apresentados sejam consistentes e úteis para a gestão. O Metabase deve ser compreendido como uma **ferramenta de apoio à análise**, e não como uma fonte automática de verdade. A qualidade das visualizações produzidas está diretamente relacionada à **qualidade da base de dados utilizada** e ao cuidado na definição das métricas, filtros e critérios de agrupamento adotados durante a análise. Por esse motivo, a interpretação dos gráficos e painéis deve ser feita de forma crítica e contextualizada, considerando as limitações dos dados e o objetivo da análise. Visualizações bem construídas auxiliam a tomada de decisão, mas não substituem a análise técnica nem o conhecimento dos processos que originaram os dados. Para aprofundamento técnico sobre o uso da ferramenta, além da realização de testes práticos pelo próprio usuário, recomenda-se a consulta ao **manual oficial do Metabase**, especialmente o material introdutório sobre dashboards e visualizações. [Introdução aos Dashboards do Metabase](https://www.metabase.com/docs/latest/dashboards/introduction). --- # Fluxo de Atualização dos Painéis de Dados Nas páginas anteriores, foram apresentados os conceitos básicos de análise de dados e o uso do Metabase como ferramenta de visualização. A partir deste ponto, o foco passa a ser a **manutenção e atualização dos painéis já existentes**, garantindo que as informações exibidas continuem refletindo, de forma adequada, a realidade dos dados disponíveis. Para acessar os conteúdos específicos, utilize o **menu lateral esquerdo da Estante SES**, onde estão organizados, em estrutura de árvore, os painéis cuja atualização mínima é de responsabilidade da equipe da Saúde Digital. Cada painel possui sua própria página, com orientações direcionadas ao seu contexto. A atualização dos painéis não consiste na recriação dos gráficos, mas sim na **atualização das bases de dados que os alimentam**. Esse processo é essencial para que gestores e equipes que utilizam os painéis tenham acesso a informações atuais, consistentes e úteis para o acompanhamento das atividades e apoio à tomada de decisão. Em cada página, serão apresentados exemplos de painéis já existentes, indicando **a origem dos dados**, **qual tabela deve ser atualizada no upFiles** e **como verificar, no Metabase, se a atualização foi realizada com sucesso**. O objetivo é orientar a equipe quanto ao fluxo de atualização, sem aprofundar em decisões técnicas que podem variar conforme o tipo de dado ou sistema de origem. É importante destacar que nem todos os painéis possuem a mesma periodicidade ou utilizam as mesmas fontes de dados. Por esse motivo, cada painel é tratado individualmente, respeitando as particularidades do sistema de origem, do formato do relatório e da finalidade da informação apresentada. --- ## Integração de Vacinas à RNDS| **Onde encontrar o painel no Metabase** | [Metabase](https://saudedigital.sorocaba.sp.gov.br/metabase/) > [Gestão SES](https://saudedigital.sorocaba.sp.gov.br/metabase/collection/71-gestao-ses) > [Integração de Vacinas à RNDS](https://saudedigital.sorocaba.sp.gov.br/metabase/dashboard/580-integracao-de-vacinas-a-rnds?c%25C3%25B3digo_da_imuniza%25C3%25A7%25C3%25A3o=&data_da_aplica%25C3%25A7%25C3%25A3o=past30days~&dose=&estrat%25C3%25A9gia=&imunobiol%25C3%25B3gico=&profissional=&status_da_integra%25C3%25A7%25C3%25A3o_rnds=&tab=360-an%C3%A1lise-de-dados&unidade_de_sa%25C3%25BAde=) |
| **Sistema utilizado para coleta dos dados** | Sistema de Gestão Pública de Saúde - SIS <[https://sisweb.sorocaba.sp.gov.br](https://sisweb.sorocaba.sp.gov.br)> |
| **Módulo/Local do relatório no Sistema** | Integração > RNDS > Integração RIA (Vacinas) |
| **Período que deve ser atualizado** | Semanal, com upload realizado uma vez por semana, considerando sempre os dados da semana anterior. A atualização deve ocorrer às segundas-feiras, após a finalização da transmissão e correção das vacinas registradas na sexta-feira e no sábado. |
| **Tabela utilizada no upFile** | uf\_ria\_rnds\_vacinas |
| **Tipo de atualização no upFile** | Upload de Dados > Adicionar aos dados existentes > Atualizar (sobrescrever com novos) |
| **Como validar a atualização no Metabase** | Conferir se o volume total de registros do painel aumentou de forma compatível com a quantidade de imunizações transmitidas no período analisado e, principalmente, se a distribuição por status apresenta apenas os valores esperados (É importante considerar que a exportação do SIS pode conter registros duplicados da chave primária (Código), e que esse comportamento é tratado no upFiles de acordo com o tipo de atualização selecionado durante o upload.). O gráfico de Status de Integração deve concentrar os registros nos status Enviado e Erro. A presença de status como Lote não gerado ou Lote gerado indica inconsistências no processo de preparação ou envio dos dados e deve ser tratada no sistema de origem antes de novas atualizações. |
Essa etapa pode levar, em média, **entre 5 e 10 minutos** para que o sistema conclua o processamento e retorne a lista de imunizações.
Assim que os dados forem exibidos no sistema, clique no **botão de exportação de dados** e selecione a opção **MS Excel** para realizar o download do arquivo. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/n49image.png) Após realizar o upload dos dados no **upFiles**, acompanhe principalmente o **gráfico de Status de Integração ao longo do tempo** no Metabase. Nesse gráfico, espera-se que sejam apresentados apenas registros com os status **“Enviado”** e **“Erro”**, que representam o fluxo regular de transmissão das informações. Caso sejam identificados outros status, isso caracteriza um **ponto de atenção** no processo. Nessas situações, pode ser necessário realizar a **correção dos dados dos pacientes**, proceder com o **reenvio das informações**, **reemitir o relatório** no sistema de origem e, posteriormente, efetuar novamente o upload no upFiles, mantendo a **mesma configuração já estabelecida para este painel**.É importante destacar que a **extração e o upload dos dados devem ser realizados sempre considerando períodos de até uma semana**. A utilização de intervalos maiores aumenta significativamente a demanda de recursos do servidor, podendo impactar o desempenho do sistema e comprometer o funcionamento de outros serviços. O uso de períodos semanais contribui para a estabilidade do ambiente e para a continuidade das operações.
[](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/q0Yimage.png) O gráfico de **Status de Integração ao longo do tempo** tem como finalidade acompanhar o comportamento das transmissões de imunizações para a RNDS, permitindo identificar rapidamente tanto as situações esperadas quanto os pontos que demandam atenção no processo. **Status apresentados no gráfico:** - **Enviado** - Indica que a imunização foi devidamente registrada na RNDS. - Representa o **fluxo correto e esperado** do sistema. - **Erro** - Sinaliza falhas na transmissão das informações. - Deve ser acompanhado com atenção, pois permite: - identificar unidades ou profissionais com maior recorrência de problemas, - analisar os motivos dos erros, - avaliar a necessidade de orientações, capacitações adicionais ou ajustes de parametrização no sistema. - **Lote não gerado** - Indica imunizações que permaneceram no sistema **sem preparo para envio** à RNDS. - Representa uma falha anterior à etapa de transmissão. - **Lote gerado** - Corresponde a lotes que foram preparados, mas **ainda não transmitidos** à RNDS. - Indica interrupção do fluxo após a preparação do envio. **Observações importantes:** - Os status **Lote não gerado** e **Lote gerado** não devem aparecer no gráfico ao longo do tempo. - A presença desses status caracteriza um **desvio significativo do fluxo esperado**, indicando falhas no processo de preparação ou envio dos dados. - Nesses casos, é necessário **revisar o procedimento no sistema de origem** antes de realizar qualquer nova atualização no upFiles. Dessa forma, o comportamento esperado do gráfico é a concentração dos registros apenas nos status **Enviado** e **Erro**, sendo este último utilizado como insumo para **monitoramento, análise crítica e ações de melhoria contínua** no processo de registro e transmissão de imunizações. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/x9Ximage.png) --- ## Relatório de Agendas de Serviço| **Onde encontrar o painel no Metabase** | [Metabase](https://saudedigital.sorocaba.sp.gov.br/metabase/) > [Gestão SES](https://saudedigital.sorocaba.sp.gov.br/metabase/collection/71-gestao-ses) > [Relatório de Agendas de Serviço](https://saudedigital.sorocaba.sp.gov.br/metabase/collection/324-relatorio-de-agendas-de-servico) > [Alta com Continuidade do Cuidado](https://saudedigital.sorocaba.sp.gov.br/metabase/dashboard/515-alta-com-continuidade-do-cuidado?categoria=&m%25C3%25AAs%252Fano=past12months~&procedimento=&servi%25C3%25A7o=&unidade_de_sa%25C3%25BAde=) [Metabase](https://saudedigital.sorocaba.sp.gov.br/metabase/) > [Gestão SES](https://saudedigital.sorocaba.sp.gov.br/metabase/collection/71-gestao-ses) > [Relatório de Agendas de Serviço](https://saudedigital.sorocaba.sp.gov.br/metabase/collection/324-relatorio-de-agendas-de-servico) > [Atenção Primária à Saúde](https://saudedigital.sorocaba.sp.gov.br/metabase/dashboard/418-atencao-primaria-a-saude?categoria=&m%25C3%25AAs%252Fano=past12months~&procedimento=&servi%25C3%25A7o=&unidade_de_sa%25C3%25BAde=) [Metabase](https://saudedigital.sorocaba.sp.gov.br/metabase/) > [Gestão SES](https://saudedigital.sorocaba.sp.gov.br/metabase/collection/71-gestao-ses) > [Relatório de Agendas de Serviço](https://saudedigital.sorocaba.sp.gov.br/metabase/collection/324-relatorio-de-agendas-de-servico) > [Policlínica Municipal Dr. Edward Maluf](https://saudedigital.sorocaba.sp.gov.br/metabase/dashboard/579-policlinica-municipal-dr-edward-maluf?categoria=&m%25C3%25AAs%252Fano=past12months~&procedimento=&servi%25C3%25A7o=&unidade_de_sa%25C3%25BAde=) |
| **Sistema utilizado para coleta dos dados** | Sistema de Gestão Pública de Saúde - SIS <[https://sisweb.sorocaba.sp.gov.br](https://sisweb.sorocaba.sp.gov.br)> |
| **Módulo/Local do relatório no Sistema** | Regulação > Relatórios > Relatório de pacientes agendados |
| **Período que deve ser atualizado** | Semanal, com upload realizado uma vez por semana, considerando sempre os dados da semana anterior. A atualização deve ocorrer após o fechamento automático das faltas no sistema (preferencialmente as terças-feiras), que acontece com um intervalo de dois dias, garantindo que os registros de comparecimento e ausência estejam consolidados no momento da extração. |
| **Tabela utilizada no upFile** | uf\_agenda\_de\_servicos |
| **Tipo de atualização no upFile** | Upload de Dados > Adicionar aos dados existentes > Atualizar (sobrescrever com novos) |
| **Como validar a atualização no Metabase** | A validação dos dados de agenda é realizada de forma comparativa, considerando as limitações do relatório disponível no sistema de origem. Para cada período, os dados precisam ser extraídos separadamente em dois conjuntos, pacientes recepcionados e pacientes faltosos, que juntos compõem a base utilizada para o controle de absenteísmo. A extração e o upload dos dados devem ocorrer preferencialmente às terças-feiras, garantindo que o sistema já tenha aplicado o fechamento automático das faltas. Após o upload no upFiles, a validação consiste em verificar se os valores apresentados no Metabase estão coerentes com a quantidade aproximada de registros observada durante o upload, especialmente por meio do gráfico que apresenta a proporção entre atendidos e faltosos. O painel considera exclusivamente esses dois tipos de agendamento, não contemplando análises de vagas abertas ou outros estados. |
É importante destacar que a **extração e o upload dos dados devem ser realizados sempre considerando períodos de até uma semana**. A utilização de intervalos maiores aumenta significativamente a demanda de recursos do servidor, podendo impactar o desempenho do sistema e comprometer o funcionamento de outros serviços. O uso de períodos semanais contribui para a estabilidade do ambiente e para a continuidade das operações.
[](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/UxXimage.png) É importante lembrar que o processo de obtenção dos dados para este painel ocorre em **duas etapas distintas**: uma extração considerando a **Situação – Recepcionado** e outra considerando a **Situação – Faltou**, sendo **ambas necessárias** para a composição da análise de absenteísmo. Após o download dos arquivos, lembre-se de realizar o **upload duas vezes no upFiles**, uma para cada arquivo, respeitando a situação correspondente a cada conjunto de dados. [](https://estante-ses.sorocaba.sp.gov.br/uploads/images/gallery/2025-12/14mimage.png) ---