Contratos

Versão: 1.1

Apresentamos as principais características do webservice Contratos, componente do sistema de webservices da ALMG, cuja sigla é ws.

Este conjunto de webservices implementa a consulta à lista de pessoas físicas e jurídicas com contratos ou convênios vigentes firmados pela ALMG.

Recursos

Os recursos que podem ser acessados são listados a seguir.

Nome Versão
Lista de Contratos Indexados 1.0
Registro de Contrato 1.0
Pesquisa Direcionada de Contratos 1.1
Lista de Fornecedores Indexados 1.0
Lista de Fornecedores por Letra 1.0
Ajuda 1.0

Quando o XML de resposta do recurso é maior que 20000 (vinte mil) caracteres, ele é truncado para 10000 (dez mil) caracteres para não tornar este documento muito extenso.

Lista de Contratos Indexados

Versão: 1.0

Lista os convênios e contratos ativos firmados pela ALMG, indexados pela primeira letra do fornecedor.

URLhttps://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/indexados
Método GET
Tipos de Consumo N.I.
Tipos de Retorno application/xml
Resultados 200 OK & XML

Parâmetros

Nome Descrição Tipo Valor Default
Sem parâmetros.

Headers

Nome Descrição Tipo Valor Default
Sem headers.

Exemplos

Lista geral em formato XML
GET https://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/indexados

Erro: ClientHandlerException
Lista geral em formato JSON
GET https://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/indexados?formato=json

Erro: ClientHandlerException

Registro de Contrato

Versão: 1.0

Retorna o registro de convênio ou contrato ativo firmado pela ALMG pelo seu identificador.

URLhttps://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/{id}
Método GET
Tipos de Consumo N.I.
Tipos de Retorno application/xml
Resultados 200 OK & XML

Parâmetros

Nome Descrição Tipo Valor Default
{id} Identificador de contrato. Integer N.I.

Headers

Nome Descrição Tipo Valor Default
Sem headers.

Exemplos

Contrato com identificador igual a 21956 em formato XML
GET https://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/21956

Erro: ClientHandlerException
Contrato com identificador igual a 21956 em formato JSON
GET https://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/21956?formato=json

Erro: ClientHandlerException

Pesquisa Direcionada de Contratos

Versão: 1.1

Permite a pesquisa direcionada de contratos por vários parâmetros.

URLhttps://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/pesquisa
Método GET
Tipos de Consumo N.I.
Tipos de Retorno application/xml
Resultados 200 OK & XML

Parâmetros

Nome Descrição Tipo Valor Default
?cod= Código do contrato. Integer N.I.
?ano= Ano do contrato. Integer N.I.
?tipo= Tipo de contrato:
  • 'Contrato'
  • 'Convênio'
String
?forn= Nome do fornecedor. String
?dota= Dotação orçamentária. String
?obj= Objeto do contrato. String
?numLic= Número do processo licitatório. Integer N.I.
?anoLic= Ano do processo licitatório. Integer N.I.
?modal= Modalidade do contrato. String
?numModalCto= Número da modalidade de contrato. Integer N.I.
?anoModalCto= Ano da modalidade de contrato. Integer N.I.

Headers

Nome Descrição Tipo Valor Default
Sem headers.

Exemplos

Pesquisa contratos de 2008 cujo objeto seja 'computadores' em formato XML
GET https://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/pesquisa?ano=2008&obj=computadores

Erro: ClientHandlerException
Pesquisa contratos de 2008 cujo objeto seja 'computadores' em formato JSON
GET https://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/pesquisa?ano=2008&obj=computadores&formato=json

Erro: ClientHandlerException

Lista de Fornecedores Indexados

Versão: 1.0

Lista os fornecedores de convênios e contratos ativos firmados pela ALMG, indexados pela primeira letra do fornecedor.

URLhttps://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/fornecedores/indexados
Método GET
Tipos de Consumo N.I.
Tipos de Retorno application/xml
Resultados 200 OK & XML

Parâmetros

Nome Descrição Tipo Valor Default
Sem parâmetros.

Headers

Nome Descrição Tipo Valor Default
Sem headers.

Exemplos

Lista geral em formato XML
GET https://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/fornecedores/indexados

Erro: ClientHandlerException
Lista geral em formato JSON
GET https://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/fornecedores/indexados?formato=json

Erro: ClientHandlerException

Lista de Fornecedores por Letra

Versão: 1.0

Retorna a lista de fornecedores pela inicial do nome do fornecedor.

URLhttps://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/fornecedores/{letra}
Método GET
Tipos de Consumo N.I.
Tipos de Retorno application/xml
Resultados 200 OK & XML

Parâmetros

Nome Descrição Tipo Valor Default
{letra} Letra para indexar fornecedores. String N.I.

Headers

Nome Descrição Tipo Valor Default
Sem headers.

Exemplos

Fornecedores cujos nomes começam com a letra 'A' em formato XML
GET https://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/fornecedores/A

Erro: ClientHandlerException
Fornecedores cujos nomes começam com a letra 'A' em formato JSON
GET https://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/fornecedores/A?formato=json

Erro: ClientHandlerException

Ajuda

Versão: 1.0

Retorna ajuda.

URLhttps://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/ajuda
Método GET
Tipos de Consumo N.I.
Tipos de Retorno text/html
Resultados 200 OK & HTML

Parâmetros

Nome Descrição Tipo Valor Default
Sem parâmetros.

Headers

Nome Descrição Tipo Valor Default
Sem headers.

Exemplos

Sem exemplos.