Dados Abertos disponíveis

Dados abertos consistem em informações que podem ser livremente utilizadas, reutilizadas e redistribuídas por qualquer cidadão. Os dados não estão sujeitos às restrições de privacidade, segurança ou outras condicionantes, seguindo os princípios da Lei de Acesso à Informação (Lei nº 12.527/2011 – LAI). O intuito é atingir a sociedade e grupos coletivos de colaboradores para que atuem na elaboração de novos produtos com as informações públicas.

Sobre a API

Todos os caminhos da API poderão ser acessados a partir do link https://docxpert.com.br.br/pmbreubranco/api/

  • Todos os caminhos da api utilizam o metodo de requisição GET;
  • A API, assim como o Portal da Transparência utililizam protocolo HTTPS;
  • Caminhos que possuem o padrão "/{qualquer-nome}/" são variáveis, por exemplo "/{ano}/" pode ser substituído por "/2023/";
  • As respostas das requisições são em formato JSON.

Exemplo de Uso

Os códigos-fonte abaixo são exemplos de como consumir a API de dados do Portal da Transparência utilizando as linguagens Javascript e PHP. Os exemplos foram desenvolvidos de forma simples sem levar em conta tratamento de erros e utilizando as funcionalidades padrão das linguagens de programação, sem bibliotecas externas. É possível consumir a API utilizando outras linguagens de programação, além de bibliotecas ou frameworks como jQuery e Spring para facilitar o desenvolvimento.

API's disponíveis

As informações da Prefeitura de Breu Branco estão distribuídas em diversos sistemas, por isso só disponibilizamos aqui os dados inseridos na PLATAFORMA DOCXPERT.

A seguir estão as API's disponíveis até o momento. No decorrer do tempo novas API's serão desenvolvidas e disponibilizadas.

Caso você precise de uma API para ter acesso a alguma informação específica, protocole sua necessidade através da CENTRAL DO CIDADÃO, ou a encaminhe através do FALE CONOSCO, selecionando o assunto "NOVA API".

RECURSOS HUMANOS

Descrição da Informação: Listagem nominal de servidores e suas remunerações. É preciso informar ano e mês da pesquisa.
Padrão: {caminho_da_api}/rh/?{ano}/{mês}
Onde: {ano} entre 2000 e ano corrente e {mes} entre 1 e 13.
Exemplo: https://docxpert.com.br/pmbreubranco/api/rh/?2022/12
Campo Descrição
nome Nome do servidor
admissao Data de admissão
cargo Cargo de ocupação
vinculo Tipo de vínculo no cargo ocupado (Efetivo, Comissionado, etc)
carga_horaria Carga Horária Semanal
vcto_bruto Remuneração bruta incluindo todas as gratificações
descontos Valor descontado referente apenas a INSS e IRPF
vcto_liquido Valor pago ao servidor após aplicação dos descontos ao valor bruto
ano Ano a que se refere o pagamento
mes_referencia Mês a que se refere o pagamento. Mês 13 se refere ao décimo tercero salário.
Exemplo em PHP
              <?php
                $url = "https://docxpert.com.br/pmbreubranco/api/rh/?2022/12";
                $client = curl_init($url);
                curl_setopt($client,CURLOPT_RETURNTRANSFER,true);
                $response = curl_exec($client);
                $rh = json_decode($response);
                foreach ($rh as $dados) {
                    echo "<p>Nome do Servidor: $dados->nome</p>";
                    echo "<p>Cargo: $dados->cargo</p>";
                    echo "<p>Salário Líquido: $dados->vcto_liquido</p>";
                    echo "<p>Período: $dados->mes_referencia / $dados->ano </p>";
                }
                curl_close($client);
              ?>
              
Exemplo em Javascript
              <html>
                <head>
                  <title>API de Dados Abertos</title>
                  <script type="text/javascript" language="javascript">
                    function enviar()
                    {
                        var requisicao = new XMLHttpRequest();
                        requisicao.addEventListener("load", listener);
                        requisicao.open("GET", "https://docxpert.com.br/pmbreubranco/api/rh/?2022/12");
                        requisicao.send();
                    }
                    function listener() {
                      document.getElementById('div').innerHTML = (this.responseText);
                    }
                  </script>
                </head>
                <body>
                  <button type="submit" onclick="javascript:enviar()">Executar</button>
                  <div id='div'></div>
                </body>
              </html>
              

LICITAÇÕES

