| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo2 |
|---|
|
| Totvs custom tabs box |
|---|
|
| tabs | Servidor de Aplicação,Broker Escalável,Autenticação |
|---|
| ids | conf1,conf2,conf3 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | conf1 |
|---|
|
Com o novo serviço, a aplicação htzfoundation.ear (JBoss) passa a ser dividida em um artefato distinto no Tomcat, contendo somente os Webservices TISS conforme a versão:
| Informações |
|---|
| Versão TISS | Artefato |
|---|
| 4.02.00 | totvs-hgp-tiss-webservices-40200.war |
Para que a comunicação funcione corretamente, é necessário que o Tomcat onde é executado o serviço totvs-hgp-tiss-webservices-40200.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.
| Informações |
|---|
| title | Dica para validar esta etapa |
|---|
|
Após configurar as variáveis de ambiente e reiniciar o Tomcat, utilize a URL abaixo para validar se o ambiente as reconheceu corretamente: http://<SERVIDOR>:<PORTA>/totvs-hgp-webservices/ptu/v8/integrations/gateway/serverInfo O resultado deve ser semelhante a isto:  Image Removed
As variáveis precisam aparecer nesta consulta antes de prosseguir para a próxima etapa. Caso contrário ocorrerão problemas de comunicação. |
| Totvs custom tabs box items |
|---|
|
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-tiss-webservices-40200.war para o Progress enviará na requisição a chave "x-totvs-server-alias" como "totvs-saude-planos-tiss-webservices", sendo necessário que o cliente inclua através do Empresas do Foundation (html.companies) um novo registro contendo esse alias.
Exemplo:
No programa html.companies (Empresas do Foundation), criar um novo registro nos Cadastros relacionados → Servidores de aplicação, contendo o alias "totvs-saude-planos-tiss-webservices":
Image Removed
| Aviso |
|---|
Caso o cliente deseje isolar a parte Progress dos Webservices TISS em um broker separado, deve ser criada uma nova instância do PASOE, referenciando-a através do campo "Servidor Aplicação". Para maiores detalhes sobre a criação da instância no PASOE, ver a documentação: Criando uma instância PASOE através do OpenEdge Explorer Caso o cliente não deseje fazer essa separação, basta criar o registro com o alias "totvs-saude-planos-tiss-webservices" referenciando para o mesmo "Servidor Aplicação" existente. |
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.
| Totvs custom tabs box items |
|---|
|
Para integrar com o novo serviço, deve ser realizada a autenticação do prestador na própria mensagem, conforme previsto pelo manual da TISS:
Image Removed
Exemplo de preenchimento no XML:
Image Removed
A habilitação do prestador ocorre através do cadastro Manutenção de Usuários Portal do Prestador (hat.secretary).
- O campo loginPrestador a ser informado no XML será o Usuário informado nesse cadastro
- O campo senhaPrestador a ser informado no XML será a Senha informada nesse cadastro, em formato MD5
Na aba Prestadores Associados deve haver o vínculo do prestador informado na tag "codigoPrestadorNaOperadora" com o papel de Serviço:
Image Removed
Caso o papel esteja como Padrão, o Status como Inativo, o vínculo com o prestador não exista ou a senha não corresponda, o usuário não terá permissão para integrar com o serviço, sendo retornada a mensagem:
- Falha na autenticação. Usuário ou senha incorretos ou o usuário informado não tem permissão para utilizar esse serviço nesse prestador e/ou versão da TISS
Image RemovedAQUI
