Árvore de páginas

Versões comparadas

Chave

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

...

Aviso

A versão mínima para utilização do serviço é a 12.1.2407, com liberação no patch de 15da release no dia 01/07/2024 para as versões 12.1.2403-7 e 12.1.2311-12.

É possível utilizar o serviço de forma híbrida com o Foundation Saúde, realizando a migração parcialmente, conforme detalhado na aba Procedimento para Configuração.

Totvs custom tabs box
tabsProcedimento para Implantação,Procedimento para Configuração,Procedimento para Utilização
idspasso1,passo2,passo3
Totvs custom tabs box items
defaultyes
referenciapasso1

A implementação descrita no documento estará disponível a partir da atualização do pacote no cliente.

O pacote está disponível no portal (https://suporte.totvs.com/download)

1. Acesse o menu 

.

Totvs custom tabs box items
defaultno
referenciapasso2
Totvs custom tabs box
tabsServidor de Aplicação,Tela de Parâmetros,Certificado Digital,Broker Escalável,CPC's,Autenticação
idsconf1,conf2,conf3,conf4,conf5,conf6
Totvs custom tabs box items
defaultyes
referenciaconf1

A comunicação TISS agora se integra ao ERP, eliminando a necessidade de uma infraestrutura separada (JBoss). Com essa mudança, a gestão do serviço é otimizada.

Aviso

A aplicação htzfoundation.ear

passa a ser

, que anteriormente integrava os Webservices da TISS, agora está dividida em duas estruturas distintas a partir da versão TISS:

Versão TISSWAR
4.01.00totvs-java-hgp-tiss-webservices-40100.war
, contendo somente os Webservices da TISS.
4.00.01totvs-java-hgp-tiss-webservices-40001.war


Para que a comunicação com o Progress funcione corretamente, é necessário que as variáveis TOTVS_HOST, TOTVS_USERNAME e TOTVS_PASSWORD estejam configuradas no servidor, podendo ser via parâmetros de inicialização do Tomcat (como serviço do Windows/Linux ou arquivo de configuração) ou variáveis de ambiente no servidor em que o Tomcat é inicializado.

Esse padrão é utilizado por outras aplicações e é possível que já estejam disponíveis em seu ambiente, e nesse caso, nenhuma ação é necessária.

Na página Configurar servidor de aplicação TOMCAT é possível verificar um exemplo de configuração.


Exemplo:
Editando e preenchendo o campo do endpoint da mensagem de Solicitação Status Protocolo

Ao realizar uma consulta de Status Protocolo a comunicação será realizada através do novo serviço e não mais pelo Foundation.


Totvs custom tabs box items
defaultno
referenciaconf2

Comunicação

Endpoints

  • Quando o campo relacionado ao endpoint apontar para o novo serviço, o sistema realizará a comunicação via Tomcat.
warning

As URL's a serem informadas são as fornecidas pela Unimed do Brasil para comunicação com o WSD referente à cada mensagem.

Versão TISSExemplo
4.01.00/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolo4.00.01/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusProtocolo
Aviso

Assim como as URL's da Unimed do Brasil devem ser preenchidas nessa tela, é necessário atualizar os endpoints do serviço na Unimed do Brasil para que o WSD comunique com cada mensagem, sendo elas:

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

Log Auxiliar

  • Habilita/desabilita a geração de arquivos auxiliares  contendo os dados de entrada e saída das comunicações realizadas no PTU Online, úteis para ambientes de homologação e validação de informações.
  • Os arquivos serão gerados seguindo a nomenclatura: "Operação" + "Código da transação" + "Descrição da transação" + "Data" + "Hora".json
    • Operação poderá ser: Envio, Resposta, Recebimento ou Resposta de Recebimento
    • Exemplo de arquivos gerados:


                Image Removed

  • Quando habiitado é necessário informar um diretório válido para exportação, normalmente um diretório de rede que o PASOE consiga acessar.
  • Quando desabilitado nenhum arquivo será exportado.

         Image Removed

Aviso

Essa funcionalidade é similar à pasta "xmlwslog" que existia no servidor do Foundation, com a diferença que os arquivos serão gerados em formato JSON e não mais XML. Para verificar os XMLs que trafegaram de fato pelo WSD da Unimed do Brasil, pode ser utilizada a consulta de fases da transação pela Interface Única.

Totvs custom tabs box items
defaultno
referenciaconf3

O processo de certificação digital segue o padrão de conectores https no Tomcat e é similar à configuração anteriormente existente no JBoss. Na página SSL/TLS Configuration How-To é possível verificar a documentação da Apache a respeito desse processo.

É necessário habilitar o conector https no arquivo server.xml do servidor, referenciando a um keystoreFile que tenha importado o certificado digital disponibilizado pela Unimed do Brasil. Também é necessário importar esse certificado para o Java utilizado na inicialização do Tomcat. Dessa forma será possível realizar as comunicações de envio e recebimento de transações com o WSD de intercâmbio.

Exemplo:

Image Removed

Na página Configuração de HTTPS para o Datasul for THF é possível verificar maiores detalhes sobre essa configuração.  


Totvs custom tabs box items
defaultno
referenciaconf4

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-java-hgp-ptuonlinetiss-webservices-40100.war ou totvs-java-hgp-tiss-webservices-40001.war para o Progress enviará na requisição a chave "x-totvs-server-alias" como "totvs-saudehgp-planos-ptuonlinewebservices", sendo necessário que o cliente inclua através dos Parâmetros Foundation (btb962aa) um novo registro contendo esse alias.


Exemplo:
No programa BTB962AA (Parâmetros Foundation), criar um novo registro contendo o alias "totvs-saudehgp-planos-ptuonlinewebservices": 

Image Added


Image AddedImage Removed


Aviso

Caso o cliente deseje isolar a parte Progress do PTU Online da Comunicação 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-saudehgp-planos-ptuonlinewebservices" 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
referenciaconf5

Gostaríamos de informar que a recente migração para o novo serviço TISS ao TOMCAT não afetou o uso das funcionalidades para clientes que utilizam programas de CPC na comunicação TISS.

O que isso significa para você:

  • Processo de Utilização FamiliarUsual: As regras de negócio e operações em tela do TISS permanecem inalteradas, garantindo uma experiência familiar e intuitiva.
  • Funcionalidades Acessíveis: Todas as funcionalidades do TISS que você já conhece e utiliza continuam disponíveis, sem necessidade de adaptação.
  • Comunicação TISS: O processo de comunicação TISS via CPC permanece inalterado, sem interrupções ou modificações.

          


Totvs custom tabs box items
defaultno
referenciaconf6


  • Autenticação de Usuário na mensagem TISS
    O padrão TISS já prevê uma segurança via usuário e senha, essas informações agora passam a ser validadas conforme as regras de negócio do sistema.

    Segue abaixo a imagem das tags:
    Image Added
  • Autenticação de usuário e senha no formato MD5
    Exemplo:
    Image Added



  1. Regra de Negócio do Sistema
    No menu Manut. Usuários Portal Prestador (hat.secretary):
    Image Added 
    1. Deve existir um registro do usuário e na aba de Cadastro conter as informações de Login e Senha :
      Image Added


      Aviso

      Ao preencher o campo Senha a senha é criptografada, para manter a segurança da privacidade da senha o campo na mensagem TISS é preenchido no formato MD5.

      Exemplo: 

      Image Added

    2. Na aba Prestadores Associados deve haver um registro do prestador da mensagem com os devidos parâmetros:
      O campo "Papel" deve ser preenchido como Serviço/Prestador caso esteja como Padrão o usuário não terá permissão para realizar a comunicação TISS.
      O campo "Status" deve estar Ativo.

      Exemplo:
      Image Added

  • Exemplo Mensagem TISS (Solicitação Status Protocolo):
    Image Added


Totvs custom tabs box items
defaultno
referenciapasso3

O Padrão TISS define um conjunto abrangente de mensagens eletrônicas para viabilizar a troca de informações entre operadoras de planos de saúde, prestadores de serviços de saúde e a ANS. Cada mensagem possui uma função específica dentro do fluxo de comunicação, otimizando e padronizando os processos.

Para facilitar a consulta, compilei uma lista das principais mensagens TISS existentes, agrupadas por Tipo de Serviço:

Totvs custom tabs box
defaultno
tabsSolicitação,Status,Consulta,Envio,OutrosResumo,Endpoints
idsfase1,fase2,fase3,fase4,fase5,fase6
referenciapasso3
Totvs custom tabs box items
defaultyes
referenciafase1


          Exemplo:
          Image Added


Totvs custom tabs box items
defaultno
referenciafase2



Totvs custom tabs box items
defaultno
referenciafase3



Totvs custom tabs box items
defaultno
referenciafase4



Totvs custom tabs box items
defaultno
referenciafase5


Estruturas Convertidas

  • Prestador - Operadora

    Image Added
  • Operadora - Prestador
    Image Added

          


Totvs custom tabs box items
defaultno
referenciafase6
Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
Solicitação Demonstrativo de Retornohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoDemonstrativoRetorno

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoDemonstrativoRetorno

Solicitação Status Protocolohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusProtocolo
Solicitação Status de Autorizaçãohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusAutorizacaohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusAutorizacao
Solicitação Procedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoProcedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoProcedimento
Solicitação Status  Recurso Glosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusRecursoGlosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusRecursoGlosa
Cancela Guiahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/cancelaGuiahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/cancelaGuia
Verifica Elegibilidade

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/pedidoElegibilidade

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/pedidoElegibilidade
Comunicação Beneficiário

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/comunicacaoBeneficiario

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/comunicacaoBeneficiario
Envio de Documentos

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/envioDocumentos

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/envioDocumentos
Recurso Glosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/recursoGlosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/recursoGlosa

Lote Anexo

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/loteAnexo

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/loteAnexo

Lote Guias

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/loteGuias

http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/loteGuias

  • Controle de Erros (TISS-8): Troca de mensagens para identificar e corrigir erros na comunicação entre o prestador e a operadora.
  • Mensagem de Teste (TISS-7): Envio de mensagem para testar a comunicação entre o prestador e a operadora.
  • Mensagem de Cancelamento (TISS-6): Cancela uma mensagem enviada anteriormente.



              


    03. ASSUNTOS RELACIONADOS


    Templatedocumentos