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.02.00 - TOMCAT

País:Brasil
Requisito:

DSAUGPSCONTAS-27609

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.02.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.02.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.02.00totvs-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.


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


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

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


Exemplo comparativo de endpoints da TISS 4.02.00:

Mensagem TISSEndpoint Foundation Saúde (JBoss)Endpoint Tomcat
Solicitação Demonstrativo de Retornohttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoDemonstrativoRetornoV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/solicitacaoDemonstrativoRetorno
Solicitação Status Protocolohttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoStatusProtocoloV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/solicitacaoStatusProtocolo
Solicitação Status de Autorizaçãohttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoStatusAutorizacaoV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/solicitacaoStatusAutorizacao
Solicitação Procedimentohttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoProcedimentoV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/solicitacaoProcedimento
Solicitação Status  Recurso Glosahttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoStatusRecursoGlosaV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/solicitacaoStatusRecursoGlosa
Cancela Guiahttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSCancelaGuiaV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/cancelaGuia
Verifica Elegibilidadehttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSVerificaElegibilidadeV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/pedidoElegibilidade
Comunicação Beneficiáriohttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSComunicacaoBeneficiarioV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/comunicacaoBeneficiario
Envio de Documentoshttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSEnvioDocumentosV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/envioDocumentos
Recurso Glosahttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSRecursoGlosaV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/recursoGlosa

Lote Anexo

http://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSLoteAnexoV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/loteAnexo

Lote Guias

http://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSLoteGuiasV_4_02_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40200/api/loteGuias


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


Um prestador pode consumir ambos serviços simultaneamente .

Exemplo: Para Solicitação de Procedimentos, integrar com o endpoint Foudation Saúde e para o Cancelamento de Guia, integrar com o endpoint Tomcat.

Essa abordagem permite à Operadora realizar a homologação/migração de forma parcial, por prestador e por mensagem.


04. ASSUNTOS RELACIONADOS

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

DT TISS 4.02.00