Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 34

changes.mady.by.user Ismael Silva Andrade

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Luis Otavio de Oliveira Rodrigues

Gravado em

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.

Solicitação Status de Autorizaçã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).

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

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.


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.


Versão TISSExemplo
4.01.00/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolo
Aviso

Assim como as URL's  devem ser preenchidas para 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
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


Solicitação Status Protocolo
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:

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 Demonstrativo de Retorno

    Mensagem TISSEndpoint TISS 4.
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

Solicitação Demonstrativo de Retorno

Solicitação Procedimento

          Exemplo:
          Image Removed

Solicitação Status Recurso Glosa

Totvs custom tabs box items
defaultyes
referenciafase1
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

Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
Solicitação Procedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoProcedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoProcedimento
Totvs custom tabs box items
defaultno
referenciafase2

  • Solicitação Status Protocolo

Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
Solicitação Status Protocolohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusProtocolo
Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
Solicitação Status  Recurso GlosaDemonstrativo de Retornohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusRecursoGlosasolicitacaoDemonstrativoRetorno

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

solicitacaoStatusRecursoGlosa

solicitacaoDemonstrativoRetorno



  • Solicitação Status de AutorizaçãoProcedimento

    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Solicitação Status de AutorizaçãoProcedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusAutorizacaosolicitacaoProcedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusAutorizacaosolicitacaoProcedimento



    •           Exemplo:

    Image Removed

              Image Added


    Totvs custom tabs box items
    defaultno
    referenciafase3fase2



    Totvs custom tabs box items
    defaultno
    referenciafase3


    Totvs custom tabs box items
    defaultno
    referenciafase4


    Estruturas Convertidas

    Prestador - Operadora
    Image Removed
  • Operadora - Prestador
    Image Removed

    •           

    Solicitação Demonstrativo de Retorno
    Totvs custom tabs box items
    defaultno
    referenciafase5
    Totvs custom tabs box items
    defaultno
    referenciafase6
    fase4


    • Lote de Guias

      Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01

      Lote Guias

    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01

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

    solicitacaoDemonstrativoRetorno

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

    loteGuias                                                                 

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

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

    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/

    • solicitacaoStatusAutorizacao

    • loteAnexo                                                              

      		http://seu-
    http://seu-solicitacaoStatusAutorizacaoSolicitação ProcedimentosolicitacaoProcedimento


    Totvs custom tabs box items
    defaultno
    referenciafase5


    Estruturas Convertidas

    • Prestador - Operadora

      Image Added
    • Operadora - Prestador
      Image Added

              


    Totvs custom tabs box items
    defaultno
    referenciafase6
    solicitacaoProcedimento
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Solicitação Demonstrativo de Retornohttp
    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-4000140100/api/cancelaGuiaVerifica ElegibilidadesolicitacaoDemonstrativoRetorno

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

    Solicitação Status Protocolohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-4000140100/api/pedidoElegibilidadeComunicação BeneficiáriosolicitacaoStatusProtocolohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-4010040001/api/comunicacaoBeneficiariosolicitacaoStatusProtocolo
    Solicitação Status de Autorizaçãohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusAutorizacaohttphttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/comunicacaoBeneficiariosolicitacaoStatusAutorizacao
    Solicitação ProcedimentoEnvio de Documentoshttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/envioDocumentossolicitacaoProcedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/envioDocumentossolicitacaoProcedimento
    Solicitação Status  Recurso Glosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/recursoGlosasolicitacaoStatusRecursoGlosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/recursoGlosasolicitacaoStatusRecursoGlosa
    Lote AnexoCancela Guiahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/loteAnexocancelaGuiahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/loteAnexocancelaGuia
    Lote GuiasVerifica Elegibilidade

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

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

              

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



              

    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 RemovedExemplo Mensagem TISS (Solicitação Status Protocolo):
    Image Removed


    03. ASSUNTOS RELACIONADOS


    Templatedocumentos