Histórico da Página

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:

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.

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": 

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 integrar com o novo serviço, deve ser realizada a autenticação do prestador na própria mensagem, conforme previsto pelo manual da TISS:

Exemplo de preenchimento no XML:

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

  • Exemplo - formato MD5 de "totvs@123" gerado através do link https://www.md5hashgenerator.com/: 

    

Na aba Prestadores Associados deve haver o vínculo do prestador informado na tag "codigoPrestadorNaOperadora" com o papel de Serviço:

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