====== Web Service Quantitativo do SIOP (WSQuantitativo) ======
===== Informações Gerais =====
==== Serviço ====
| Nome: | Web Service Quantitativo do SIOP |
| Nome na interface: | WSQuantitativo |
| Início da operação: | 29/02/2012 |
| Endereço do WSDL - Testes | https://testews.siop.gov.br/services/WSQuantitativo?wsdl |
| Endereço do WSDL - Produção | https://webservice.siop.gov.br/services/WSQuantitativo?wsdl |
==== Objetivo ====
Fornecer uma interface que possibilite a interoperabilidade entre os IntraSigs e o SIOP para a transmissão de dados referentes à proposta quantitativa das Unidades Orçamentárias e Órgãos Setoriais.
Inclui operações para consulta e cadastro. Inclui também operações para tratar [[acompanhamento_orcamentario:acompanhamento_orcamentario|Acompanhamento Orçamentário]] e Execução Financeira do SIAFI.
===== Operações =====
==== Cadastrar Acompanhamento Orçamentário ====
Operação para cadastro e alteração do acompanhamento orçamentário (execução física) de uma ação e seus localizadores.
**Nome da operação na interface do serviço:** cadastrarAcompanhamentoOrcamentario
**Parâmetro(s) de entrada:**
|Parâmetro|Tipo(tamanho)|Observações|
|credencial|CredencialDTO| |
|acompanhamentoAcao|AcompanhamentoOrcamentarioAcaoDTO| |
**Tipo de Retorno:** RetornoAcompanhamentoOrcamentarioDTO
**Exemplo:** Requisição:
[PERFIL]
[HASH MD5 DA SENHA]
[LOGIN]
2
2013
2000
10
32263
22
663
2041
20TZ
1
0001
1
0
0
2013-12-01
118074
0
2013-12-01
Análise Adicional WebService
TEXTO ANÁLISE LOCALIZADOR
1
DF
5300108
5
0
0
Comentário Regionalização da Execução
522
Objetiva
2884
Especificação Resposta
524
Objetiva de múltipla escolha
2891
Especificação outros.
528
Objetiva de resposta múltipla com ordenação
2912
Outros - descrever.
Especificação outros ordenação.
1
533
Objetiva de resposta múltipla
2946
2934
0002
0
2013-12-31
10
5
TEXTO DA ANALISE DO PO
533
2946
2934
Resposta:
true
ALERTA 1: Localizador: 0001 - Nacional - Há execução financeira (LOA), mas a captação física é zero.
ALERTA 2: Localizador: 0001 - Nacional - Reprogramado menor que o empenhado.
ALERTA 3: Localizador: 0001 - Nacional - O valor do realizado físico de JAN-DEZ está menor do que o de JAN-JUN.
\\
==== Cadastrar Proposta ====
Operação para cadastro e alteração de uma proposta orçamentária. No contexto deste serviço, entende-se como proposta a programação orçamentária para um determinado localizador e tipo de detalhamento, e não a proposta completa para uma UO ou OS.
O parâmetro proposta, do tipo PropostaDTO, deve ter preenchido os campos que indicam o exercício, momento, tipo de detalhamento e os que identificam a funcional-programática do localizador, além da lista de FinanceiroDTO que forma o detalhamento financeiro da programação. A partir do PLOA de 2014 é possível informar as necessidades de expansão das metas físicas (em PropostaDTO e MetaPlanoOrcamentarioDTO) e das dotações (em FinanceiroDTO).
A lista de ReceitaDTO é utilizada somente nas propostas de ações da esfera de investimentos.
Com a inclusão do plano orçamentário (PO) à LOA de 2013, as propostas de ações que possuam PO precisam ter obrigatoriamente cada um de seus elementos de FinanceiroDTO associados a um dos PO da ação.
A lista de MetaPlanoOrcamentarioDTO (atributo metaPlanoOrcamentario) deve ser preenchida com as metas físicas e solicitações de expansão de cada PO que possua produto e tenha sido detalhado na proposta.
**Nome da operação na interface do serviço:**
cadastrarProposta
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
| proposta | PropostaDTO | |
**Tipo de Retorno:**
RetornoPropostasDTO
==== Consultar Acompanhamento Físico e Financeiro ====
Esta operação tem como objetivo fornecer informações de execução física e financeira com base no exercício, período de captação física, código do momento da captação física e tipo de captação informados, que pode ser apresentada por localizador, plano orçamentário ou ambos. Os resultados são retornados em uma estrutura do tipo RetornoAcompanhamentoFisicoFinanceiroDTO, que contém uma lista de registros do tipo AcompanhamentoFisicoFinanceiroDTO, um objeto do tipo PaginacaoDTO e um campo de data chamado “dataHoraUltimaCargaSiafi”, que armazena a última atualização dos registros financeiros retornados na consulta.
Por questões de desempenho, a operação tem como um de seus parâmetros uma estrutura do tipo PaginacaoDTO, que é utilizada para que o cliente informe o número da página desejada através do atributo pagina. Quando não informado, o serviço assume o valor 0 (zero), corresponde à primeira página. No retorno desta operação são informados o número da página e o número máximo de registros por página – atributos pagina e registrosPorPagina de PaginacaoDTO. Para obter o resultado completo da consulta o cliente deve realizar sucessivas requisições, incrementando o atributo pagina até que a operação retorne uma quantidade de registros inferior a registrosPorPagina.
**Nome da operação na interface do serviço:**
consultarAcompanhamentoFisicoFinanceiro
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | Informações de acesso ao sistema (login, senha e perfil). |
| exercicio | Integer | Exercício da captação física |
| período | Integer (1) | 1 para o primeiro período da captação física, 2 para o segundo. |
| momentoId | Integer (4) | Momento da captação física |
| tipoCaptacao | char (1) | 'L' para captação por localizadores, 'P' para captação por planos orçamentários |
| paginacao | PaginacaoDTO | Caso necessário, informe o número da página para obter as páginas subsequentes da consulta. |
**Tipo de Retorno:**
RetornoAcompanhamentoFisicoFinanceiroDTO
==== Consultar Acompanhamento Orçamentário ====
Operação para obtenção do acompanhamento orçamentário das ações, e todos os seus respectivos localizadores, das unidades orçamentárias vinculadas à credencial e que se enquadrem no filtro (funcional-programática) informado.
Observações:
* Esta operação ignora os atributos codigoLocalizador e codigoTipoInclusaoLocalizador do filtro e retorna sempre o acompanhamento de todos os localizadores de cada ação encontrada.
* O atributo codigoTipoInclusaoAcao (origem da ação) do filtro faz parte da chave da ação. Para garantir que a operação retorne o acompanhamento de uma única ação é necessário informar a funcional completa da ação (esfera, unidade orçamentária, função, sub-função, programa, ação) e a sua origem (codigoTipoInclusaoAcao).
**Nome da operação na interface do serviço:** consultarAcompanhamentoOrcamentario
**Parâmetro(s) de entrada:**
|Parâmetro|Tipo(tamanho)|Observações|
|credencial|CredencialDTO|Obrigatório.|
|exercicio|Integer|Exercício da captação física. Obrigatório.|
|periodoOrdem|Integer (1)|1 para o primeiro período da captação física, 2 para o segundo. Obrigatório.|
|codigoMomento|Integer (4)|Momento da captação física (1000, 2000 ou 4500). Campo opcional|
|filtro|FiltroFuncionalProgramaticaDTO|Preenchimento obrigatório.|
|dataHoraReferencia|Data/Hora|Filtra o retorno para captações que foram alteradas após dataHoraReferencia. Campo opcional.|
**Tipo de Retorno:** RetornoAcompanhamentoOrcamentarioDTO
**Exemplo:** Requisição:
32
**
**
2017
1
4500
2011
20
12
?
2109
331
?
?
26401
Resposta:
**
true
2017
4500
20
26401
12
331
2109
2011
1
false
2017-07-21T15:11:09.840-03:00
0054
1
0
0
0
2017-06-30T00:00:00-03:00
1200
1200
1200
0.0
0.0
0.0
0
2017-06-30T00:00:00-03:00
0.0
0.0
0.0
0.0
Análise adicional
0001
0
2017-06-30T00:00:00-03:00
Pessoa beneficiada
unidade
Auxílio-Transporte - Civis
1200.0
0.0
0.0
0.0
1
10
5
\\
==== Consultar Emendas do Localizador ====
**Nome da operação na interface do serviço:**
obterEmendasLocalizador
**Parâmetro(s) de entrada:**
| Parâmetro | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
| localizador | LocalizadorDTO | Necessário preenchimento apenas dos atributos exercicio e identificadorUnico. |
**Tipo de Retorno:**
RetornoFinanceiroEmendasDTO
**Exemplo:**
Requisição:
33
***
WSSICONV
2013
963378
Resposta:
true
100
9999
0
7733
33300000
2
2
10000
7
1
7
2013
10000
0
100
9999
0
7733
44300000
2
2
3990000
7
1
7
2013
3990000
0
==== Consultar Execução Orçamentária ====
Esta operação tem como objetivo fornecer informações de execução financeira com base em filtros de consulta e na seleção dos elementos da programação orçamentária desejados como retorno. Tanto os filtros como as seleções de retorno contemplam todos os elementos da classificação qualitativa (institucional-funcional-programática, inclusive com plano orçamentário), quantitativa e marcadores orçamentários. O filtro de consulta permite que para cada elemento de classificação e marcador orçamentário seja informada uma lista de valores desejados.
O agrupamento dos atributos selecionados segue a seguinte ordem: anoReferencia, anoExercicio, unidadeGestoraUO, unidadeGestoraResponsavel, planoInterno, esfera, orgao, unidadeOrcamentaria, funcao, subFuncao, programa, acao, localizador, planoOrcamentario, natureza, categoriaEconomica, grupoNaturezaDespesa, modalidadeAplicacao, elementoDespesa, subElementoDespesa, idoc, iduso, fonte, resultadoPrimarioLei, resultadoPrimarioAtual, tipoCredito, origem, snObraIrregular, snLeiCalmon, snErradicacaoAnalfabetismo, programacaoSelecionada, snExcecaoDecreto, snAcaoEssencial, tipoApropriacaoPO, tematicaPO, acompanhamentoPO, identificadorAcompanhamentoPO, detalheAcompanhamentoPO.
Por questões de desempenho, foi implementado um mecanismo de paginação dos resultados. A operação tem como um de seus parâmetros uma estrutura do tipo PaginacaoDTO, que é utilizada para que o cliente informe o número da página desejada através do atributo pagina. Quando não informado, o serviço assume o valor 0 (zero), corresponde à primeira página. No retorno desta operação são informados o número da página e o número máximo de registros por página – atributos pagina e registrosPorPagina de PaginacaoDTO. Para obter o resultado completo da consulta o cliente deve realizar sucessivas requisições, incrementando o atributo pagina até que a operação retorne uma quantidade de registros inferior a registrosPorPagina.
**Nome da operação na interface do serviço:**
consultarExecucaoOrcamentaria
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | Informações de acesso ao sistema (login, senha e perfil). |
| filtro | FiltroExecucaoOrcamentariaDTO | Filtros de consulta, permite a passagem de uma lista de valores para cada elemento da classificação. |
| selecaoRetorno | SelecaoRetornoExecucaoOrcamentariaDTO | Contém um valor booleano opcional para cada elemento da classificação que deva ser retornado pela operação. |
| paginacao | PaginacaoDTO | Caso necessário, informe o número da página para obter as páginas subsequentes da consulta. |
**Tipo de Retorno:**
RetornoExecucaoOrcamentariaDTO
**Exemplo**
Requisição:
32
WSMEC
20RG
20GK
2017
2017
EIND
t
true
t
t
t
t
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
2
Resposta:
A9C7584FDB4C4620448ECEF1376B5573
true
20RG
0
2017
2017
4
00
00
10
188
12
4
9999
0
00
0029
99
44990000
28790005
emend
EIND
2080
0.00
6
6
00
363
0
0
A
26101
20RG
0
2017
2017
4
00
00
10
188
12
4
9999
0
00
0029
99
44990000
28790005
129722
siafi
EIND
2080
0.00
6
6
00
363
0
0
A
26101
1
2
==== Consultar Execução Orçamentária Mensal ====
Esta operação possui o mesmo comportamento da operação Consultar Execução Orçamentária, mas devolve o total da execução dentro do mês passado como argumento.
**Nome da operação na interface do serviço:**
consultarExecucaoOrcamentariaMensal
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | Informações de acesso ao sistema (login, senha e perfil). |
| filtro | FiltroExecucaoOrcamentariaDTO | Filtros de consulta, permite a passagem de uma lista de valores para cada elemento da classificação. |
| selecaoRetorno | SelecaoRetornoExecucaoOrcamentariaDTO | Contém um valor booleano opcional para cada elemento da classificação que deva ser retornado pela operação. |
| mês | Integer | Um número inteiro representando o mês a ser consultado. |
| paginacao | PaginacaoDTO | Caso necessário, informe o número da página obter as páginas subsequentes da consulta. |
**Tipo de Retorno:**
RetornoExecucaoOrcamentariaDTO
==== Consultar Execução Orçamentária Mensal com Estatais ====
Operação para obtenção da Execução Orçamentária por mês de um determinado exercício, levando em consideração as esferas 10, 20 e 30, sendo o resultado dos valores de um determinado mês obtidos pelo somatório dos meses anteriores, iniciando em janeiro.
Esta operação implementa o mesmo mecanismo de paginação descrito na operação “Consultar Execução Orçamentária”.
**Nome da operação na interface do serviço:**
consultarExecucaoOrcamentariaEstataisMensal
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
| parametros | ParametrosWebExecucaoOrcamentariaDTO | O exercício é obrigatório. |
| paginacao | PaginacaoDTO | Caso necessário, informe o número da página para obter as páginas subsequentes da consulta. |
**Tipo de Retorno:**
RetornoExecucaoOrcamentariaMensalDestDTO
==== Consultar Proposta ====
Operação para consulta de uma proposta orçamentária. Nesta operação, o atributo proposta, do tipo PropostaDTO, deve ter preenchido apenas os campos que indicam o exercício, momento e tipo de detalhamento, e os que identificam o localizador da proposta.
**Nome da operação na interface do serviço:**
consultarProposta
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
| proposta | PropostaDTO | Nesta operação não é necessário informar as listas de FinanceiroDTO, ReceitaDTO e MetaPlanoOrcamentarioDTO. |
**Tipo de Retorno:**
RetornoPropostasDTO
==== Excluir Proposta ====
Operação para exclusão de uma proposta orçamentária. Nesta operação, o atributo proposta, do tipo PropostaDTO, deve ter preenchido apenas os campos que indicam o exercício, momento e tipo de detalhamento, e os que identificam o localizador da proposta.
**Nome da operação na interface do serviço:**
excluirProposta
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
| proposta | PropostaDTO | Nesta operação não é necessário informar as listas de FinanceiroDTO, ReceitaDTO e MetaPlanoOrcamentarioDTO. |
**Tipo de Retorno:**
RetornoPropostasDTO
==== Obter Ações Disponíveis para Acompanhamento Orçamentário ====
**Nome da operação na interface do serviço:**
obterAcoesDisponiveisAcompanhamentoOrcamentario
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
| exercicio | Inteiro | |
| periodo | Inteiro | 1 – Jan-Jun, 2 – Jan-Dez |
| snAcompanhamentoOpcionalAcao | Boolean | Preenchimento Opcional. Aceita os valores "true", "false" e nulo. Caso for nulo, retorna todos os valores |
| snAcompanhamentoOpcionalLocalizador | Boolean | Preenchimento Opcional. Aceita os valores "true", "false" e nulo. Caso for nulo, retorna todos os valores |
**Tipo de Retorno:**
RetornoAcoesDTO (ver documentação do WSQualitativo) - note que somente retornam as ações de captação obrigatória.
**Exemplo:**
Requisição:
[PERFIL]
[SENHA]
[LOGIN]
2013
2
false
Resposta:
EECE011BBEABCB576369D19EA2B7F55C
true
4172
2109
12
126
26101
10
false
0001
false
20GK
2032
12
364
26101
10
false
0001
false
0022
false
==== Obter Datas Carga SIAFI ====
Esta operação fornece a data da última carga SIAFI das execuções financeiras diárias, o último mês fechado do SIAFI e a data de fechamento do último mês.
**Nome da operação na interface do serviço:**
obterDatasCargaSIAFI
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
**Tipo de Retorno:**
RetornoInformacaoCargaSiafiDTO
**Exemplo:**
Requisição:
[PERFIL]
[SENHA]
[LOGIN]
Retorno:
6DAA65E8E8549529EB1D4C0347F93CF9
true
diaria
2014-05-05T00:00:00-03:00
2014-05-06T02:33:54.941-03:00
mensal
2014-03-08T00:00:00-03:00
2014-04-09T09:07:19.847-03:00
2014-03
2014-04-08T00:00:00-03:00
==== Obter informação da captação das propostas do PLOA ====
Esta operação tem como objetivo fornecer informações sobre o estado das captações das propostas no nível de localizador de gasto. É possível, por exemplo, obter todos os localizadores que já possuem captação, os que estão disponíveis para serem captados e, nos casos de localizadores indisponíveis, saber os motivos pelos quais não é possível realizar a captação.
**Nome da operação na interface do serviço:**
obterInformacaoCaptacaoPLOA
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
| parametro | ParametroInformacaoCaptacaoPLOA | |
**Tipo de Retorno:**
RetornoInformacaoCaptacaoPLOADTO
==== Obter Perguntas do Acompanhamento Orçamentário ====
**Nome da operação na interface do serviço:**
obterPerguntasAcompanhamentoOrcamentario
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
| exercicio | Inteiro | |
| periodo | Inteiro | 1 – Jan-Jun, 2 – Jan-Dez |
**Tipo de Retorno:**
RetornoPerguntasAcompanhamentoOrcamentarioDTO
**Exemplo:**
Requisição:
32
**
**
2020
2
Resposta:
**
true
522
Alteração em normativos(leis, regimentos, decretos etc.) impactou o alcance da meta física?
Objetiva
2883
Sim
2884
Não
524
Em relação ao planejamento para o período, aponte qual fator a seguir mais impactou o alcance da meta física.
Objetiva de múltipla escolha
2887
Planos estratégicos, planejamento setorial ou definição de prioridades.
2888
Medidas de gestão de riscos e garantia de continuidade e dos serviços essenciais.
2889
Medidas de racionalização ou redução de gastos e de custos.
2890
Análise e elaboração de projetos.
2891
Outros - descrever.
528
Quais fatores contratuais mais influenciaram o alcance da meta no período?
Objetiva de resposta múltipla com ordenação
2905
Licitação deserta ou fracassada, empresa irregular, liberação de atas de registros de preços, decisão judicial etc.
2906
Ausência ou reprovação de propostas de convênios.
2907
Documentação: liberação de licença ambiental, alvarás, registros etc.
2908
Imóvel: liberação do terreno, aquisição, desapropriação etc.
2909
Agilização do processo de aquisição, antecipação de demandas ou dos procedimentos para novos editais.
2910
Alterações no cronograma ou nos custos, aditivo contratual, reajuste nos valores, variação cambial.
2911
Situação da contratação: em andamento, suspensa, cancelada, em revisão, acordo judicial, contrato emergencial.
2912
Outros - descrever.
533
Quanto à definição e mensuração da meta física, quais dos pontos a seguir foram mais comumente verificados no período?
Objetiva de resposta múltipla
2933
Erro na projeção ou na reprogramação da meta física; meta superestimada ou subestimada.
2934
Ausência de relação direta entre a execução física e a financeira.
2935
Meta varia em função do número de usuários ou beneficiários, da remuneração do servidor, das aposentadorias, exonerações e outros.
2936
A meta é não cumulativa, portanto foi definida em função da média do período.
2937
Erro no preenchimento ou na apuração da meta física.
2938
Apuração da meta contabilizou a execução com recursos de RAP.
2939
Apuração da meta contabilizou a execução financeira em outra funcional-programática, devido a alteração na programação.
2940
Apuração da meta contabilizou os resultados obtidos por meio de ações em parceria com atores externos.
2941
Apuração da meta contabilizou os resultados realizados às expensas do servidor ou atividades executadas por servidores do quadro, sem custo adicional.
2942
Projeto recente, sem tempo hábil para a primeira medição.
2943
Projeto plurianual, com desembolso vinculado à execução das etapas previstas no cronograma físico-financeiro.
2944
Meta contabilizada na efetivação do contrato de repasse, mesmo não havendo liquidação, ou obtida em relação ao valor pago, quando deveria ser o liquidado.
2945
O realizado físico do RAP foi calculado considerando-se a proporcionalidade em relação à execução financeira.
2946
O reprogramado físico do PO da regra de ouro (ROxx) foi calculado considerando-se a proporcionalidade em relação ao financeiro.
2947
Outros - descrever.
==== Obter Programação Completa ====
Operação para consulta de todas as propostas das Unidades Orçamentárias vinculadas à credencial informada.
**Nome da operação na interface do serviço:**
obterProgramacaoCompletaQuantitativo
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
| exercicio | Inteiro(4) | |
| codigoMomento | Inteiro(4) | Parâmetro usado com a finalidade de filtrar a consulta para o momento desejado. |
| dataHoraReferencia | Data/Hora | A operação só retornará propostas criadas ou alteradas a partir da data e hora de referência, caso informada. |
| paginacao | PaginacaoDTO | Caso necessário, informe o número da página para obter as páginas subsequentes da consulta. |
**Tipo de Retorno:**
RetornoPropostasDTO
==== Obter Tabelas de Apoio ====
Operação para obtenção das tabelas de apoio do módulo quantitativo do SIOP. Podem ser consultadas as tabelas de natureza de despesa, idOC, idUso, fonte e tipo de resultado primário.
**Nome da operação na interface do serviço:**
obterTabelasApoioQuantitativo
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial | CredencialDTO | |
| exercicio | Inteiro(4) | |
| retornarNaturezas | Boolean | Indica se a operação deve retornar a tabela de naturezas de despesa. |
| retornarIdOcs | Boolean | Indica se a operação deve retornar a tabela de indicadores de operação de crédito. |
| retornarIdUsos | Boolean | Indica se a operação deve retornar a tabela de indicadores de uso. |
| retornarFontes | Boolean | Indica se a operação deve retornar a tabela de fontes. |
| retornarRPs | Boolean | Indica se a operação deve retornar a tabela de tipos de resultado primário. |
| dataHoraReferencia | Data/Hora | A operação só retornará registros criados ou alterados a partir da data e hora de referência, caso informada. |
**Tipo de Retorno:**
RetornoApoioQuantitativoDTO
==== Consultar naturezas de despesa disponíveis para cadastro proposta ====
Operação para obtenção das naturezas de despesa que podem ser utilizadas no cadastro de uma proposta do módulo quantitativo do SIOP.
**Nome da operação na interface do serviço:**
Listar naturezas de despesa disponíveis para cadastro proposta
**Parâmetro(s) de entrada:**
| Atributo | Tipo(tamanho) | Observações |
| credencial| CredencialDTO|
| filtro| FiltroNaturezaDespesaDTO|
**Tipo de Retorno:**
RetornoNaturezasDTO
===== 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/Saídas**
==== AcompanhamentoFisicoFinanceiroDTO ====
|Atributo|Tipo(tamanho)|Observações|
|__tipoCaptacao__|Character (35)|Descrição do tipo de captação dos registros, por localizador ou plano orçamentário|
|__exercicio__|Integer (4)|Exercício da captação física.|
|__periodo__|Varchar (80)|Descrição do período da captação física|
|__momentoId__|Integer|Código do momento|
|__momento__|Varchar (150)|Descrição do momento|
|__esfera__|Character (2)|Código da esfera orçamentária.|
|__orgao__|Character (5)|Código do órgão orçamentário.|
|__descricaoOrgao__|Varchar (110)|Descrição do órgão orçamentário.|
|__uo__|Character (5)|Código da unidade orçamentária.|
|__descricaoUo__|Varchar (110)|Descrição da unidade orçamentária.|
|__orgaoSiorg__|Varchar (6)|Código do Orgão Siorg|
|__descricaoSiorg__|Varchar (110)|Descrição do Órgão Siorg|
|__funcao__|Character (2)|Código da função.|
|__descricaoFuncao__|Varchar (120)|Descrição da função.|
|__subfuncao__|Character (3)|Código da Subfunção.|
|__descricaoSubFuncao__|Varchar (120)|Descrição da Subfunção.|
|__programa__|Character (4)|Código do programa.|
|__tituloPrograma__|Varchar (255)|Título do programa.|
|__acao__|Character (4)|Código da ação.|
|__tituloAcao__|Varchar (255)|Título da ação.|
|__produto__|Integer (4)|Código do produto. Referencia ao atributo codigoProduto em produtoDTO.|
|__unidadeMedida__|Character (10)|Unidade de medida do produto da ação|
|__descricaoUnidadeMedida__|Varchar (80)|Descrição da unidade de medida do produto da ação|
|__localizador__|Character (4)|Código do localizador.|
|__descricaoLocalizador__|Varchar (255)|Descrição do localizador.|
|__quantidadeMetaLOA__|Numeric (16,2)|Quantidade física da proposta quantitativa no momento LOA (8000)|
|__dotacaoInicial__|Numeric (16,2)|Valor financeiro da proposta orçamentária no momento LOA (8000).|
|__dotacaoAtual__|Numeric (16,2)|Valor financeiro da proposta orçamentária corrente.|
|__liquidado__|Numeric (16,2)|Valor liquidado oriundo do SIAFI .|
|__reprogramadoFisico__|Numeric (16,2)|Quantidade física reprogramada|
|__reprogramadoFinanceiro__|Numeric (16,2)|Valor financeiro reprogramado|
|__realizadoLOA__|Numeric (16,2)|Quantidade realizada em relação a meta LOA|
|__pago__|Numeric (16,2)|Valor pago oriundo do SIAFI.|
|__liquidadoRAP__|Numeric (16,2)|Valor liquidado por inscrição de RAP.|
|__realizadoRAP__|Numeric (16,2)|Valor realizado de RAP.|
|__codigoPO__|Character (4)|Código do plano orçamentário.|
|__tituloPO__|Varchar (255)|Título do plano orçamentário.|
|__produtoPO__|Integer (4)|Código do produto do plano orçamentário. Referencia ao atributo codigoProduto em produtoDTO.|
|__unidadeMedidaPO__|Character (10)|Unidade de medida do produto do plano orçamentário|
|__descricaoUnidadeMedidaPO__|Varchar (80)|Descrição da unidade de medida do produto do plano orçamentário|
|__quantidadeMetaLOAPO__|Numeric (16,2)|Meta física inicial do plano orçamentário|
|__quantidadeMetaAtualPO__|Numeric (16,2)|Meta física do plano orçamentário atualizada|
|__dotacaoInicialPO__|Numeric (16,2)|Dotação inicial do plano orçamentário|
|__dotacaoAtualPO__|Numeric (16,2)|Dotação atual do plano orçamentário|
|__liquidadoPO__|Numeric (16,2)|Valor liquidado do plano orçamentário|
|__realizadoPO__|Numeric (16,2)|Valor realizado em relação a meta LOA do plano orçamentário|
|__pagoPO__|Numeric (16,2)|Valor pago do plano orçamentário|
|__liquidadoRAPPO__|Numeric (16,2)|Valor liquidado por inscrição de RAP do plano orçamentário|
|__descricaoProduto__|Varchar (80)|Descrição do produto|
|__descricaoProdutoPO__|Varchar (80)|Descrição do produto intermediário (produto do plano orçamentário)|
==== AcompanhamentoOrcamentarioAcaoDTO ====
|Atributo|Tipo(tamanho)|Observações|
|__periodoOrdem__|Inteiro(1)| |
|__exercicio__|Inteiro(4)|Exercício da captação física.|
|__codigoMomento__|Inteiro(4)| |
|__esfera__|Texto(2)|Código da esfera orçamentária.|
|__unidadeOrcamentaria__|Texto(5)|Código do órgão orçamentário.|
|__funcao__|Texto(2)|Código da função.|
|__subFuncao__|Texto(3)|Código da Subfunção.|
|__programa__|Texto(4)|Código do programa.|
|__acao__|Texto(4)|Código da ação.|
|__codigoTipoInclusaoAcao__|Inteiro(1)|Valores válidos: 1 - PLOA, 2 - Emenda, 4 - PPA, 5 - Crédito Especial, 6 - Crédito Extraordinário.|
|acompanhamentosLocalizadores|Lista de AcompanhamentoOrcamentarioLocalizadorDTO| |
|snPendencia|Boolean|Indica a ocorrência de pendências na captação. Este é um atributo de saída, não deve ser preenchido no cadastro de acompanhamento.|
|dataHoraAlteracao|Data|Este é um atributo de saída, não deve ser preenchido no cadastro de acompanhamento.|
==== AcompanhamentoOrcamentarioLocalizadorDTO ====
Esta estrutura encapsula os dados de acompanhamento orçamentário de um localizador e é sempre utilizada como componente de AcompanhamentoOrcamentarioAcaoDTO no atributo acompanhamentosLocalizadores.
A chave única deste localizador é composta pelos atributos localizador e codigoTipoInclusaoLocalizador em conjunto com a chave única do AcompanhamentoOrcamentarioAcaoDTO do qual está relacionado.
|Atributo|Tipo(tamanho)|Observações|
|__localizador__ |Texto(4)|Código do localizador.|
|__codigoTipoInclusaoLocalizador__ |Inteiro(1)|Valores válidos: 1 - PLOA, 2 - Emenda, 4 - PPA, 5 - Crédito Especial, 6 - Crédito Extraordinário|
|reprogramado|Long|Execução física Reprogramada para o exercício.|
|realizadoLOA|Long|Execução física realizada.|
|realizadoRAP|Long|Execução física realizada para Restos a Pagar Não Processados.|
|limite|Double|Reprogramado Financeiro(limite de empenho)|
|justificativa|Texto(2000)|A partir de 2020, esse campo corresponde à Análise Adicional do localizador.|
|dataApuracaoLOA|Data|Data de apuração da execução física.|
|dataApuracaoRAP|Data|Data de apuração da execução física para Restos a Pagar Não Processados.|
|meta|Long|Meta física do localizador. Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|dotacaoAtual|Long|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|dotacaoInicial|Long|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|empenhado|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|liquidado|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|pago|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|rapInscritoLiquido|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento. Valor de Restos A Pagar Não Processados Inscrito Líquido.|
|rapLiquidadoAPagar|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento. Valor de Restos A Pagar Não Processados Liquidado a Pagar.|
|rapPago|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento. Valor de Restos A Pagar Não Processados Pago.|
|rapLiquidadoEfetivo|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento. Valor de Restos A Pagar Não Processados Liquidado Efetivo.|
|analisesLocalizador|Lista de AnaliseAcompanhamentoOrcamentarioDTO|Contém os comentários analíticos sobre o acompanhamento. Pelo menos uma análise deve ser preenchida.|
|informacoesRegionalizacao|Lista de AcompanhamentoOrcamentarioRegionalizacaoDTO|As informações sobre a regionalização devem ser preenchidos nos localizadores nacionais (região Nacional) das ações marcadas com snRegionalizarNaExecucao.|
|perguntasAcompanhamentoLocalizador|Lista de PerguntaAcompanhamentoOrcamentarioDTO|Contém as respostas às perguntas do questionário que substituiu o campo Análise a partir da captação JAN-DEZ 2020|
|acompanhamentosPlanoOrcamentario|Lista de AcompanhamentoPlanoOrcamentarioDTO|Contém os acompanhamentos dos Planos Orçamentários (PO). Pode ser preenchido quando um dos POs possuir meta fisica estabelecida.|
\\
==== AcompanhamentoPlanoOrcamentarioDTO ====
|Atributo|Tipo(tamanho)|Observações|
|planoOrcamentario|Texto(4)|Código do plano orçamentário.|
|realizadoLOA|Long|Execução física realizada.|
|dataApuracaoLOA|Data|Data de apuração da execução física.|
|reprogramado|Long|Execução física Reprogramada para o exercício.|
|limite|Double|Reprogramado Financeiro(limite de empenho)|
|descricaoProduto|Texto|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|descricaoUnidadeMedida|Texto|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|titulo|Texto|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|dotacaoAtual|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|empenhado|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|liquidado|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|pago|Double|Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|meta|Long|Meta física do PO. Somente retorno. Não deve ser preenchido no cadastro de acompanhamento.|
|analisesPlanoOrcamentario|Lista de AnaliseAcompanhamentoOrcamentarioDTO|Neste campo devem ser colocados, sempre que possível, os fatores que contribuíram para a execução da ação; os fatores que a dificultaram; a metodologia de apuração do realizado no período; os resultados obtidos com os recursos da ação; informações adicionais relevantes, não descritas acima; e a justificativa para a Reprogramação, se houver.|
|perguntasAcompanhamentoPlanoOrcamentario|Lista de PerguntaAcompanhamentoOrcamentarioDTO|Contém as respostas às perguntas do questionário que substituiu o campo Análise a partir da captação JAN-DEZ 2020|
==== AnaliseAcompanhamentoOrcamentarioDTO ====
|Atributo|Tipo(tamanho)|Observações|
|periodoOrdem|Inteiro(1)| |
|analise|Texto(5000)| |
|nomeUsuario|Texto(255)|Usado apenas no retorno de operações de consulta.|
|ultimaModificacao|Data|Usado apenas no retorno de operações de consulta.|
==== AcompanhamentoOrcamentarioRegionalizacaoDTO ====
|Atributo|Tipo(tamanho)|Observações|
|codigoRegiao|int|Código da Região (ver RegiaoDTO - WSQualitativo)|
|uf|Texto(2)|Sigla da UF|
|municipio|Texto(7)|Código IBGE do município com 7 dígitos|
|recorteGeograficoId|int|Código do Recorte Geográfico (ver RecorteGeograficoDTO - WSQualitativo)|
|liquidado|Numeric (16,2)|valor liquidado para esta regionalização da execução|
|realizado|Long|meta realizada para esta regionalização da execução|
|comentario|Texto(5000)| |
|nomeUsuario|Texto(255)|Usado apenas no retorno de operações de consulta.|
|ultimaModificacao|Data|Usado apenas no retorno de operações de consulta.|
\\
==== 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. Todas as operações do WSQuantitativo utilizam CredencialDTO como parâmetro.
|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.|
==== EmendaDTO ====
|Atributo|Tipo(tamanho)|Observações
|exercicio|Integer| |
|codAutor|Integer| |
|decisaoParecerId|Integer| |
|emendaNumero|Integer| |
|emenda|Integer| |
|valorSuplementacao|Long| |
|valorCancelamento|Long| |
==== ExecucaoOrcamentariaDTO ====
|Atributo|Tipo(tamanho)|Descrição|
|anoReferencia|Integer(4)|Ano de referência, diferente do ano de execução nos casos de restos a pagar.|
|anoExercicio|Integer(4)|Ano de exercício, representa o ano de execução.|
|unidadeGestoraResponsavel|varchar(6)| |
|planoInterno|varchar(11)|Código do plano interno.|
|esfera|varchar(2)|Código da esfera.|
|unidadeOrcamentaria|varchar(5)|Código da unidade orçamentária.|
|funcao|varchar(2)|Código da função.|
|subFuncao|varchar(3)|Código da subfunção.|
|programa|varchar(4)|Código do programa.|
|acao|varchar(4)|Código da ação.|
|localizador|varchar(4)|Código do localizador.|
|planoOrcamentario|varchar(4)|Código do plano orçamentário.|
|natureza|varchar(8)|Código da natureza de despesa.|
|categoriaEconomica|varchar(1)|Código da categoria econômica.|
|grupoNaturezaDespesa|varchar(1)|Código do grupo de natureza de despesa.|
|modalidadeAplicacao|varchar(2)|Código da modalidade de aplicação.|
|elementoDespesa|varchar(2)|Código do elemento de despesa.|
|subElementoDespesa|varchar(2)|Código do subelemento de despesa.|
|idOc|varchar(4)|Código do identificador de doação e operações de crédito.|
|idUso|varchar(1)|Código do identificador de uso.|
|fonte|varchar(4)|Código da fonte de recursos.|
|resultadoPrimarioLei|varchar(1)|O código de resultado primário possui dois campos para guardar o código definido em lei e o atual, pois pode ter ocorrido alguma alteração orçamentária.|
|resultadoPrimarioAtual|varchar(1)|O código de resultado primário possui dois campos para guardar o código definido em lei e o atual, pois pode ter ocorrido alguma alteração orçamentária.|
|tipoCredito|varchar(1)|é a origem (tipo de inclusão) da ação. Domínio: A = LOA, C = Crédito Especial, G = Crédito Extraordinário.|
|origem|varchar(5)| |
|tipoApropriacaoPO|varchar(1)| |
|tematicaPO|varchar(1)|indica se o PO está associado a algum recorte temático do orçamento.|
|acompanhamentoPO|varchar(1)|Código do acompanhamento (Plano Orçamentário).|
|identificadorAcompanhamentoPO|varchar(2)|Código do identificador de acompanhamento (Plano Orçamentário).|
|detalheAcompanhamentoPO|varchar(2)|Código do detalhe de acompanhamento (Plano Orçamentário).|
|autorizado|BigDecimal| |
|projetoLei|BigDecimal| |
|dotacaoAntecipada|BigDecimal| |
|dotacaoInicial|BigDecimal| |
|dotInicialSiafi|BigDecimal| |
|dotAtual|BigDecimal| |
|empLiquidado|BigDecimal| |
|empenhadoALiquidar|BigDecimal| |
|pago|BigDecimal| |
|disponivel|BigDecimal| |
|indisponivel|BigDecimal| |
|rapInscritoProcessado|BigDecimal| |
|rapExerciciosAnteriores|BigDecimal| |
|rapCanceladosNaoProcessados|BigDecimal| |
|rapCanceladosProcessados|BigDecimal| |
|rapAPagarNaoProcessado|BigDecimal| |
|rapAPagarProcessado|BigDecimal| |
|rapPagoNaoProcessado|BigDecimal| |
|rapPagoProcessado|BigDecimal| |
|rapInscritoNaoProcessado|BigDecimal| |
|rapNaoProcessadoBloqueado|BigDecimal| |
|rapNaoProcessadoALiquidar|BigDecimal| |
|rapNaoProcessadoLiquidadoAPagar|BigDecimal| |
|creditoContidoSOF|BigDecimal| |
|bloqueadoSOF|BigDecimal| |
|bloqueadoRemanejamento|BigDecimal| |
|executadoPorInscricaoDeRAP|BigDecimal|Corresponde ao ajuste anual, presente no SIAFI, de despesas executadas por inscrição em restos a pagar.|
|numeroptres|String|Programa de Trabalho Resumido.|
|numeroemenda|String|Autor e número da emenda individual ou de bancada estadual.|
==== ExecucaoOrcamentariaMensalDestDTO ====
|Atributo|Tipo(tamanho)|Observações|
|exercicio|Inteiro(4)|Obrigatório.|
|esfera|Texto(2)|Código da esfera orçamentária.|
|unidadeOrcamentaria|Texto(5)|Código da unidade orçamentária.|
|funcao|Texto(2)|Código da função.|
|descricaoFuncao|Texto|Descrição da função.|
|subfuncao|Texto(3)|Código da Subfunção.|
|descricaoSubfuncao|Texto|Descrição da Subfunção.|
|programa|Texto(4)|Código do programa.|
|tituloPrograma|Texto|Título do programa.|
|acao|Texto(4)|Código da ação.|
|tituloAcao|Texto|Título da ação.|
|localizador|Texto(4)|Código do localizador.|
|tituloLocalizador|Texto|Título do localizador.|
|ppipac|Booleano|Verdadeiro caso faça parte do ppiPac, falso caso contrário|
|regiao|Texto| |
|uf|Texto| |
|lei|BigDecimal|Dotação da lei (inicial).|
|leiMaisCreditos|BigDecimal|Dotação atual.|
|realizadaJaneiro|BigDecimal|Empenho a liquidar com empenho liquidado em janeiro|
|realizadaFevereiro|BigDecimal|Empenho a liquidar com empenho liquidado somados até fevereiro|
|realizadaMarco|BigDecimal|Empenho a liquidar com empenho liquidado somados até março|
|realizadaAbril|BigDecimal|Empenho a liquidar com empenho liquidado somados até abril|
|realizadaMaio|BigDecimal|Empenho a liquidar com empenho liquidado somados até maio|
|realizadaJunho|BigDecimal|Empenho a liquidar com empenho liquidado somados até junho|
|realizadaJulho|BigDecimal|Empenho a liquidar com empenho liquidado somados até julho|
|realizadaAgosto|BigDecimal|Empenho a liquidar com empenho liquidado somados até agosto|
|realizadaSetembro|BigDecimal|Empenho a liquidar com empenho liquidado somados até setembro|
|realizadaOutubro|BigDecimal|Empenho a liquidar com empenho liquidado somados até outubro|
|realizadaNovembro|BigDecimal|Empenho a liquidar com empenho liquidado somados até novembro|
|realizadaDezembro|BigDecimal|Empenho a liquidar com empenho liquidado somados até dezembro|
|estatalDependente|Boolean|Indica se é uma estatal dependente|
|estatalIndependente|Boolean|Indica se é uma estatal independente|
==== FiltroExecucaoOrcamentariaDTO ====
|Atributo|Tipo(tamanho)|Aceita nulo?|Descrição|
|anoExercicio|Inteiro(4)|Sim, caso anoReferencia seja informado|Ano de exercício, representa o ano de execução.|
|anoReferencia|Inteiro(4)|Sim, caso anoExercicio seja informado|Ano de referência, diferente do ano de execução nos casos de restos a pagar.|
|esferas|Lista de varchar(2)|Sim|Códigos das esferas.|
|unidadesOrcamentarias|Lista de varchar(5)|Sim|Códigos das unidades orçamentárias.|
|funcoes|Lista de varchar(2)|Sim|Códigos das funções.|
|subfuncoes|Lista de varchar(3)|Sim|Códigos das subfunções.|
|programas|Lista de varchar(4)|Sim|Códigos dos programas.|
|acoes|Lista de varchar(4)|Sim|Códigos das ações.|
|localizadores|Lista de varchar(4)|Sim|Códigos dos localizadores.|
|planosOrcamentarios|Lista de varchar(4)|Sim|Códigos dos planos orçamentários.|
|naturezasDespesa|Lista de varchar(8)|Sim|Códigos das naturezas de despesas completos (até subelemento de despesa).|
|categoriasEconomicas|Lista de varchar(1)|Sim|Códigos das categorias econômicas.|
|gruposNatureza|Lista de varchar(1)|Sim|Códigos dos grupos de naturezas de despesa.|
|modalidadesAplicacao|Lista de varchar(2)|Sim|Códigos das modalidades de aplicação.|
|elementosDespesa|Lista de varchar(2)|Sim|Códigos dos elementos de despesa.|
|idusos|Lista de varchar(1)|Sim|Códigos dos identificadores de uso.|
|fontes|Lista de varchar(4)|Sim|Códigos das fontes de recursos.|
|idocs|Lista de varchar(4)|Sim|Códigos dos identificadores de doação e operações de crédito.|
|resultadosPrimariosLei|Lista de varchar(1)|Sim|Códigos dos resultados primários na LOA.|
|resultadosPrimariosAtuais|Lista de varchar(1)|Sim|Códigos dos resultados primários atuais.|
|planosInternos|Lista de varchar(11)|Sim|Códigos dos planos internos.|
|unidadesGestorasResponsaveis|Lista de varchar(6)|Sim|Códigos das unidades gestoras responsáveis.|
|tipoCredito|Lista de varchar(1)|Sim|é a origem (tipo de inclusão) da ação. Domínio: A = LOA, C = Crédito Especial, G = Crédito Extraordinário.|
|programacoesSelecionadas|Lista de varchar(1)|Sim|Marcações Programação Selecionada.|
|tiposPrecatorios|Lista de varchar(1)|Sim|Marcadores de Precatório|
|acompanhamentosIntensivos|Lista de varchar(2)|Sim|Marcadores de Acompanhamentos Intensivos|
|tiposApropriacaoPO|Lista de varchar(1)|Sim|Códigos dos tipos de apropriação (Plano Orçamentário)|
|tematicasPO|Lista de varchar(1)|Sim|Códigos das temáticas (Plano Orçamentário)|
|acompanhamentosPO|Lista de varchar(1)|Sim|Códigos dos acompanhamentos (Plano Orçamentário)|
|identificadoresAcompanhamentoPO|Lista de varchar(2)|Sim|Códigos dos identificadores de acompanhamento (Plano Orçamentário)|
|detalhesAcompanhamentoPO|Lista de varchar(2)|Sim|Códigos dos detalhes de acompanhamento (Plano Orçamentário)|
==== FiltroFuncionalProgramaticaDTO ====
Classe que encapsula os dados que compõem a classificação institucional/funcional-programática até o nível de localizador (incluindo tipo de inclusão de ação e de localizador). É utilizada como parâmetro nas operações de consulta. Os atributos passados como nulos são desconsiderados.
|Atributo|Tipo(tamanho)|Aceita Nulo?|Observações|
|codigoAcao|Texto(4)|Sim| |
|codigoEsfera|Texto(2)|Sim| |
|codigoFuncao|Texto(2)|Sim| |
|codigoLocalizador|Texto(4)|Sim| |
|codigoPrograma|Texto(4)|Sim| |
|codigoSubFuncao|Texto(3)|Sim| |
|codigoTipoInclusaoAcao|Inteiro(1)|Sim|Valores válidos: 1 - PLOA, 2 - Emenda, 4 - PPA, 5 - Crédito Especial, 6 - Crédito Extraordinário.|
|codigoTipoInclusaoLocalizador|Inteiro(1)|Sim|Valores válidos: 1 - PLOA, 2 - Emenda, 4 - PPA, 5 - Crédito Especial, 6 - Crédito Extraordinário.|
|codigoUO|Texto(5)|Sim| |
|exercicio|Inteiro(4)|Sim| |
==== FinanceiroDTO ====
A chave única deste DTO deve ser composta também pela chave-única de PropostaDTO.
|Atributo|Tipo(tamanho)|Aceita Nulo?|Observações|
|__idUso__|Texto(1)|Não|Os valores possíveis podem ser recuperados pela operação obterTabelasApoioQuantitativo.|
|__idOC__|Texto(4)|Não|Os valores possíveis podem ser recuperados pela operação obterTabelasApoioQuantitativo.|
|__naturezaDespesa__|Texto(8)|Não|Os valores possíveis podem ser recuperados pela operação obterTabelasApoioQuantitativo.|
|__fonte__|Texto(3)|Não|Os valores possíveis podem ser recuperados pela operação obterTabelasApoioQuantitativo.|
|__resultadoPrimarioLei__|Texto(1)|Não|O código de resultado primário possui dois campos para guardar o código definido em lei e o atual, pois pode ter ocorrido alguma alteração orçamentária.|
|__resultadoPrimarioAtual__|Texto(1)|Sim|O código de resultado primário possui dois campos para guardar o código definido em lei e o atual, pois pode ter ocorrido alguma alteração orçamentária.|
|__identificadorPlanoOrcamentario__|Inteiro|Não|Deve ser preenchido se a ação possuir pelo menos um plano orçamentário. O valor desse campo corresponde ao atributo identificadorUnico de PlanoOrcamentarioDTO (não é o código do plano orçamentário).|
|valor|Long|Não| |
|expansaoSolicitada|Long|Sim| |
|expansaoConcedida|Long|Sim|Campo de retorno.|
==== FinanceiroEmendasDTO ====
Este DTO herda os atributos de FinanceiroDTO.
|Atributo|Tipo(tamanho)|Observações|
|emendas|Lista de EmendaDTO| |
==== FonteDTO ====
|Atributo|Tipo(tamanho)|Observações|
|__codigoFonte__|Texto| |
|__exercicio__|Inteiro| |
|descricao|Texto| |
|snAtivo|Booleano| |
==== IdOcDTO ====
|Atributo|Tipo(tamanho)|Observações|
|__codigoIdOc__|String| |
|__exercicio__|Inteiro| |
|descricao|Texto| |
|snAtivo|Booleano| |
==== IdUsoDTO ====
|Atributo|Tipo(tamanho)|Observações|
|__codigoIdUsoDTO__|Texto| |
|__exercicio__|Inteiro| |
|descricao|Texto| |
|snAtivo|Booleano| |
==== InformacaoCargaSiafiDTO ====
|Atributo|Tipo(tamanho)|Observações|
|dataCompetencia|Date| |
|dataFechamentoUltimoMes|Date| |
|tipo|String| |
|ultimaCarga|Date| |
|ultimoMesFechado|String|Formato: AAAA-MM|
==== InformacaoCaptacaoPLOADTO ====
|Atributo|Tipo(tamanho)|Observações|
|exercicio|Inteiro| |
|identificadorUnicoLocalizador|Inteiro| |
|codigoMomentoLocalizador|Inteiro| |
|identificadorUnicoAcao|Inteiro| |
|codigoMomentoAcao|Inteiro| |
|funcional|Texto| |
|temProposta|Boolean| |
|codigoMomentoPropostaAtual|Inteiro| |
|propostaValida|Boolean| |
|codigoTipoDetalhamento|Texto(2)| |
|temJanela|Boolean| |
|codigoMomentoJanelaAtual|Inteiro| |
|podeCaptar|Boolean| |
|porQueNaoPodeCaptar|Texto| |
==== MetaPlanoOrcamentarioDTO ====
|Atributo|Tipo(tamanho)|Observações|
|__identificadorUnicoPlanoOrcamentario__|Inteiro|O valor desse campo corresponde ao atributo identificadorUnico de PlanoOrcamentarioDTO (não é o código do plano orçamentário).|
|quantidadeFisico|Long|Meta física para o plano orçamentário.|
|expansaoFisicaSolicitada|Long| |
|expansaoFisicaConcedida|Long|Campo de retorno.|
==== NaturezaDespesaDTO ====
|Atributo|Tipo(tamanho)|Observações|
|__codigoNatureza__|Texto| |
|__exercicio__|Inteiro| |
|descricao|Texto| |
|descricaoAbreviada|Texto| |
==== ParametroInformacaoCaptacaoPLOA ====
|Atributo|Tipo(tamanho)|Aceita nulo?|Observações|
|exercicio|Inteiro|Não| |
|codigoMomento|Inteiro|Não| |
|codigoTipoDetalhamento|Texto(2)|Sim| |
|codigoOrgao|Texto(5)|Não| |
|codigoUnidadeOrcamentaria|Texto(5)|Sim| |
|captados|Boolean|Sim|Use true para obter somente os localizadores com proposta, false para obter somente os localizadores sem proposta, e nulo para todos.|
|captaveis|Boolean|Sim|Use true para obter apenas os localizadores que estejam aptos a serem captados. Em caso de false ou nulo retorna todos.|
==== ParametrosWebExecucaoOrcamentariaDTO ====
Parâmetros aplicáveis a consultas de execução orçamentária, para filtrar os resultados do serviço.
|Atributo|Tipo(tamanho)|Aceita Nulo?|Observações|
|__exercicio__|Inteiro(4)|Não|Obrigatório.|
|esfera|Texto|Sim| |
|orgao|Texto|Sim| |
|unidadeOrcamentaria|Texto|Sim| |
|funcao|Texto|Sim| |
|subFuncao|Texto|Sim| |
|programa|Texto|Sim| |
|acao|Texto|Sim| |
|localizador|Texto|Sim| |
==== PerguntaAcompanhamentoOrcamentarioDTO ====
|Atributo|Tipo(tamanho)|Observações|
|codigoPergunta|Inteiro|Código da pergunta. Lista com valores válidos pode ser obtida através do método obterPerguntasAcompanhamentoOrcamentario.|
|pergunta|Texto|Este é um atributo de saída, não deve ser preenchido no cadastro de acompanhamento.|
|tipoPergunta|Texto|Este é um atributo de saída, não deve ser preenchido no cadastro de acompanhamento.|
|respostasAcompanhamento|Lista de RespostaAcompanhamentoOrcamentarioDTO| |
==== RespostaAcompanhamentoOrcamentarioDTO ====
|Atributo|Tipo(tamanho)|Observações|
|codigoResposta|Inteiro|Código da resposta. Lista com valores válidos pode ser obtida através do método ObterPerguntasAcompanhamentoOrcamentario.|
|resposta|Texto|Este é um atributo de saída, não deve ser preenchido no cadastro de acompanhamento.|
|especificacaoResposta|Texto|Utilizado somente para respostas que necessitem de especificação.|
|ordem|Inteiro|Utilizado para perguntas que requerem ordenação entre as respostas.|
==== PropostaDTO ====
Representa a proposta orçamentária para um determinado localizador e tipo de detalhamento.
|Atributo|Tipo(tamanho)|Aceita Nulo?|Observações|
|__exercicio__|Inteiro|Não| |
|__codigoEsfera__|Texto(2)|Não| |
|__codigoOrgao__|Texto(5)|Não|Código da unidade orçamentária.|
|__codigoFuncao__|Texto(2)|Não| |
|__codigoSubFuncao__|Texto(3)|Não| |
|__codigoPrograma__|Texto(4)|Não| |
|__codigoAcao__|Texto(4)|Não| |
|__codigoTipoInclusaoAcao__|Numerico(1)|Não|Valores válidos: 1 - PLOA, 2 - Emenda, 4 - PPA, 5 - Crédito Especial, 6 - Crédito Extraordinário|
|__codigoLocalizador__|Texto(4)|Não| |
|__codigoTipoInclusaoLocalizador__|Numerico(1)|Não|Valores válidos: 1 - PLOA, 2 - Emenda, 4 - PPA, 5 - Crédito Especial, 6 - Crédito Extraordinário|
|__codigoMomento__|Numerico(4)|Não| São os momentos (etapas) do processo no SIOP: 1000 (UO), 2000 (OS), 5000 (PLOA) e 8000 (LOA). Podem haver outros visualizados somente na SOF.|
|__codigoTipoDetalhamento__|Texto(2)|Não| São referenciais usados durante a elaboração da proposta. Para momentos PLOA e LOA devem sempre estar com valor zero. Detalhes dos valores podem ser consultados no [[https://orcamentofederal.gov.br/informacoes-orcamentarias/manual-tecnico/mto_2016_2aedicao_220915.pdf|MTO]].|
|snAtual|Boolean|Sim|Campo de retorno|
|quantidadeFisico|Long|Sim|Meta física para o localizador da proposta.|
|valorFisico|Long|Sim|Valor necessário para atingir a meta física, equivale à soma dos financeiros da proposta.|
|financeiros|Lista de FinanceiroDTO|Não|Contém os detalhamentos financeiros da proposta.|
|receitas|Lista de ReceitaDTO|Sim|Utilizado somente nas propostas da esfera 30 (investimentos).|
|metaPlanoOrcamentario|Lista de MetaPlanoOrcamentarioDTO|Sim|justificativaContém as metas físicas dos planos orçamentários que possuam produto associado.|
|justificativa|Texto|Sim| |
|identificadorUnicoAcao|Inteiro|Sim| |
|expansaoFisicaSolicitada|Long|Sim| |
|expansaoFisicaConcedida|Long|Sim|Campo de retorno.|
|justificativaExpansaoSolicitada|String(2500)|Sim| |
|justificativaExpansaoConcedida|String(2500)|Sim|Campo de retorno.|
==== ReceitaDTO ====
|Atributo|Tipo(tamanho)|Aceita Nulo?|Observações|
|__naturezaReceita__|Texto(8)|Não|Código de Natureza de Receita.|
|valor|Long|Não| |
==== ResultadoPrimarioDTO ====
|Atributo|Tipo(tamanho)|Observações|
|__codigoResultadoPrimario__|Texto| |
|__exercicio__|Inteiro| |
|descricao|Texto| |
==== SelecaoRetornoExecucaoOrcamentariaDTO ====
|Atributo|Tipo(tamanho)|Aceita Nulo?|Descrição|
|anoReferencia|Boolean|Sim| |
|anoExercicio|Boolean|Sim| |
|unidadeGestoraResponsavel|Boolean|Sim| |
|planoInterno|Boolean|Sim| |
|esfera|Boolean|Sim| |
|unidadeOrcamentaria|Boolean|Sim| |
|funcao|Boolean|Sim| |
|subFuncao|Boolean|Sim| |
|programa|Boolean|Sim| |
|acao|Boolean|Sim| |
|localizador|Boolean|Sim| |
|planoOrcamentario|Boolean|Sim| |
|natureza|Boolean|Sim| |
|categoriaEconomica|Boolean|Sim| |
|grupoNaturezaDespesa|Boolean|Sim| |
|modalidadeAplicacao|Boolean|Sim| |
|elementoDespesa|Boolean|Sim| |
|subElementoDespesa|Boolean|Sim| |
|idoc|Boolean|Sim| |
|iduso|Boolean|Sim| |
|fonte|Boolean|Sim| |
|resultadoPrimarioLei|Boolean|Sim|O código de resultado primário possui dois campos para guardar o código definido em lei e o atual, pois pode ter ocorrido alguma alteração orçamentária.|
|resultadoPrimarioAtual|Boolean|Sim|O código de resultado primário possui dois campos para guardar o código definido em lei e o atual, pois pode ter ocorrido alguma alteração orçamentária.|
|tipoCredito|Boolean|Sim|é a origem (tipo de inclusão) da ação. Domínio: A = LOA, C = Crédito Especial, G = Crédito Extraordinário.|
|programacaoSelecionada|Boolean|Sim| |
|tipoPrecatorio|Boolean|Sim| |
|tipoApropriacaoPO|Boolean|Sim| |
|tematicaPO|Boolean|Sim|Indica se o PO está associado a algum recorte temático do orçamento.|
|acompanhamentoPO|Boolean|Sim| |
|identificadorAcompanhamentoPO|Boolean|Sim| |
|detalheAcompanhamentoPO|Boolean|Sim| |
|autorizado|Boolean|Sim| |
|projetoLei|Boolean|Sim| |
|dotacaoAntecipada|Boolean|Sim| |
|dotacaoInicial|Boolean|Sim| |
|dotInicialSiafi|Boolean|Sim| |
|dotAtual|Boolean|Sim| |
|empLiquidado|Boolean|Sim| |
|empenhadoALiquidar|Boolean|Sim| |
|pago|Boolean|Sim| |
|disponivel|Boolean|Sim| |
|indisponivel|Boolean|Sim| |
|rapInscritoProcessado|Boolean|Sim| |
|rapExerciciosAnteriores|Boolean|Sim| |
|rapCanceladosNaoProcessados|Boolean|Sim| |
|rapCanceladosProcessados|Boolean|Sim| |
|rapAPagarNaoProcessado|Boolean|Sim| |
|rapAPagarProcessado|Boolean|Sim| |
|rapPagoNaoProcessado|Boolean|Sim| |
|rapPagoProcessado|Boolean|Sim| |
|rapInscritoNaoProcessado|Boolean|Sim| |
|rapNaoProcessadoBloqueado|Boolean|Sim| |
|rapNaoProcessadoALiquidar|Boolean|Sim| |
|rapNaoProcessadoLiquidadoAPagar|Boolean|Sim| |
|creditoContidoSOF|Boolean|Sim| |
|bloqueadoSOF|Boolean|Sim| |
|bloqueadoRemanejamento|Boolean|Sim| |
|mes|Boolean|Sim|Utilizado apenas nas chamadas de consultarExecucaoOrcamentariaMensal|
|numeroptres|Boolean|Sim| |
|numeroemenda|Boolean|Sim| |
==== FisicoPedidoAlteracaoDTO ====
|Atributo|Tipo(tamanho)|Observações|
|exercicio|Inteiro| |
|codigoEsfera|Texto| |
|codigoUO|Texto| |
|codigoFuncao|Texto| |
|codigoSubFuncao|Texto| |
|codigoPrograma|Texto| |
|codigoAcao|Texto| |
|codigoLocalizador|Texto| |
|codigoTipoInclusaoAcao|Inteiro| |
|codigoTipoInclusaoLocalizador|Inteiro| |
|quantidadeAcrescimo|Numérico| |
|quantidadeReducao|Numérico| |
|listaFinanceiroPedidoAlteracaoDTO|Lista FinanceiroPedidoAlteracaoDTO| |
**Retornos**
==== PaginacaoDTO ====
|Atributo|Tipo(tamanho)|Observações|
|pagina|Inteiro|Número da página retornada na consulta. Quando utilizado como parâmetro, deve informar o número da página desejada.|
|registrosPorPagina|Inteiro|Número máximo de registros por página.|
==== RetornoAcompanhamentoFisicoFinanceiroDTO ====
|Atributo|Tipo(tamanho)|Observações|
|registros|Lista de AcompanhamentoFisicoFinanceiroDTO| |
|paginacao|PaginacaoDTO|Contém informações sobre a paginação do resultado da operação. Pode ser utilizado também como parâmetro nas operações com páginação quando se pretende obter as páginas subsequentes de uma consulta.|
|dataHoraUltimaCargaSiafi|Data|Data da última atualização dos valores financeiros.|
==== RetornoAcompanhamentoOrcamentarioDTO ====
|Atributo|Tipo(tamanho)|Observações|
|acompanhamentosAcao|Lista de AcompanhamentoOrcamentarioAcaoDTO| |
==== RetornoApoioQuantitativoDTO ====
|Atributo|Tipo(tamanho)|Observações|
|naturezas|Lista de NaturezaDespesaDTO| |
|idocs|Lista de IdOcDTO| |
|idUsos|Lista de IdUsoDTO| |
|fontes|Lista de FonteDTO| |
|resultadosPrimarios|Lista de ResultadoPrimarioDTO| |
==== RetornoExecucaoOrcamentariaDTO ====
|Atributo|Tipo(tamanho)|Descrição|
|sucesso|Boolean|Indicação de sucesso na execução da operação.|
|mensagensErro|Lista de String|Lista com as mensagens do sistema em caso de sucesso = false.|
|dataHoraUltimaCarga|Date| Data e hora da última carga da parasof (STN). **ATENÇÃO**! nas operações de consultas de execução mensal este campo tem o seguinte significado específico. O ano e mês informam o último mês fechado. O dia serve para indicar quando ocorreu o fechamento do mês, mas é necessário incrementar o valor do mês em 1. Exemplos: "2014-05-09" = mês 05/14 fechou em 09/06/14, "2014-04-11" = mês 04/14 fechou em 11/05/14, "2014-03-08" = mês 03/14 fechou em 08/04/14|
|execucoesOrcamentarias|Lista de ExecucaoOrcamentariaDTO| |
|paginacao|PaginacaoDTO|Contém informações sobre a paginação do resultado da operação. Pode ser utilizado também como parâmetro nas operações com páginação quando se pretende obter as páginas subsequentes de uma consulta.
==== RetornoExecucaoOrcamentariaDestDTO ====
|Atributo|Tipo(tamanho)|Observações|
|registros|Lista de ExecucaoOrcamentariaMensalDestDTO| |
==== RetornoFinanceiroEmendasDTO ====
|Atributo|Tipo(tamanho)|Observações|
|financeiros|Lista de FinanceiroEmendasDTO| |
==== RetornoInformacaoCaptacaoPLOADTO ====
|Atributo|Tipo(tamanho)|Observações
|registros|Lista de InformacaoCaptacaoPLOADTO| |
==== RetornoInformacaoCargaSiafiDTO ====
|Atributo|Tipo(tamanho)|Observações|
|informacoesCargaSiafi|List| |
==== RetornoPerguntasAcompanhamentoOrcamentarioDTO ====
|Atributo|Tipo(tamanho)|Observações|
|perguntasAcompanhamento|Lista de PerguntaAcompanhamentoOrcamentarioDTO| |
==== 3.2.11 RetornoPropostasDTO ====
|Atributo|Tipo(tamanho)|Observações|
|sucesso|Booleano|Indica que a operação foi realizada com sucesso.|
|mensagensErro|Lista de Texto|Lista de mensagens de erro, quando sucesso for 'false'.|
|registros|Lista de PropostaDTO| |
|numeroRegistros|Inteiro|Número de registros retornados|
|valorTotal|Long|Valor total dos registros retornados|
\\