Upload
truongdiep
View
214
Download
0
Embed Size (px)
Citation preview
2/19
ÍNDICE
1. Objetivo .................................................................................................... 3
2. Página inicial do Módulo de Administração (Acesso restrito) .................... 3
3. Administração ........................................................................................... 4
3.1. Manuais ............................................................................................ 5
3.2. Downloads ........................................................................................ 5
3.3. Estrutura do arquivo exemplo Xml Despesas ......................................... 6
3.4. Estrutura do arquivo exemplo Xml Receitas ........................................... 8
3.5. Exemplo de aplicação em .Net (V001) ................................................ 10
3.6. Página principal do Portal – Receitas e Despesas (Acesso público) ......... 14
3/19
1. Objetivo
O objetivo deste manual é oferecer aos representantes de cada município, um material de apoio e esclarecimento de dúvidas no cadastramento das informações referentes à Receitas e Despesas pela Administração Pública Municipal, para a promoção da transparência e melhoria da qualidade dos dados de interesse da sociedade.
Importante: A Administração Pública Municipal deverá realizar uma adequação no seu sistema para possibilitar que as informações referentes à Receitas e Despesas possam ser exportadas no formato XML, seguindo a estrutura dos modelos disponíveis na opção “Downloads” – Arquivo exemplo Xml Despesas e Arquivo exemplo Xml Receitas (itens 3.3 e 3.4 deste manual).
2. Página inicial do Módulo de Administração (Acesso restrito)
Para acessar o módulo de administração, os representantes de cada município, responsáveis pela disponibilização das informações no portal, terão um único endereço para acesso WEB, sendo que o município a que pertencem será identificado ao acessarem o sistema com seus logins e senhas individuais:
• Endereço eletrônico do módulo de administração: http://www.transparenciamunicipaladm.sp.gov.br
Cada usuário será vinculado a um município pré-cadastrado, podendo alimentar e acessar somente as informações do seu município.
4/19
3. Administração
O usuário terá acesso às funcionalidades do módulo de cadastro. Cada usuário estará vinculado a um município pré-cadastrado, podendo alimentar e acessar somente as seguintes informações do município a que pertence:
• Balanços Contábeis
• Contratos e Convênios firmados pelo Município
• Legislação
• Lei de Responsabilidade Fiscal – relatórios
• Licitações do Município
• PPA/ LDO
• Remuneração de Servidores
• Credenciais WebService
As opções acima também podem ser acessadas a partir de qualquer página do módulo de administração, através do menu superior no cabeçalho.
A opção “Credenciais WebService” contém as informações de Login e Senha que deverão estar preenchidas nas tag´s dos arquivos XML de Receitas e Despesas:
<Login> </Login>
<Senha> </Senha>
5/19
3.1. Manuais
Acesso a arquivos PDF de manuais para orientação dos usuários responsáveis pela inserção de informações no portal, através do Módulo de Administração.
Na opção “Importação de Dados” consta o Manual do Web service que contém as informações: Endereço de Acesso, Nome dos Campos, Tipo, Limite e Obrigatório, Dados de Retorno e Exemplo de Utilização.
3.2. Downloads
Acesso aos modelos de arquivos XML para Despesas e Receitas e Exemplo de aplicação em .Net (V001).
6/19
3.3. Estrutura do arquivo exemplo Xml Despesas
As tags <Login> e <Senha> deverão ser preenchidas com as informações contidas na opção “Credenciais Webservice” do módulo de Administração.
Na tag <ação> deverá ser informada as opções Inserir (inclusão de registro) ou Alterar (alteração de registro) ou Deletar (deleção de registro).
<?xml version="1.0" encoding="utf-8" ?>
- <_Despesa xmlns="http://tempuri.org/">
- <usuario> <Login>string</Login>
<Senha>string</Senha>
- <log>
<codigoDeOrigem>long</codigoDeOrigem>
<codigoDeRetorno>long</codigoDeRetorno>
<tipoDeRetorno>ComSucesso or SemSucesso or Erro or UsuarioNaoEncontrado or UsuarioSemPermissao or SenhaIncorreta or EntidadeVasia</tipoDeRetorno>
<Descricao>string</Descricao>
</log>
</usuario>
<acao>Inserir or Alterar or Deletar</acao>
- <listDespesa>
- <Despesa> <co_despesa>long</co_despesa>
<dt_referencia>dateTime</dt_referencia>
<de_orgao>string</de_orgao>
<tp_despesa>string</tp_despesa>
<nu_empenho>string</nu_empenho>
<id_despesa>string</id_despesa>
<de_despesa>string</de_despesa>
<dt_emissao>dateTime</dt_emissao>
<vl_despesa>decimal</vl_despesa>
<de_funcaoGoverno>string</de_funcaoGoverno>
<de_subfuncaoGoverno>string</de_subfuncaoGoverno>
<co_programa>int</co_programa>
<de_programa>string</de_programa>
<co_acao>int</co_acao>
<de_acao>string</de_acao>
<de_fonteRecurso>string</de_fonteRecurso>
<de_aplicacaoFixa>string</de_aplicacaoFixa>
<de_modalidadeLic>string</de_modalidadeLic>
<de_elemento>string</de_elemento>
<hi_despesa>string</hi_despesa>
</Despesa>
- <Despesa>
<co_despesa>long</co_despesa>
7/19
<dt_referencia>dateTime</dt_referencia>
<de_orgao>string</de_orgao>
<tp_despesa>string</tp_despesa>
<nu_empenho>string</nu_empenho>
<id_despesa>string</id_despesa>
<de_despesa>string</de_despesa>
<dt_emissao>dateTime</dt_emissao>
<vl_despesa>decimal</vl_despesa>
<de_funcaoGoverno>string</de_funcaoGoverno>
<de_subfuncaoGoverno>string</de_subfuncaoGoverno>
<co_programa>int</co_programa>
<de_programa>string</de_programa>
<co_acao>int</co_acao>
<de_acao>string</de_acao>
<de_fonteRecurso>string</de_fonteRecurso>
<de_aplicacaoFixa>string</de_aplicacaoFixa>
<de_modalidadeLic>string</de_modalidadeLic>
<de_elemento>string</de_elemento>
<hi_despesa>string</hi_despesa>
</Despesa>
</listDespesa>
</_Despesa>
8/19
3.4. Estrutura do arquivo exemplo Xml Receitas
As tags <Login> e <Senha> deverão ser preenchidas com as informações contidas na opção “Credenciais Webservice” do módulo de Administração.
Na tag <ação> deverá ser informada as opções Inserir (inclusão de registro) ou Alterar (alteração de registro) ou Deletar (deleção de registro).
<?xml version="1.0" encoding="utf-8" ?> - <_Receita xmlns="http://tempuri.org/">
- <usuario>
<Login>string</Login>
<Senha>string</Senha>
- <log> <codigoDeOrigem>long</codigoDeOrigem>
<codigoDeRetorno>long</codigoDeRetorno>
<tipoDeRetorno>ComSucesso or SemSucesso or Erro or UsuarioNaoEncontrado or UsuarioSemPermissao or SenhaIncorreta or EntidadeVasia</tipoDeRetorno>
<Descricao>string</Descricao>
</log>
</usuario>
<acao>Inserir or Alterar or Deletar</acao>
- <listReceita>
- <Receita>
<co_receita>long</co_receita>
<dt_referencia>dateTime</dt_referencia>
<de_orgao>string</de_orgao>
<de_poder>string</de_poder>
<de_fonteRecurso>string</de_fonteRecurso>
<de_aplicacaoFixa>string</de_aplicacaoFixa>
<de_aplicacaoVariavel>string</de_aplicacaoVariavel>
<de_categoria>string</de_categoria>
<de_subcategoria>string</de_subcategoria>
<de_fonte>string</de_fonte>
<de_rubrica>string</de_rubrica>
<de_alinea>string</de_alinea>
<de_subalinea>string</de_subalinea>
<vl_arrecadacao>decimal</vl_arrecadacao>
</Receita>
- <Receita>
<co_receita>long</co_receita>
<dt_referencia>dateTime</dt_referencia>
<de_orgao>string</de_orgao>
<de_poder>string</de_poder>
<de_fonteRecurso>string</de_fonteRecurso>
<de_aplicacaoFixa>string</de_aplicacaoFixa>
<de_aplicacaoVariavel>string</de_aplicacaoVariavel>
<de_categoria>string</de_categoria>
<de_subcategoria>string</de_subcategoria>
9/19
<de_fonte>string</de_fonte>
<de_rubrica>string</de_rubrica>
<de_alinea>string</de_alinea>
<de_subalinea>string</de_subalinea>
<vl_arrecadacao>decimal</vl_arrecadacao>
</Receita>
</listReceita>
</_Receita>
10/19
3.5. Exemplo de aplicação em .Net (V001)
Para facilitar o envio dos arquivos de Despesas e Receitas foi desenvolvida uma aplicação, que encontra-se disponível na opção “Exemplo de aplicação em .Net (V001)” do módulo de Administração – Menu Downloads.
Para utilização do aplicativo baixar o arquivo ExemploDeAplicacao_V001.zip ,descompactar os arquivos e rodar o arquivo executável, selecionar os arquivos XML de Despesa e Receita* e enviar.
* Os arquivos serão recebidos pelo WebService, desde que estejam na estrutura informada acima.
12/19
Escolhendo o Arquivo
O sistema exibirá uma janela para a seleção do arquivo.
Escolha o arquivo XML, lembrando que o modelo e a descrição dos arquivos estão nos itens 3.4 e 3.5 deste manual.
13/19
Log de Retorno
Após a seleção do arquivo o sistema exibirá o “Log” que o Web Service disponibiliza como retorno.
14/19
3.6. Página principal do Portal – Receitas e Despesas (Acesso público)
As informações carregadas poderão ser visualizadas no item Receitas e Despesas: – Receita Atualizada e Despesa Atualizada.
http://www.transparencia.nomedomunicipio.sp.gov.br