Um portal pode disponibilizar centenas de arquivos e ainda dificultar a compreensão de suas informações. Quando um relatório só existe como imagem de uma tabela, analisar períodos, comparar despesas ou conferir um total exige trabalho manual. Dados abertos de qualidade procuram reduzir essa barreira, preservando contexto, autenticidade e os limites legais de divulgação.
Este artigo não é uma revisão geral da Lei de Acesso à Informação. O foco é operacional: formatos, dicionário de dados, atualização, acesso automatizado e proteção de informações pessoais. As recomendações técnicas são editoriais; a aplicação jurídica concreta deve ser avaliada pelos responsáveis do município.
O que a LAI diz sobre formatos
O artigo 8º da Lei nº 12.527/2011 trata da divulgação de informações de interesse coletivo ou geral independentemente de requerimento. Seu §3º inclui requisitos para os sítios eletrônicos, como pesquisa, gravação de relatórios em diversos formatos — inclusive abertos e não proprietários — e acesso automatizado em formatos abertos, estruturados e legíveis por máquina.
O dispositivo também aborda detalhamento dos formatos, autenticidade, integridade, atualização e acessibilidade. A análise não pode se reduzir a “o arquivo está online”. É necessário observar se o conteúdo pode ser encontrado, compreendido e utilizado de forma apropriada.
Há particularidades legais, como a previsão do §4º para municípios com até dez mil habitantes quanto à divulgação obrigatória na internet, sem afastar a divulgação em tempo real das informações orçamentárias e financeiras indicada no próprio dispositivo. A equipe jurídica deve examinar o enquadramento; este guia não afirma obrigação idêntica em toda situação.
O decreto federal tem escopo próprio
O Decreto nº 8.777/2016 institui a Política de Dados Abertos do Poder Executivo federal. Não deve ser apresentado como se impusesse automaticamente a cada prefeitura todos os procedimentos específicos dessa política.
Municípios devem observar normas nacionais aplicáveis e suas próprias regras. Podem utilizar referências federais para melhorar práticas, mas é importante distinguir referência técnica, obrigação nacional e regulamentação local.
Esse cuidado evita recomendações juridicamente imprecisas e ajuda a controladoria a construir uma política sustentável. Um plano copiado sem responsáveis, periodicidade ou recursos pode existir formalmente e não produzir dados utilizáveis.
PDF tem função, mas não resolve tudo
PDF é útil para preservar apresentação e disponibilizar documentos. Não é, porém, equivalente a uma base estruturada. Mesmo com texto pesquisável, uma tabela pode exigir extração complexa; um arquivo escaneado aumenta ainda mais a dificuldade.
Uma abordagem prática é fornecer a apresentação documental quando pertinente e também os dados estruturados apropriados. Isso não significa divulgar informação restrita nem converter qualquer documento em planilha sem análise. É preciso avaliar conteúdo, contexto e riscos.
Formato aberto também não basta sozinho. Um CSV com colunas sem definição, datas ambíguas e valores inconsistentes pode ser tão difícil de interpretar quanto um relatório mal explicado. Qualidade depende do conjunto de decisões de publicação.
Dicionário de dados: explique cada coluna
Um dicionário descreve nome, significado, tipo e regras de preenchimento de cada campo. Informa unidade de medida, código utilizado, relação com outras tabelas e distinção entre valor vazio e zero.
Num exemplo hipotético de despesas, um campo “valor” pode indicar empenhado, liquidado ou pago. Sem definição, dois leitores podem produzir análises incompatíveis. O dicionário deve deixar claro o que cada registro representa e como os estados se relacionam.
Identificadores precisam ser consistentes. Se um órgão muda de nome, a base deve explicar a alteração e preservar a possibilidade de acompanhar o histórico. Não é necessário expor identificadores pessoais para oferecer uma chave técnica de relacionamento quando isso não for pertinente.
Metadados respondem às perguntas sobre a base
Metadados descrevem o conjunto: assunto, órgão responsável, período, data de atualização, fonte, cobertura, formato e condições de uso pertinentes. O visitante deve saber o que está consultando antes de concluir algo a partir dos números.
Também é importante explicar limitações. A base contém apenas registros de determinado sistema? Inclui correções posteriores? Um mês está incompleto? O aviso de cobertura evita que ausência de dado seja confundida com ausência de atividade.
| Elemento | Pergunta do usuário | Conteúdo recomendado |
|---|---|---|
| Dicionário | O que esta coluna significa? | Definição e regras do campo |
| Metadados | Que período e universo estão cobertos? | Escopo, fonte e datas |
| Atualização | Qual informação é mais recente? | Data e política de atualização |
| Histórico | O que mudou na base? | Registro de correções e versões |
| Contato | Como reportar problema? | Canal e órgão responsável |
Atualização exige dono e procedimento
Defina quem extrai, quem valida e quem autoriza publicar. Uma rotina que depende de uma única pessoa sem documentação pode parar durante férias ou troca de equipe. Automatização ajuda, mas precisa de monitoramento e tratamento de falhas.
Valide estrutura e consistência antes de substituir arquivos. Uma extração vazia não deve apagar silenciosamente uma base correta. Registre quando houve falha e informe a situação ao responsável. Disponibilidade sem qualidade não é atualização bem-sucedida.
Correções também precisam de política. Se um dado for alterado, documente a natureza da mudança quando pertinente. Uma URL estável pode facilitar acesso, enquanto versões identificadas ajudam a reproduzir análises históricas. A escolha deve equilibrar manutenção e rastreabilidade.
Dados abertos e pessoais não são a mesma coisa
A LGPD e as regras de acesso à informação devem ser consideradas em conjunto. Transparência não equivale a autorização para publicar indiscriminadamente qualquer cadastro. Também não basta invocar proteção de dados para negar toda informação de interesse público.
Examine finalidade, obrigação de divulgação, conteúdo e risco. Bases que parecem não identificar pessoas podem permitir reidentificação por combinação de atributos. Agregação e retirada de campos precisam ser avaliadas conforme o contexto, não aplicadas como garantia automática de anonimização.
A equipe deve envolver responsáveis por dados, controladoria e avaliação jurídica. A pergunta é quais informações podem e devem ser publicadas, em que nível de detalhe e com quais cuidados. O processo precisa produzir decisões justificadas, não improvisadas a cada solicitação.
Acessibilidade e consumo automatizado
Disponibilizar um arquivo para download é apenas uma parte da experiência. A página deve explicar o conteúdo em linguagem clara e permitir navegação acessível. Links precisam ter nomes compreensíveis, e tabelas de visualização devem ser legíveis por tecnologias assistivas.
Quando houver acesso automatizado, documente filtros, paginação, limites e formatos. Um serviço que muda colunas sem aviso pode quebrar aplicações externas e comprometer análises. Versionamento e comunicação fazem parte da confiança na base.
Não é obrigatório criar uma API complexa para qualquer conjunto pequeno. O mecanismo adequado depende da atualização, do volume e das condições aplicáveis. O importante é não apresentar uma solução técnica específica como obrigação universal sem análise.
Checklist de qualidade para uma publicação
- Definir conjunto, finalidade e enquadramento de divulgação.
- Revisar conteúdo pessoal, restrições e risco de reidentificação.
- Escolher formatos utilizáveis e documentar estrutura.
- Publicar dicionário de campos e metadados.
- Validar datas, códigos, totais e relações pertinentes.
- Estabelecer responsáveis e rotina de atualização.
- Manter contato para dúvidas e correções.
- Verificar acessibilidade e continuidade do acesso.
Perguntas frequentes
Publicar PDF é sempre errado? Não. Ele pode ser adequado para documentos, mas não substitui automaticamente requisitos de dados estruturados e acesso previstos para o conteúdo.
CSV garante qualidade? Não. Significado, consistência e contexto também precisam ser documentados.
O decreto federal de dados abertos vale integralmente para municípios? Seu escopo é o Poder Executivo federal; normas municipais e nacionais aplicáveis devem ser analisadas separadamente.
Como demonstrar melhoria sem inventar indicadores? Registre erros encontrados, disponibilidade, atualização e testes de uso com método; publique apenas resultados realmente observados.
Próximo passo
Um portal útil torna informação verificável, não apenas visível. Conheça a solução de Portal da Transparência, os serviços para governo e converse sobre suas bases e processos de publicação.
Fontes e referências
- Planalto — Lei nº 12.527/2011, artigo 8º.
- Planalto — Decreto nº 8.777/2016.
- Planalto — Lei nº 13.709/2018.
Conteúdo informativo, não declaração de conformidade jurídica de um portal. Capa ilustrativa gerada por IA.