Árvore de páginas

Versões comparadas

Chave

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

01. DADOS GERAIS

Produto:

TOTVS  TOTVS Saúde Planos

Linha de Produto:

Linha Datasul

Segmento:

Saúde

Módulo:HRC - Revisão de Contas Médicas
Função:

                  

RotinaFunção
Central de Mensagens de Auditoria PTUhrc.auditMenssagePtuauditMessagePtu
Central de Integrações Saúde Planoshgp.integrationsParams
Manutenção Associativa Processos x Anexoshcg.associativeProcessAttachments
Central de Movimentação Guias TISShrc.document

                  

País:Brasil
Requisito:

DSAUGPSCONTAS-26129

DSAUGPSCONTAS-26130

DSAUGPSCONTAS-26522

DSAUGPSCONTAS-26262


02. SITUAÇÃO/REQUISITO

Adequar os programas do TOTVS Saúde Planos - Linha Datasul para o PTU Online - SERVIÇOS DE CHAT DE AUDITORIA COBRANÇA.

    • Possibilitar o envio de mensagens para discussão e alinhamento do processo de cobrança.

Vigência: 30/04/2025

03. SOLUÇÃO

As alterações visam compatibilizar o TOTVS Saúde Planos - Linha Datasul para o PTU Online - SERVIÇOS DE CHAT DE AUDITORIA COBRANÇA.

...

Central de Mensagens de Auditoria PTU (hrc.auditMenssagePtu):


De acordo com o manual do PTU Online, as mensagens são agrupadas em discussões e cada discussão faz referência a uma guia de internação dentro de uma fatura.

A discussão, nesse sentido, é um agrupador de mensagens trocadas a respeito de uma guia.


  • Inclusão de Nova Discussão: Todos os dados solicitados são referentes a Guias de Internação referentes a um Arquivo XML PTU Cobrança.
    • Unidade origem da cobrança
    • Unidade destino da cobrança
    • Número do documento da cobrança
    • Lote do prestador
    • Número da guia TISS do prestador
    • Número da guia TISS da operadora
Informações
titleDados da Discussão

Todos os dados referentes a à Nova Discussão são Obrigatórios, com exceção do campo "


Image RemovedImage Added

Inclusão de Nova Mensagens de Auditoria vinculadas aos dados da Discussão:à Discussão:

Dentro de uma discussão será possível consultar as mensagens já enviadas e recebidas. Também será possível incluir uma nova mensagem.

Informações
titleDados da Nova Mensagem

Todos os dados referentes a à Nova Discussão Mensagem são Obrigatórios, com exceção do anexo.


Image RemovedImage Added



Ações:

  • Salvar e Enviar: Será salvo a nova mensagem de Status "Pendente" e : Os dados da discussão serão salvos. Se houver uma nova mensagem ela será gravada mas não será enviada para a Unimed Destino, ficando com status "Pendente" até que seja realizado o envio.
  • Salvar : Será salvo a nova mensagem mas a mensagem criada nao será enviadae Enviar: Os dados da discussão serão salvos. Se houver uma nova mensagem ela será criada com Status "Pendente" e, em seguida, será enviada para a Unimed Destino, ficando com status "Enviada" ou "Falha" dependendo do sucesso ou não do envio.
  • Cancelar:  Será desfeito as operações realizada As operações realizadas em tela serão desfeitas, retornando a à tela inicial.
  • Responder: Localizado na Grid de mensagem estará disponivel apenas quando a mensagem for de status "RECEBIDA", onde poderá ser respondida a mensagem recebida com o preenchimento automatico dos dados dos auditores.
  • Nova Mensagem: Criação de uma nova mensagem informando os dados solicitados.
    • Status das mensagens:
      • Pendente:  Mensagem ainda não enviada.
      • Enviada: Mensagem enviada com retorno de SUCESSO.
      • Recebida: Mensagem recebidas por outra Unimed.
      • Falha: Mensagem enviada com retorno de ERRO.
        • Visualizar erro: Botão localizado na lista de mensagens, coluna Ações,  onde pode ser visualizado o erro de comunicação com a UB.
      • Excluída: Mensagens removidas. 

        Informações
        titleDados da Nova Mensagem

        Apenas mensagens com Status de PENDENTE poderão ser EDITADAS ou REMOVIDAS.

Central de Integrações Saúde Planos (hgp.integrationsParams):

Criação das parametrizações utilizadas pelo Chat de Auditoria:

  • Usuário
  • Senha
  • Endpoint de Autenticação
  • Endpoint do serviço Chat de Auditoria Cobrança PTU
  • Endpoint de Validação do Token
  • Usuário de Validação do Token
  • Senha de Validação do Token

Image Removed

