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

...

  • Salvar: 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 e 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: As operações realizadas em tela serão desfeitas, retornando à 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.

        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.

...

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



  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.



        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.



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



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