Formulário de integração com API do PagTesouro
-
Interface Administrativa:
-
Cadastro de Tokens (Banco de Dados)
Melhorias: atualmente salvando dados no formato string, com o JSON contendo os dados cadastrados (mudar para tabelas específicas?)
-
Exibir dados cadastrados pelos usuário no formato padrão do Joomla de apresentação de listagens
-
Exibir mensagem de atualizações com base no GitHub e versão publicada
-
Personalização do CSS do formulário atráves da interface administrativa em nova aba de apresentação de opções
Obs.: Verificar editores de css possíveis de integração e compatíveis com Joomla
-
-
Interface Usuário:
- Salvar dados submetidos no formulário em banco de dados
- Consultar documento
Marcelo Valvassori Bittencourt (bitts)
Júlio César Vieira Malliotti (Malliotti)
Marcos Luiz Rezende de Melo (mlrmelo)
O PagTesouro é um componente de processamento de pagamentos digitais gerido pela Secretaria do Tesouro Nacional (STN), um órgão vinculado ao Ministério da Economia e que tem como missão principal gerenciar as contas públicas de forma eficiente e transparente. No contexto do processo de Gerenciamento das Receitas da União, o componente PagTesouro atua no cenário de recolhimento de receitas de Órgãos e entidades da administração Pública Federal como taxas (custas judiciais, emissão de passaporte, etc.), aluguéis de imóveis públicos, serviços administrativos e educacionais, multas, entre outros, permitindo o pagamento em forma digital, assim como a impressão do boleto de pagamento. O pagamento pode ser feito pelas formas Pix, cartão de crédito e boleto de GRU Simples.
Sistema simples para geração de GRU utilizando a API do PagTesouro. Projeto iniciado por Malliotti, transformado adaptado por Marcelo para utilização de PHP, ocultando assim dados como a url de requisição e a própria chave de autorização de acesso da Organização Militar vinculada.
Aqueles interessados em realizar melhorias, fiquem a vontade, este é um projeto aberto e a utilização do Github visa centralizar melhorias para beneficio de todos.
Procure manter o projeto de forma que os clientes necessitem editar somente o arquivo JSON (facilitando assim atualização).
https://valpagtesouro.tesouro.gov.br/simulador/#/pages/api
https://pagtesouro.tesouro.gov.br/docs/api-psp/
-
[03/02/2021] 1.0 - Modificações básicas para funcionamento da API utilizando cURL do PHP, enviado os dados do formulário para classe PHP que trata os dados, inclui as chaves de autorização e URL para realizar as requisições ao PagTesouro.
-
[19/02/2021] 1.1 - Alterado sistema para funcionar com vários Tokens
-
[20/02/2021] 1.2 - Alteração para configurações em arquivo json
- [Validado] Alterado para cadastramento dos dados de Tokens e Serviços para o arquivo pagtesouro.json
- [Validado] Adicionado novas formas de envio dos dados ao PagTesouro (file_get_contents e fopen, além do curl como última alternativa já que em muitos servidores algumas dessas bibliotecas podem não estarem habilitadas por default no PHP)
- [Validado] Adição de arquvio .htaccess com regras básicas para segurança ou para eviar erros de chamada
-
[22/02/2021] 1.3 - [Validado] Funcional para diversos Token
-
[01/02/2021] 1.4 - [Validado] Sistema para hospedagem simples
-
[16/03/2021] 2.0 Funciona como componente do Joomla!
-
[28/03/2021] 2.1 - Diversas melhoras:
-
Exportar cadastro realizado na interface Administrativa (backup do pagtesouro.json)
-
No formulário de geração o(s) Serviço(s) agora é(são) apresentados por UGE (optgroup do select)
-
Diversas melhoras na interface de administração para se adptar mais ao padrão Joomla!
-
Aplicação de mascara nos campos do formulário de geração
-
Formulário de geração mais compacto
-
Na interface administrativa aba para acompanhar atualizações do Componente do PagTesouro
-
Também na interface administrativa aba com conteudo do arquivo README.me mais atual direto do Github
-
-
[05/03/2022] 2.2 - Correções para possível publicação no site Extensions Directory
-
[15/03/2022] 2.2 - Publicação no site Extensions Directory
- Modificação da abertura do retorno do Pagtesouro de iframe para windows.open (abertura em nova janela)
-
[14/06/2022] 3.0 - Melhorias na interface de administração modificando a sistemática para salvamento das informações em Banco de Dados.
Passo a Passo - Material de Rafael Menezes
Resumo
Siga os passos abaixo para que o sistema esteja funcional:
1 - Gere os Códigos Necessários (Setor Financeiro)
A - Solicite o Setor Financeiro de sua organização (usuário SIAFI válido) que gere um Token para cada uma das UGs sobre sua gerência, no SISGRU. Aba PagTesouro / Autorização de uso do PagTesouro / inserir o código da UG, o período para utilização e setar situação "ativo".
B - Solicite o Setor Financeiro (usuário SIAFI válido) que gere os Códigos de Serviço correspondentes para cada UG., no SISGRU. Aba PagTesouro / Catálago de serviços / Inserir o código da UG, código de recolhimento da GRU e o tipo de serviço. Após isso, selecione Incluir.
- Acessar painel administrativo do Joomla
- Ir no Menu > Extesions > Manager > Install
- Na opção "Upload Package File" você precisa fazer o download do arquivo da versão 2.2 para o seu computador e depois escolher o arquivo para instalação;
- Vá no Menu "Components" > "PagTesouro", para adicionar ou remover seus Tokens e Serviços
- Em caso de dificuldades veja documentação do sistema ou a interpretação das mensagens do sistema
- Realize o download do sistema na versão v1.4
- Adicionar os arquivos em um pasta dentro do Joomla
- Editar arquivo pagtesouro.JSON
Caso você utilize Joomla é quer colocar o conteudo deste formulário de forma integrada em seu site
- Criar dentro do Joomla um conteudo do tipo iframe e aponte para o arquivo index.php
- O arquivo pagtesouro.html é a template do formulário e PODE (não precisa) ser modificada para adequar-se melhor a realidade de onde deseja integrar o sisteminha
- Evite modificar arquivos como o pagtesouro.php ou o pagtesouro.html, se você realmente não sabe o que esta fazendo
- A descrição pode ser alterada no arquivo pagtesouro.json para facilitar o uso pelo cliente, no caso de varias UGs você pode editar para "UG 6666-6 | 701 - Indenizações" ao invés de utilizar somente "701 - INDENIZAÇÕES"
- Abaixo alguns detalhes do arquivo de configuração para hospedagens simples onde é preciso editar o arquivo (ARQUIVO: pagtesouro.json)
[
{
"token" : "Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIxNjAwODYifQ.fY4bWesL85B_vFSOmRUyfrawte-SjSuqKcFQTfyfMQVFKyl6gfJKX63o_wElLkb3MHXl5xmQG9zlQasv5V561uq-R8uV6Gi35iXy36hk6wdc8LyLk-WgVD5TN4fyCCrZ5VH6tuayM7xmZ3fPyPdfJFknCCao48E2skbptEHS-8VUjFKAUObd_oFblDsyc8jC0cYPfX7p8IbO1kdeibqBbu-wpnGczsmoWftMkmS82Y-U9EqcRcY5IN10IcVFg_IJ7Mo5SeH3snfrcOMVP-DMjUH0MefmHUqN0eMGlBbeZK1rHxvRXfB7Ual9PORzyhuTO5kzIYK90EW1sT2qNl4TXA",
"servicos" : [
{
"codigo" : 701,
"descricao": "701 - INDENIZAÇÕES"
},
{
"codigo": 702,
"descricao" : "702 - INDENIZAÇÕES USO IMOVEIS"
}
]
},
{
"token" : "Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIxNjAwODYifQ.fY4bWesL85B_vFSOmRUyfrawte-SjSuqKcFQTfyfMQVFKyl6gfJKX63o_wElLkb3MHXl5xmQG9zlQasv5V561uq-R8uV6Gi35iXy36hk6wdc8LyLk-WgVD5TN4fyCCrZ5VH6tuayM7xmZ3fPyPdfJFknCCao48E2skbptEHS-8VUjFKAUObd_oFblDsyc8jC0cYPfX7p8IbO1kdeibqBbu-wpnGczsmoWftMkmS82Y-U9EqcRcY5IN10IcVFg_IJ7Mo5SeH3snfrcOMVP-DMjUH0MefmHUqN0eMGlBbeZK1rHxvRXfB7Ual9PORzyhuTO5kzIYK90EW1sT2qNl4TXA",
"servicos" : [
{
"codigo" : 701,
"descricao": "701 - INDENIZAÇÕES"
},
{
"codigo": 702,
"descricao" : "702 - INDENIZAÇÕES USO IMOVEIS"
}
]
}
]
- Valide o seu arquivo JSON em https://jsonlint.com/