Criação do SPP "spp/sp-processo-audit-mensagens.p" para criação de novo processo de armazenamento dos Anexos.

      • Informações
        titleDados da Nova Mensagem

        Só é possível ter uma mensagem pendente de envio. Se já houver uma mensagem pendente, para incluir uma nova mensagem é necessário antes realizar o envio dessa mensagem pendente.

CENTRAL DE MOVIMENTAÇÃO GUIAS TISS

    • Adicionado nova funcionalidade ao botão "Outras ações" para que seja possivel acessar o Chat de Auditoria atraves do documento PTU importado.
      • Apenas em documentos de Internação esta opção estará disponivel.

Image Added

...


Totvs custom tabs box
tabsProcedimento para Implantação, Procedimento para Configuração
idspasso1,passo2
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
default
no
referenciapasso2
  1. Acesse o programa Importação Menu Datasul (men706aa) e importe o arquivo univdata/men_hrc.d para efetuar a atualização do menu do módulo HRC - Revisão de Contas Médicas.

  2. Parametrização do menu Central de Integrações Saúde Planos (hgp.integrationsParams) com os dados do Serviço de Chat de Auditoria Cobrança PTU.
    • Central de Integrações Saúde Planos (hgp.integrationsParams):

      • Usuário (usuário e senha do serviço de chat  fornecidos pela UB)
      • Senha (usuário e senha do serviço de chat  fornecidos pela UB)
      • Endpoint de Autenticação (endpoint disponibilizado pela UB para geração do Token)
      • Endpoint do serviço Chat de Auditoria Cobrança PTU (endpoint disponibilizado pela UB para comunicação das mensagens de auditoria)
      • Endpoint de Validação do Token (endpoint disponibilizado pela UB para autenticação reversa)
      • Usuário de Validação do Token (usuário e senha do serviço de autenticação reversa fornecidos pela UB)
      • Senha de Validação do Token (usuário e senha do serviço de autenticação reversa fornecidos pela UB)

        Image Added

  3. Executar o SPP spp/sp-processo-audit-mensagens.p para criação do processo de Anexo.

    ...

      1. Após a criação do processo pode ser alterado as configurações referentes aos anexos. Acesse Manutenção Associativa Processos x Anexos (hcg.associativeProcessAttachments).
        1. Tipo de Armazenamento: Escolhe entre 1 - Banco de Dados ou 2 - File  System.

          Image Added


          Informações
          titleDados do Processo de Anexo

          A opção "Compactar Arquivos" não deverá ser marcada pois já esta sendo trabalhado com um arquivo .ZIP.



    1. Endpoint do Serviço de Mensagem de Auditoria:

      Serviço

      Endpoint 

      Recebimento de Mensagem de Auditoriahttp://<servidor>:<porta>/totvs-hgp-ptu-integration/ptu/integracoes/auditoria-cobranca



    2. Certificado digital

      O Chat de Auditoria já faz a utilização do certificado digital conforme definido pela Unimed do Brasil. Para isso, deve-se parametrizar as seguintes propriedades na inicialização do Tomcat:

      • TOTVS_PTU_JKS_FILE: Deve apontar o caminho do arquivo JKS/PFX com o certificado que será utilizado.
      • TOTVS_PTU_JKS_PASS: Senha do arquivo JKS.



    Scripts de parâmetros opcionais

    Em ambiente de homologação, para fins de teste e depuração de problemas na recepção de mensagens, é possível desabilitar temporariamente a autenticação reversa. A autenticação reversa é um mecanismo de segurança que verifica a origem da mensagem, garantindo que ela foi enviada pela Unimed do Brasil.

    Impacto da Desabilitação:

    Ao desabilitar a autenticação reversa, o sistema aceitará mensagens de qualquer origem, permitindo, por exemplo, a simulação de mensagens de Chat de Auditores através de ferramentas como o Postman.


    Informações

    Não é recomendado desabilitar essa validação em ambiente de produção.

    Ao desabilitar essa validação, convém adicionar regras de firewall restringindo os endereços que poderão chamar o serviço de chat de auditores, evitando a recepção de mensagens por fontes que não sejam a Unimed do Brasil.

    Bloco de código
    firstline1
    titleDesabilitar validação do token
    linenumberstrue
    collapsetrue
    find first param-geral
               where param-geral.cod-indic-tab    = "PTU-INTEGRATIONS-PARAMS"
                 and param-geral.cod-param        = "bypassTokenAuth"
          exclusive-lock no-error.
          
          
    if not avail param-geral
    then do:
        create param-geral.
        assign param-geral.cod-indic-tab    = "PTU-INTEGRATIONS-PARAMS"
               param-geral.cod-param        = "bypassTokenAuth".
    
    end.
    
    
    assign param-geral.des-param = "true". //para reverter, basta alterar o parâmetro para "false"


    Templatedocumentos