Histórico da Página

Com o novo serviço, o PTU Online deixa de ser executado em uma infraestrutura separada (JBoss) e passa a ser um serviço do próprio ERP, rodando no mesmo servidor (Tomcat) do sistema.

Para que a comunicação com o Progress funcione corretamente, é necessário que as variáveis TOTVS_HOST, TOTVS_USERNAME e TOTVS_PASSWORD estejam configuradas no servidor, podendo ser via parâmetros de inicialização do Tomcat (como serviço do Windows/Linux ou arquivo de configuração) ou variáveis de ambiente no servidor em que o Tomcat é inicializado.

Esse padrão é utilizado por outras aplicações e é possível que já estejam disponíveis em seu ambiente, e nesse caso, nenhuma ação é necessária.

Na página Configurar servidor de aplicação TOMCAT é possível verificar um exemplo de configuração.

Na Central de Integrações Saúde Planos (hgp.integrationsParams) foi criado o novo menu PTU Online, contendo as parametrizações do serviço:

Comunicação

• A URL do serviço deve ser o servidor + porta onde a aplicação está rodando:
  • Ex: http://servidor1:8080
  • Apesar de ser um serviço do próprio ERP, este parâmetro é necessário para que aplicações externas consigam acessar. Ex: Autorizador Web realizando a comunicação de uma guia de intercâmbio.
• Nesse momento de funcionamento híbrido, a versão do PTU Online continua sendo definida na Manutenção Parâmetros Globais Sistema (hpr1410p/hcg.globalParameters). Quando ocorrer a descontinuação definitiva do módulo Foundation Saúde, o parâmetro será migrado para essa tela.

Endpoints

• Quando o campo relacionado ao endpoint estiver preenchido, o sistema realizará a comunicação através do novo serviço, via Tomcat.
• Quando o campo relacionado ao endpoint estiver vazio, o sistema realizará a comunicação através do Foundation, via JBoss. 

Exemplo:
Editando e preenchendo o campo do endpoint da mensagem de Status da Transação (0360): 

Ao realizar uma consulta de Status da Transação através da Consulta Status da Transação (hat0110p/hat.transactionStatusInquiry), a comunicação será realizada através do novo serviço e não mais pelo Foundation.

Log Auxiliar

• Habilita/desabilita a geração de arquivos auxiliares  contendo os dados de entrada e saída das comunicações realizadas no PTU Online, úteis para ambientes de homologação e validação de informações.
• Os arquivos serão gerados seguindo a nomenclatura: "Operação" + "Código da transação" + "Descrição da transação" + "Data" + "Hora".json
  • Operação poderá ser: Envio, Resposta, Recebimento ou Resposta de Recebimento
  • Exemplo de arquivos gerados:

• Quando habiitado é necessário informar um diretório válido para exportação, normalmente um diretório de rede que o AppServer/PASOE do sistema consiga acessar.
• Quando desabilitado nenhum arquivo será exportado.

• Broker Escalável - Exemplo de como fazer uso do aplicativo e alias para chamadas REST

Exemplo de configuração do Broker Escalável para o PTU Online:
No programa BTB962AA (Parâmetros Foundation) criar o registro "totvs-saude-planos-ptuonline", o servidor pode ser apontado para o mesmo das demais aplicações ou outro para ficar isolado. 

Para os clientes que utilizam programas de CPC no processo do PTU Online, deverão atentar-se para as orientações abaixo:

• A nova nomenclatura não contém o número da versão do PTU, não sendo mais necessário criar um novo programa a cada atualização
• Os nomes dos pontos de chamada foram mantidos os mesmos. Ex: "ORDEM-SERVICO", "ALTERA-PREST"
• O novo programa deve conter somente 2 parâmetros: a tabela de entrada e a de saída:

• Para migração da lógica da CPC, deve ser considerada a nova nomenclatura das temp-tables do programa (todos os campos anteriormente existentes foram mantidos):