Histórico da Página

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:

Rotina	Função
Central de Mensagens de Auditoria PTU	hrc.auditMessagePtu
Central de Integrações Saúde Planos	hgp.integrationsParams
Manutenção Associativa Processos x Anexos	hcg.associativeProcessAttachments
Central de Movimentação Guias TISS	hrc.auditMenssagePtudocument

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
- Número do documento 2 da cobrança
- Lote do prestador
- Número da guia TISS do prestador
- Número da guia TISS da operadora

Informações

title	Dados da Discussão

Todos os dados referentes a à Nova Discussão são Obrigatórios, com exceção do campo "Número do documento 2 da cobrança".

Image RemovedImage Added

Inclusão de Nova Mensagens de Auditoria vinculadas aos dados da Discusã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

title	Dados da Nova Mensagem

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

Image AddedImage Removed

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.

Observação:

Informações

title	Dados da Nova Mensagem

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

Informações

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

tabs	Procedimento para Implantação, Procedimento para Configuração, Novas mudanças
ids	passo1,passo2,passo3

Totvs custom tabs box items

default	yes
referencia	passo1

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

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.
No TOTVS12, acesse o programa Manutenção Layout (hte.layout), por meio da opção Importar, realize a importação do arquivo database\dados\tablas.d para efetuar a inclusão dos novos layouts.

Image Removed

3. Programas de layout que serão criados:

Guias de Cobrança ou Utilização

- - LAPTU-COBRANCA-UTILIZACAO-E030→ Exportação de Guias de Aviso, Cobrança ou Utilização
  - LAPTU-COBRANCA-UTILIZACAO-I030→ Importação de Guias de Aviso, Cobrança ou Utilização

Exportação/Importação A550

- - LAPTUA550E-030 → Exportação Questionamentos da Câmara de Contestação (A550)
  - LAPTUA550I-030 → Importação Questionamentos da Câmara de Contestação (A550)

Exportação A560

- - LAPTUA560E-030 → Exportação Nota de Débito - NDC (A560)

4. No TOTVS12, acesse o programa Manutenção Layout Exportação/Importação Revisão Contas (hrc.layoutExportImport/RC0510J) e cadastre os novos layouts de Exportação e Importação.

5. No TOTVS12, acesse o programa Manutenção Parâmetros Exportação Contratante (hrc.guarantorExportParameters/RC0510K) e cadastre o novo layout de Exportação.

6. No TOTVS12, acesse o programa Manutenção Parâmetros Importação Prestador (hrc.providerImportParameter/RC0510L) e cadastre o novo layout de Importação.

7. No TOTVS12, acesse o programa Manutenção de Parâmetros do Revisão de Contas (hrc.paramrc) e cadastre os diretórios de exportação, carga e acompanhamento do novo layout.

Totvs custom tabs box items

default	no
referencia	passo3

Alterações na Manutenção de Parâmetros do Revisão de Contas - hrc.paramrc:

Foram removidas as opções "A500 - TXT" e "A520", pois não serão mais utilizados.
Foram alterada a seção "A500 - XML" para criar as seções "PTU Cobrança, Aviso e Utilização"
- Image Removed
Foram adicionados os novos campos de diretório para guias de utilização
- Image Removed

04. DEMAIS INFORMAÇÕES

...

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
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
    title Dados do Processo de Anexo
    A opção "Compactar Arquivos" não deverá ser marcada pois já esta sendo trabalhado com um arquivo .ZIP.
Endpoint do Serviço de Mensagem de Auditoria:
Serviço
Endpoint
Recebimento de Mensagem de Auditoria http://<servidor>:<porta>/totvs-hgp-ptu-integration/ptu/integracoes/auditoria-cobranca
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

firstline	1
title	Desabilitar validação do token
linenumbers	true
collapse	true

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

Árvore de páginas

Versões comparadas

Versão antiga 5

Nova versão Atual

Chave

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO

04. DEMAIS INFORMAÇÕES