Abrimos os dados brutos para você.

Por que abrir os dados?

A publicação de Dados Abertos é a prestação de informações como um serviço para a sociedade e para o próprio governo. O formato de Dados Abertos é bruto e prevê o seu reuso e cruzamento, gerando novas informações e o uso mais eficiente dos recursos públicos. Abrir os dados promove a inovação e a geração de valor, beneficiando os diversos setores da sociedade. Num momento onde a integração de informações é uma grande necessidade de governo, os dados abertos atendem e vão além, fornecendo essas informações ao cidadão para aumentar a transparência e para que esse tenha mais oportunidades de exercer sua cidadania.

Dados abertos está transformando o modo como o governo atua, isso compreende facilitar ao cidadão acessar os dados do governo e compartilhar as visualizações e percepções do ponto de vista deles.

O que são Dados Abertos?

Os Dados Abertos são a publicação e disseminação de dados na Web, compartilhadas em formato bruto e aberto, que possibilite compreensão automatizada, permitindo a criação de aplicações digitais. O movimento de Dados Abertos surgiu como uma demanda social para aumentar a transparência, a colaboração e a participação dos cidadãos nas políticas e ações do governo. Numa perspectiva de governo, Dados Abertos pode ser encarado como uma ferramenta de Governo Aberto, promovendo a modernização do parque tecnológico com arquiteturas novas, constituindo assim uma plataforma de interoperabilidade pro governo. Em resumo, os dados são abertos quando podem ser utilizados livremente, reutilizados de forma automatizada e redistribuídos para qualquer pessoa.

Um conceito de “aberto” mais aprofundado é mantido pela Open Knowledge Foundation:

http://www.opendefinition.org/okd/portugues-brasileiro/

A seguir a visão do W3C sobre dados abertos:

http://www.w3c.br/divulgacao/pdf/dados-abertos-governamentais.pdf

Os dados disponibilizados

O SICAF é o Sistema de Cadastramento Unificado de Fornecedores. Todo fornecedor que participa em contrato de compra realizado pelo governo federal tem seu registro, e habilitação para fornecer, realizado no SICAF.

O SICAF é mantido pela DLSG (Departamento de Logística e Serviços Gerais) da SLTI. Esta iniciativa coloca o Ministério do Planejamento como o primeiro órgão da administração direta a iniciar a abertuda dos dados.

Nessa primeira versão, estão disponibilizados os dados das Unidades Cadastradoras e dados dos Fornecedores. Ainda estão disponíveis vários métodos para consultas de dados auxiliares, lista de municípios por exemplo, úteis para criação de consultas mais complexas no cadastro. Em particular, os dados dos municípios fazem referências aos códigos utilizados pelo IBGE, chave que possibilita o cruzamento com outros conjuntos de dados que utilizam este mesmo princípio como chave. Os municípios também possuem dados geográficos, também do IBGE, diferencial na visualização das informações em mapas.

O cadastro dos fornecedores disponibiliza dados de linha de fornecimento, código CNAE, ramo de negócio e natureza jurídica dentre outros.

Abaixo uma lista com os nomes das propriedades que estão disponíveis em cada tipo de dado:

1. Dados das Unidades Cadastradoras
1. Nome da Unidade Cadastradora
2. Nome do órgão vinculado
3. Descrição do endereço
4. Cep
5. Telefone com ddd e ramal
6. Ponto geográfico
7. Quantidade de fornecedores cadastrados
8. Quantidade de fornecedores que se recadastraram no Novo SICAF
2. Dados dos Fornecedores
1. Tipo da pessoa
2. CNPJ
3. Natureza Jurídica
4. Código CNAE
5. Tipo da empresa
6. Ramo de negócio
7. Linha de fornecimento
8. Se recadastrou?
3. Dados de municípios
1. Nome do município
2. Código IBGE
3. Código GeoNames
4. Unidade federativa
5. Ponto geográfico

Atualidade