Descrição da Informação: Listagem de processos licitatórios abertos em determinado exercício.
Padrão: {caminho_da_api}/licitacao/?{ano}/{mês}
Onde: {ano} entre 2000 e ano corrente e {mes} entre 1 e 12 - para consultar o exercício completo não informe o mês.
Exemplo: https://docxpert.com.br/pmbreubranco/api/licitacao/?2023/2
Campo Descrição
num_processo Número do Processo Licitatório
objeto Descrição do objeto da aquisição / contratação
data_abertura Data da abertura para credenciamento e julgamento
exercicio Ano do Processo Licitatório
modalidade Modalidade da Licitação
situacao Situação do andamento da Licitação
Exemplo em PHP
              <?php
                $url = "https://docxpert.com.br/pmbreubranco/api/licitacao/?2023/2";
                $client = curl_init($url);
                curl_setopt($client,CURLOPT_RETURNTRANSFER,true);
                $response = curl_exec($client);
                $licitacao = json_decode($response);
                foreach ($licitacao as $dados) {
                    echo "<p>Nº Processo: $dados->num_processo</p>";
                    echo "<p>Modalidade: $dados->modalidade</p>";
                    echo "<p>Situação: $dados->situacao</p>";
                    echo "<p>Objeto: $dados->objeto</p>";
                }
                curl_close($client);
              ?>
              
Exemplo em Javascript
              <html>
                <head>
                  <title>API de Dados Abertos</title>
                  <script type="text/javascript" language="javascript">
                    function enviar()
                    {
                        var requisicao = new XMLHttpRequest();
                        requisicao.addEventListener("load", listener);
                        requisicao.open("GET", "https://docxpert.com.br/pmbreubranco/api/licitacao/?2023/2");
                        requisicao.send();
                    }
                    function listener() {
                      document.getElementById('div').innerHTML = (this.responseText);
                    }
                  </script>
                </head>
                <body>
                  <button type="submit" onclick="javascript:enviar()">Executar</button>
                  <div id='div'></div>
                </body>
              </html>
              

CONTRATOS

Descrição da Informação: Listagem de contratos administrativos em determinado exercício. Padrão: {caminho_da_api}/contratos/?{ano}/{mês}
Onde: {ano} entre 2000 e ano corrente e {mes} entre 1 e 12 - para consultar o exercício completo não informe o mês.
Exemplo: https://docxpert.com.br/pmbreubranco/api/contratos/?2023
Campo Descrição
num_doc Número do instrumento contratual
objeto Descrição do objeto da aquisição / contratação
valor Valor do instrumento contratual
data_inicio Data do início da vigência contratual
data_fim Data do fim da vigência contratual
tipo_doc Tipo do instrumento contratual (CONTRATO, ATA DE REGISTRO, etc)
fornecedor Razão social do contratado
aditivo Caso o instrumento tenha sido aditado, as seguintes informações serão disponibilizadas:
Campo Descrição
data_aditivo Data do instrumento de aditamento do instrumento contatual
tipo_aditivo Tipo do aditamento (ALTERAR PRAZO, ADICIONAR VALOR, SUPRIMIR VALOR, etc)
data_prorrogacao Se for aditamento de ALTERAR PRAZO, informa a nova data final da vigência do contrato, senão retorna null
valor_aditivo Se for aditamento de ADICIONAR ou SUPRIMIR VALOR, informa o valor adicionado ou subtraído do valor contratado, senão retorna null
Exemplo em PHP
              <?php
                $url = "https://docxpert.com.br/pmbreubranco/api/contratos/?2023";
                $client = curl_init($url);
                curl_setopt($client,CURLOPT_RETURNTRANSFER,true);
                $response = curl_exec($client);
                $contrato = json_decode($response);
                foreach ($contrato as $dados) {
                    echo "<p>Nº Contrato: $dados->num_doc</p>";
                    echo "<p>Vigência: $dados->data_inicio à $dados->data_fim</p>";
                    echo "<p>Valor Contrato: $dados->valor</p>";
                    echo "<p>Objeto: $dados->objeto</p>";
                }
                curl_close($client);
              ?>
              
Exemplo em Javascript
              <html>
                <head>
                  <title>API de Dados Abertos</title>
                  <script type="text/javascript" language="javascript">
                    function enviar()
                    {
                        var requisicao = new XMLHttpRequest();
                        requisicao.addEventListener("load", listener);
                        requisicao.open("GET", "https://docxpert.com.br/pmbreubranco/api/contratos/?2023");
                        requisicao.send();
                    }
                    function listener() {
                      document.getElementById('div').innerHTML = (this.responseText);
                    }
                  </script>
                </head>
                <body>
                  <button type="submit" onclick="javascript:enviar()">Executar</button>
                  <div id='div'></div>
                </body>
              </html>