====== WEB-Service para Consulta de Execução Orçamentária ======
===== Informações Gerais =====
==== Serviço ====
| Nome: | Web Service para consulta de execução orçamentária |
| Nome na interface: | WSExecucaoOrcamentaria|
| Início da operação: | 31/05/2017 (atualizar) |
| Endereço do WSDL - Testes | https://testews.siop.gov.br/services/WSExecucaoOrcamentaria?wsdl |
| Endereço do WSDL - Produção | https://webservice.siop.gov.br/services/WSExecucaoOrcamentaria?wsdl |
==== Objetivo ====
Fornecer uma interface que possibilite a consulta de execução orçamentária.
===== Operações =====
Este serviço disponibiliza apenas uma operação para consultar a execução orçamentária, especificamente, para a [[ http://www.planejamento.gov.br/acesso-a-informacao/institucional/unidades/secretaria-de-desenvolvimento-da-infraestrutura | Secretaria de Desenvolvimento da Infraestrutura (SDI) ]], antiga Secretaria do Programa de Aceleração do Crescimento - SEPAC
==== 2.1 Consultar Execução PAC====
Operação para consulta de execução orçamentária específica para o [[http://www.pac.gov.br/|PAC (Programa de Aceleração do Crescimento)]], ou seja, os dados são filtrados para identificador de Resultado Primário (RP 3)
**Nome da operação na interface do serviço:**
consultarExecucaoPac
**Parâmetro(s) de entrada:**
|Parâmetro|Tipo (tamanho)|Observações|
|credencial|CredencialDTO|Credencial do usuário|
|filtro|FiltroExecucaoOrcamentariaPacDTO|Filtro de consulta que permite a passagem do exercício para busca da execução orçamentária|
**Tipo de Retorno:**
RetornoExecucaoPacDTO
**Exemplo:**
Requisição:
?
32
[hash md5 da senha]
[login credencial]
2017
Resposta:
F4D71977355F05786B40209700EB8501
true
122I
2017
0.00
0.00
0.00
0.00
0.00
Orçamento Fiscal
Transporte
No Estado do Espírito Santo
Presidência da República
Transporte Hidroviário
Secretaria de Portos
0.00
0.00
0.00
0.00
0.00
0.00
0.00
10
26
0032
20000
0.00
Porto de Vitoria - Drag.Aprof.Canal de Acesso
SEP00012
2074
0.00
1195501.93
0.00
3534913.46
0.00
2339411.53
3
3
784
Dragagem e Adequação da Navegabilidade no Porto de Vitória (ES)
Transporte Marítimo
20128
===== Estruturas de Entrada/Saída e Retorno =====
As informações que trafegam pelo serviço são organizadas em estruturas de dados que atuam como entrada (parâmetros) e retorno das operações. Enquanto os dados são manipulados pelos sistemas, seja nos clientes ou no servidor, essas informações ficam alocadas em entidades que, no contexto de web services, podem ser chamadas de Objetos de Transferência de Dados, ou DTOs (sigla de Data Transfer Objects). Um DTO é uma classe de objetos que descreve os atributos (e as operações de atribuição e consulta de seus valores) de determinado conceito envolvido no domínio de um problema. No momento da comunicação, seja na requisição ou na resposta, os DTOs são transformados em estruturas XML formatadas de acordo com a especificação contida no documento descritor do web service (WSDL).
As linguagens de programação modernas possuem ferramentas que automatizam o processo de construção dos DTOs a partir do WSDL, bem como bibliotecas com funcionalidades que tornam transparente para o desenvolvedor o processo de tradução de DTO para XML e vice-versa.
**Entradas**
==== CredencialDTO ====
Esta estrutura é composta pelas informações necessárias para que a aplicação cliente se identifique junto ao serviço. A credencial a ser utilizada nos web services do SIOP é específica para esse fim e não é válida para acessar a aplicação web.
|Atributo|Tipo(tamanho)|Aceita Nulo?|Observações|
|usuario|Texto|Não|Login do usuário no SIOP|
|senha|Texto|Não|Hash MD5 da senha do usuário no SIOP|
|perfil|Inteiro|Sim (apenas para operações de consultas de tabelas de apoio).|Perfil com o qual o usuário deseja realizar determinada operação. Não é obrigatório na operação obterTabelasApoioQuantitativo.|
====FiltroExecucaoOrcamentariaPacDTO====
|Atributo|Tipo(tamanho)|Observações|
|exercicio|int| obrigatório |
**Retorno**
==== RetornoExecucaoPacDTO====
|Atributo|Tipo(tamanho)|Observações|
|execucoesOrcamentarias|List|Contém a lista de execuções orçamentárias|
====ExecucaoOrcamentariaPacDTO====
|Atributo|Tipo(tamanho)|Observações|
|anoExercicio|int| |
|esfera|string| |
|descricaoesfera|string| |
|orgao|string| |
|descricaoorgao|string| |
|uo|string| |
|descricaouo|string| |
|funcao|string| |
|descricaofuncao|string| |
|subfuncao|string| |
|descricaosubfuncao|string| |
|programa|string| |
|tituloprograma|string| |
|acao|string| |
|tituloacao|string| |
|localizador|string| |
|descricaolocalizador|string| |
|plano_interno|string| |
|pidescricao|string| |
|projetolei|numeric(16,2)| |
|dotacaoinicial|numeric(16,2)| |
|dotacaoatual|numeric(16,2)| |
|antecipado|numeric(16,2)| |
|autorizado|numeric(16,2)| |
|empenhado|numeric(16,2)| |
|empenholiquidado|numeric(16,2)| |
|empenhoaliquidar|numeric(16,2)| |
|disponivel|numeric(16,2)| |
|bloqueado_remanejamento_de_credito|numeric(16,2)| |
|bloqueado_rp3|numeric(16,2)| |
|bloqueado_rp2|numeric(16,2)| |
|pago|numeric(16,2)| |
|rapexerciciosanteriores|numeric(16,2)| |
|rapinscrito|numeric(16,2)| |
|rapcancelados|numeric(16,2)| |
|rapapagar|numeric(16,2)| |
|rappago|numeric(16,2)| |
|emp_liq_inscr_rap_np|numeric(16,2)| |
|rp_lei|string| |
|rp_atual|string| |
==== RetornoDTO ====
|Atributo|Tipo(tamanho)|Observações|
|sucesso|boolean|Indica se a requisição foi processada com sucesso.|
|mensagensErro|List|Contém a lista de mensagens de erro nos casos em que sucesso retornar valor igual false.|