Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 6

changes.mady.by.user Ismael Silva Andrade

Gravado em

comparado com

Nova versão 44

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.

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

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

da Transação (0360)

Protocolo: 


Image Removed

Ao realizar uma consulta de Status

da Transação através da Consulta Status da Transação (hat0110p/hat.transactionStatusInquiry),

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.
Image Removed
00/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolo
Aviso

Assim como as URL's da Unimed do Brasil s  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"

    .

    jsonOperaçã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
    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
    referenciaconf3
    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

    Para os 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 no processo do PTU Online, deverão atentar-se para as orientações abaixo:na comunicação TISS.

    O que isso significa para você:

    • Processo de Utilização Usual: 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, 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


              Exemplo:
              Image Added


    Totvs custom tabs box items
    defaultno
    referenciafase2



    Os programas cpc-api-recebe-ptu91.p e cpc-atconstrans.p foram substituídos pelo cpc-bosau-recebe-ptu-online.p.

    Para funcionamento correto das rotinas no processo, é necessário criar o novo programa e migrar a lógica existente para ele.

    Foundation: cpc/cpc-api-recebe-ptu91.p                Tomcat: cpc/cpc-bosau-recebe-ptu-online.p

    Totvs custom tabs box items
    defaultno
    referenciafase3


    Aviso

                       

    cpc/cpc-api-recebe-ptu91.i  cpc/cpc-bosau-recebe-ptu-online.icpc/cpc-atconstrans.p


    Totvs custom tabs box items
    defaultno
    referenciafase4


    cpc/cpc-atconstrans.i


    Totvs custom tabs box items
    defaultno
    referenciafase5


    Estruturas Convertidas

    • Prestador - Operadora

      Image Added
    • Operadora - Prestador
      Image Added

              

    • A nova nomenclatura não contém o número da versão do PTU, não sendo mais necessário criar um novo programa a cada atualização
    • Os nomes dos pontos de chamada foram mantidos os mesmos. Ex: "ORDEM-SERVICO", "ALTERA-PREST"
    • O novo programa deve conter somente 2 parâmetros: a tabela de entrada e a de saída:

              Image Removed

    • Para migração da lógica da CPC, deve ser considerada a nova nomenclatura das temp-tables do programa (todos os campos anteriormente existentes foram mantidos):

              Image Removed


    Totvs custom tabs box items
    defaultno
    referencia
    passo3
    fase6
    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



              

    Não houve alteração no processo de utilização das funcionalidades que envolvem o PTU Online. Todas as regras de negócio e operações em tela foram mantidas.

    Exemplo: Ao solicitar uma guia de intercâmbio pelo AT0110Z, o processo de inclusão/comunicação percebido pelo usuário será o mesmo, com a diferença que o sistema estará direcionando a chamada para a Unimed do Brasil através do novo serviço e não mais pelo Foundation.


    03. ASSUNTOS RELACIONADOS

    ...