Um dos 8 princípios que definem os dados abertos governamentais defende que os dados devem ser disponibilizados o mais rápido possível a fim de preservar o seu valor agregado. Este projeto encontra-se na versão alpha, e para tal foram priorizadas funcionalidades essenciais para o funcionamento da arquitetura básica do serviço. Para a segunda versão (beta), está previsto um módulo de atualização automática coletando dados da base de produção. Na versão atual os dados são disponibilizados através de um processo semi-automatizado. O conjunto de dados disponível é referente a uma extração realizada no dia 15/04/11. Estamos nos esforçando para manter os dados mais atuais possíveis.

Licença de uso

Esses dados são disponibilizados sob a licença ODBL (Open DataBase License). Todos os direitos dos conteúdos individuais estão licenciados sob a DBCL (Database Contents License).

Case: Recadastramento de fornecedores

Recentemente foi lançada uma nova versão do SICAF. Os cadastros de fornecedores foram incrementados e receberam novos campos. Para levantar essas novas informações todos os fornecedores estão sendo recadastrados. Para apoiar esse recadastramento, uma aplicação web foi desenvolvida utilizando os dados abertos disponibilizados aqui. Para exemplificar a facilidade e o potencial de reuso dessa plataforma, essa aplicação foi desenvolvida num total de 25 horas, utilizando apenas HTML e JavaScript. Acompanhe o recadastramento dos fornecedores através do painel: http://api.comprasnet.gov.br/sicaf/app/painel.htm

Acessando os Dados Abertos

O acesso aos dados é feito através de nossa API, que consiste em endereços na Internet(URL) onde os dados são disponibilizados em formatos RDF, N3, XML, JSON e CSV, prontos para serem utilizados por outros aplicativos.

Para acessar os dados da API é necessário conhecer o endereço ou URL:

http://api.comprasnet.gov.br/sicaf/v1/<metodo>.<formato>?<atributo1>=<valor1>&<atributo2>=<valor2>

Dois parâmetros são necessários para solicitar qualquer dado através da API: <metodo> e <formato>. O método indica qual informação você quer e o formato define sua preferência em receber a resposta em RDF, N3, XML, JSON ou CSV. Consulte nossa documentação para saber quais são os métodos disponíveis. Os parâmetros campo e valor são utilizados para filtrar os registros retornados pelos métodos.

Exemplo 1: Para listar todos os municípios do estado São Paulo no formato XML utilize a url http://api.comprasnet.gov.br/sicaf/v1/consulta/municipios.xml?uf=sp

Exemplo 2: Para listar todas as Unidades Cadastradoras da cidade do Rio de Janeiro em formato JSON: http://api.comprasnet.gov.br/sicaf/v1/consulta/unidades_cadastradoras.json?id_municipio=60011

Todos os dados enviados para nossa API devem estar codificados em UTF-8 e todos os dados retornados pela nossa API estarão codificados em UTF-8. Enviar dados em uma codificação diferente pode causar erros.

Tecnologias extras

Além dos requisitos técnicos mínimos para uma boa infraestrutura de dados abertos, também implementamos algumas tecnologias que consideramos diferenciais, em termos de desempenho e flexibilidade, para os usuários dos dados.

Nosso servidor implementa CORS, possibilitando consultas de qualquer domínio através de protocolos HTTP. É uma alternativa moderna para o padrão JSONP. Possibilita que as aplicações MashUp façam cruzamento dos dados diretamente do navegador, utilizando apenas JavaScript, dispensando uma aplicação de servidor para fazer esse cruzamento.

Para minimizar o fluxo de dados enviados pelo servidor, a API possibilita a compactação dos arquivos de forma transparente utilizando o protocolo HTTP. A compressão é feita seguindo a especificação GZIP do HTTP. É necessário que a requisição HTTP informe que a aplicação cliente suporta a compactação, e conseguirá manipular a resposta.

Para as consultas que retornam milhares de resultados, decidimos implementar paginação. Através da utilização de um parâmetro extra é possível controlar a navegação pelas páginas dos resultados, Exemplo, o método fornecedores.

Consulte nossa documentação para saber quais são os métodos disponíveis.

Contato

Dúvidas de utilização ou reporte de erros da API podem ser enviadas para sisp@planejamento.gov.br.