01. DADOS GERAIS

Produto:

TOTVS Saúde Planos

Linha de Produto:

Datasul

Segmento:

Saúde

Módulo:

HRC - Revisão de Contas Médicas

Função:

Webservices TISS 4.03.00 - TOMCAT

País:Brasil
Requisito:

DSAUGPSAUTOR-21916

02. SITUAÇÃO/REQUISITO

As implementações apresentadas neste documento correspondem as adequações efetuadas no TOTVS Saúde Planos - Linha Datasul devido as seguintes alterações promovidas no manual da TISS 4.03.00.

Com o objetivo de dar continuidade à estratégia de evolução tecnológica dos produtos da linha Datasul, é necessário disponibilizar um novo serviço para os Webservices TISS, eliminando a dependência do Foundation Saúde.

O objetivo deste documento é apresentar os detalhes do novo serviço para os Webservices TISS 4.03.00 - Tomcat, criado para a substituir o atualmente em uso no JBoss.

03. SOLUÇÃO

Foi realizada a implementação das funcionalidades destacadas abaixo, dando origem ao novo serviço para os Webservices TISS.


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:

Versão TISSArtefato
4.03.00totvs-hgp-tiss-webservices-40300.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.


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:

As variáveis precisam aparecer nesta consulta antes de prosseguir para a próxima etapa. Caso contrário ocorrerão problemas de comunicação.

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


A configuração de um broker dedicado ao Webservices TISS, descrita nesta seção, é de extrema importância para o escalonamento das requisições realizadas ao backend, impedindo que o Webservices TISS consuma o mesmo PASOE definido para o Totvs Planos - Linha Datasul. Este escalonamento permite também o melhor gerenciamento dos arquivos de log da camada Progress.

Caso o cliente opte por não realizar a configuração descrita nesta seção, as requisições ao backend serão compartilhadas com o ERP padrão.

Para maiores informações sobre a arquitetura de broker escalável, consultar os links abaixo: 

TOTVS Broker Escalável

Criando uma instância PASOE através do OpenEdge Explorer

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


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:

Não houve alteração no processo de utilização das funcionalidades que envolvem os Webservices TISS. Todas as regras de negócio (incluindo CPC's) foram mantidas.

O que irá diferenciar os serviços será o endpoint com que o prestador realizará a integração de cada mensagem, conforme destacado a seguir:


  • Solicitação Demonstrativo de Retorno: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/solicitacaoDemonstrativoRetorno
  • Solicitação Status Protocolo: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/solicitacaoStatusProtocolo
  • Envio de Documentos: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/envioDocumentos
  • Cancela Guia: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/cancelaGuia
  • Verifica Elegibilidade: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/pedidoElegibilidade
  • Comunicação Beneficiário: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/comunicacaoBeneficiario
  • Solicitação Status de Autorização: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/solicitacaoStatusAutorizacao
  • Solicitação Status Recurso Glosa: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/solicitacaoStatusRecursoGlosa
  • Recurso Glosa: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/recursoGlosa
  • Solicitação Procedimento: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/solicitacaoProcedimento
  • Lote Anexo: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/loteAnexo
  • Lote Guias: http://<servidor>:<porta>/totvs-hgp-tiss-webservices-40300/api/loteGuias

É necessário substituir o <servidor> e <porta> conforme seu ambiente.


Para validar se um endpoint está no ar, pode ser acessado o endereço via navegador, acrescido de ".wsdl".



04. ASSUNTOS RELACIONADOS

Como adicionar um novo connector no Tomcat sem duplicar a instancia inteira

DT TISS 4.03.00