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

Totvs custom tabs box items
defaultno
referenciapasso2
Totvs custom tabs box
tabsServidor de Aplicação,Tela de Parâmetros,Broker Escalável,CPC's,Autenticação
idsconf1,conf2,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, 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
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.

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


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


                


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-tiss-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-hgp-webservices", 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-hgp-webservices": 



Aviso

Caso o cliente deseje isolar a parte Progress 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-hgp-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
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,Resumo,OutrosEndpoints
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
  • 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.Operadora - Prestador
    Image Added

          

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 Removed
  • Autenticação de usuário e senha no formato MD5
    Exemplo:
    Image Removed
  • Regra de Negócio do Sistema
    No menu Manut. Usuários Portal Prestador (hat.secretary):
    Image Removed 
    Deve existir um registro do usuário e na aba de Cadastro conter as informações de Login e Senha :
    Image Removed
    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 Removed

    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 Removed


    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



              


    03. ASSUNTOS RELACIONADOS


    Templatedocumentos