Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 14

changes.mady.by.user Nick Kullmann dos Santos Buttner

Gravado em

comparado com

Nova versão 15

changes.mady.by.user Juliana Mareco Medeiros

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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.

...

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.

...

Totvs custom tabs box
tabsProcedimento para Configuração,Procedimento para Utilização
idspasso2,passo3
Totvs custom tabs box items
defaultyes
referenciapasso2
Totvs custom tabs box
tabsServidor de Aplicação,Broker Escalável,Autenticação
idsconf1,conf2,conf3
Totvs custom tabs box items
defaultyes
referenciaconf1

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


Informações
titleDica 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:

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
defaultno
referenciaconf2

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


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
defaultno
referenciaconf3

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:

Totvs custom tabs box items
defaultno
referenciapasso3

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:


Aviso
  • 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".


Informações
titleDica

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

...