Histórico da Página

Com o novo serviço, a aplicação htzfoundation.ear (JBoss) passa a ser totvs-hgp-ptuonline.war (Tomcat), contendo somente os Webservices do PTU Online.

Para que a comunicação entre os serviços funcione corretamente, é necessário que o Tomcat onde é executado o serviço totvs-hgp-ptuonline.war reconheça as variáveis abaixo. A configuração pode ser feita diretamente nos scripts de inicialização do Tomcat (mais detalhes e exemplos aqui: Como criar variaveis de ambiente visiveis ao Datasul no Tomcat) ou mesmo diretamente como variáveis de ambiente do sistema operacional:

TOTVS_HOST: <host>:<porta> do serviço do Tomcat do Datasul. Ex: http://meu-datasul:8080

TOTVS_USERNAME: usuário de login que será utilizado para autenticação Basic no Datasul para execução dos serviços

TOTVS_PASSWORD: senha que será utilizada junto ao parâmetro acima

Obs: estas variáveis são utilizadas por outras aplicações, portanto é possível que já estejam configuradas no seu ambiente, e nesse caso, nenhuma ação é necessária, apenas a conferência.

O serviço oferece suporte a comunicação por meio de WebServices com segurança (certificado digital), exigidos pela Unimed do Brasil.

Inicialmente é necessário possuir um keystore (.jks)contendo somente o certificado digital disponibilizado pela Unimed do Brasil:

Após obter o keystore.jks conforme as orientações acima, o mesmo deve ser referenciado na inicialização do Tomcat, adicionando as tags Djavax.net.ssl.keyStore e Djavax.net.ssl.keyStorePassword na variável JAVA_OPTS. Somente atendendo a estas etapas será possível realizar as comunicações de envio e recebimento de transações com o WSD de intercâmbio.

Exemplo:"JAVA_OPTS=-Djavax.net.ssl.keyStore=<pasta>/keystore.jks -Djavax.net.ssl.keyStorePassword=<senha>"

Configurando no Linux

No Linux, adicionar as tags no arquivo de inicialização do serviço, normalmente em /etc/systemd/system/meu_servico.service

Exemplo:

Image Added

Configurando no Windows

No Windows, adicionar as tags através da tela de configurações ...\tomcat\bin\tomcat9w.exe

Obs: dependendo da forma com que o serviço foi criado, o arquivo tomcat9w.exe pode ter sido renomeado para o nome do seu serviço. Neste caso, basta usar o seu arquivo.exe

Neste exemplo, tomcat9w.exe foi renomeado durante a instalação:

Image Added

Ao executar o programa acima, será aberta esta tela. Basta adicionar as variáveis e reiniciar o Tomcat:

Image Added

Conferência das configurações

Após realizar as configurações acima, o Tomcat deve ser reiniciado, e as novas variáveis devem aparecer no início do log .../tomcat/logs/catalina.out, conforme o exemplo:

Image Added

Se as variáveis não aparecerem no log, revise as configurações antes de prosseguir.

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

Image Added

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): 
Image Added

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.

Image Added

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:

                Image Added

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

         Image Added

O novo serviço utiliza o conceito de Broker Escalável, onde é possível direcionar as chamadas ao Progress para um broker específico, isolando o back-end de outras aplicações, como o ERP por exemplo.

Toda comunicação encaminhada da aplicação totvs-hgp-ptuonline.war para o Progress enviará na requisição a chave "x-totvs-server-alias" como "totvs-saude-planos-ptuonline", sendo necessário que o cliente inclua através dos Parâmetros Foundation (btb962aa) um novo registro contendo esse alias.

Exemplo:
No programa BTB962AA (Parâmetros Foundation), criar um novo registro contendo o alias "totvs-saude-planos-ptuonline": 

Image Added

Na página Broker Escalável - Exemplo de como fazer uso do aplicativo e alias para chamadas REST é possível verificar maiores detalhes sobre essa configuração.

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:

          Image Added

• 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):

          Image Added