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


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/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
referencia
passo3
conf6


  • 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

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,Endpoints
idsfase1,fase2,fase3,fase4,fase5,fase6
referenciapasso3
Totvs custom tabs box items
defaultyes
referenciafase1
  • Solicitação de Autorização (TISS-13): Envia uma solicitação à operadora para autorizar a realização de um procedimento ou evento em saúde.
  • Solicitação de Cancelamento de Glosa (TISS-18): Solicita o cancelamento de uma glosa em um lote de guias enviado anteriormente.
  • Solicitação de Ressarcimento de Glosa (TISS-19): Solicita o ressarcimento de um valor glosado em um lote de guias enviado anteriormente.
  • Solicitação de Estorno de Glosa (TISS-20): Solicita o estorno de um valor glosado em um lote de guias enviado anteriormente.
          


http://seu-servidor:porta/
  • 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, uma lista das principais mensagens TISS existentes, agrupadas por Tipo de Serviço:

  • Protocolo de Recebimento de Lote de Guias (TISS-2): Confirmação da operadora de que recebeu o lote de guias enviado.
  • Situação de Lote de Guias (TISS-21): Consulta o status de um lote de guias enviado anteriormente.
  • Situação de Autorização (TISS-14): Consulta o status de uma solicitação de autorização enviada anteriormente.
  • Situação de Débito (TISS-17): Consulta o status de um débito gerado para o prestador.
    Totvs custom tabs box
    defaultno
    tabsSolicitação,Status,Consulta,Envio,Resumo,Endpoints
    idsfase1,fase2,fase3,fase4,fase5,fase6
    referenciapasso3
    fase2
    • Consulta de Beneficiário (TISS-12): Consulta dados básicos de um beneficiário, como nome, plano e cobertura.
    • Consulta de Procedimento (TISS-11): Busca por informações sobre um procedimento específico, como código, descrição e valor de referência.
    • Consulta de Órgão Emissor (TISS-10): Objęcie de dados sobre um determinado órgão emissor de guias, como CNPJ e razão social.
    • Consulta de Operadora (TISS-9): Obtenção de informações sobre uma operadora de plano de saúde, como nome, código ANS e endereços.
    • Consulta de Glosa (TISS-25): Consulta detalhes sobre uma glosa em um lote de guias.
    Totvs custom tabs box items
    defaultnoyes
    referenciafase3fase1


              Exemplo:
              Image Added


    • Envio de Lote de Guias (TISS-1): Envia um conjunto de guias TISS para a operadora para solicitação de reembolso.
    • Envio de Dados para a ANS (TISS-23): Transmite eletronicamente dados obrigatórios à ANS, como estatísticas de atendimento e produção de serviços.

    Estruturas Convertidas

    Prestador - Operadora
    Image Removed
  • Operadora - Prestador
    Image Removed
  •           

    fase6http:
    totvs-custom-tabs-box-totvs-custom-tabs-box-items
    defaultno
    referenciafase2fase4
    Totvs custom tabs box items
    defaultno
    referenciafase5
    Totvs custom tabs box items
    defaultno
    referencia



    • Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
      Solicitação
    Demonstrativo de RetornosolicitacaoDemonstrativoRetornosolicitacaoDemonstrativoRetorno ProtocolosolicitacaoStatusProtocolosolicitacaoStatusProtocolo
    Solicitação Status de Autorização
    solicitacaoStatusAutorizacao



    Exemplo:

    Image Added


    http:


    • Verifica Elegibilidade

    Totvs custom tabs box items
    defaultno
    referenciafase3


    solicitacaoStatusAutorizacaosolicitacaoStatusAutorizacao
    Solicitação Procedimento
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Verifica Elegibilidade

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

    solicitacaoProcedimentosolicitacaoProcedimentoSolicitação Status 


    • Recurso Glosa

    http://seu-servidor:porta/solicitacaoStatusRecursoGlosasolicitacaoStatusRecursoGlosahttp:
    Verifica Elegibilidade
    hgptissEnvio de Documentos
    totvs-
    custom-
    tabs-box-items
    defaultno
    referenciafase4


    • Lote de Guias

      Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01

      Lote Guias

    webservices-40100/api/pedidoElegibilidade40001pedidoElegibilidadeComunicação Beneficiário40100comunicacaoBeneficiario
    http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/comunicacaoBeneficiario

    loteGuias



  • Lote Anexo

    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01

    Lote Anexo

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

  • envioDocumentoshttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/envioDocumentosRecurso Glosa40100recursoGlosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/recursoGlosaLote AnexoloteAnexoloteAnexo

    Lote Guias

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

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


    Totvs custom tabs box items
    defaultno
    referenciafase5


    Estruturas Convertidas

    • Prestador - Operadora

      Image Added
    • 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 RemovedAutenticaçã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


    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



              

    :
    Image RemovedExemplo Mensagem TISS (Solicitação Status Protocolo):
    Image Removed


    03. ASSUNTOS RELACIONADOS


    Templatedocumentos