PTU Batch 10.0 - A520

Características do Requisito

Descrição

As implementações descritas neste documento correspondem às adequações efetuadas no Gestão de Planos para atender ao PTU 10.0, referente ao layout A520 - Envio de Aviso de Cobrança. 

Procedimento para Implantação

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

Pré-Requisitos

Para utilização do compartilhamento de risco são necessários alguns pré-requisitos:

• Utilização do Menu HTML no Totvs 12
• Configuração de Servidor RPW
• Configuração da Central de Documentos.

Instalação do Pacote e configuração do HTML

A instalação do pacote de retrofit deve seguir os seguintes passos:

1. Copiar por cima do EAR atual, instalado no diretório <instalação_do_JBoss>/server/<instancia>/deploy, o EAR correspondente à versão datasul-byyou-12.1.18-SNAPSHOT.ear ou datasul-byyou-12.1.19-SNAPSHOT.ear ou datasul-byyou-12.1.20-SNAPSHOT.ear ou datasul-byyou-12.1.21-SNAPSHOT.ear;
2. Copiar por cima da pasta datasul-rest, contida no diretório <instalação_do_JBoss>/server/<instancia>;
3. Editar o arquivo rest.properties localizado no diretorio <instalação_do_JBoss>/server/<instancia>/datasul-rest, acrescentando as linhas abaixo:
   fch.fchsau.thf.hrc.fchsau-dtvw-aviso-cobranca=fch/fchsau/thf/hrc/fchsau-dtvw-aviso-cobranca.json
   
   
4. Acessar o endereço: http://<ambiente-Totvs>:<porta>/dts/datasul-rest/loadAllJSON?reload=true
   
   1. Deve abrir uma página com o seguinte conteúdo:

   

5. Reiniciar o jboss para que as configurações realizadas sejam carregadas.

Procedimento para Configuração

• No TOTVS12, acesse o programa "Importação Menu ByYou" e efetue a importação do arquivo "univdata/men_hrc.d" para efetuar a atualização do menu do módulo de "Revisão de Contas Médicas" (HRC).
  Programas  que serão criados no menu:
  • Exportação Aviso Cobrança (hrc.exportacaoAvisoCobranca);
  • Envio Baixa Aviso Cobrança (hrc.processaBaixaAviso);
  • Manutenção Avisos de Cobrança Exportados (hrc.documentosExportAvisosCob);
  • Manutenção Avisos de Cobrança Importados (hrc.noticeBillingImport);
• No TOTVS 12, acesse o programa Manutenção Parâmetros Revisão de Contas (hrc.paramrc) e informe, no campo "Diretório Geração A520" o diretório onde os arquivos serão gerados. O valor informado nesse campo é salvo no campo paramrc.char-20:
  
  
• No diretório informado acima, crie um sub-diretório denominado "retorno". Esse diretório será utilizado para depositar os arquivos de retorno (layout A525).
• No TOTVS 12, acesse o programa "Importação Classes Erro" e efetue a importação do arquivo "database/dados/claserro.d". Será criada a classe de erro "195-BAIXA DE AVISO POR GLOSA NA UNIDADE EXECUTORA". É necessário cadastrar uma glosa no programa "Manutenção Glosa" (hrc0110p), vinculada à nova classe de erro;
• No TOTVS 12, acesse o programa "Manutenção Mensagens" (hte0110k) e cadastre as seguintes mensagens de erro:
  • 2963-Aviso de Cobrança não cadastrado;
  • 2964-Aviso de Cobrança possui situação inválida;

Procedimento para Utilização

Exportação Aviso de Cobrança (A520)

No TOTVS 12, acesse o programa Exportação Aviso de Cobrança (hrc.exportacaoAvisoCobranca) para realizar a exportação dos avisos de cobrança. O programa foi desenvolvido utilizando o conceito de RPW que permite o agendamento das execuções.

Considerações sobre a exportação:

• No parâmetro "Tipo de Arquivo" informa-se o tipo de arquivo a ser processado: Exportação A520 ou Importação Retorno A520;
• Processamento da Exportação do A520:
  • Permite informar o tipo de intercâmbio: Eventual, Habitual ou Ambos;
  • É possível informar a seleção de unidades e transações do revisão de contas;
  • É possível parametrizar o número de dias retroativos para a seleção dos documentos do revisão de contas a serem exportados no A520.
• Permite parametrizar o nome do arquivo para os erros e acompanhamento do processo.

Na geração dos arquivos do layout A520 são lidos todos os documentos do revisão de contas cuja data de conhecimento está compreendida entre o data calculada com base no número de dias retroativos informados na opção Seleção e a data anterior ao dia corrente. O critério de ordenação dos documentos para geração dos arquivos XMLs se dá considerando o código da unidade origem do beneficiário, data de conhecimento, tipo de guia conforme o padrão TISS e prestador executante. Os arquivos Lote Guias gerados são compactados em extensão .zip e depositados no diretório parametrizado na Manutenção de Parâmetros do Revisão de Contas.

Ao final do processo é  gerado arquivo de acompanhamento com os documentos exportados juntamente com seu respectivo arquivo:

Caso ocorra erro no processamento, é gerado relatório de erros com as inconsistências:

Para a importação do retorno (layout A525), o programa processará todos os arquivos depositados no sub-diretório "retorno" do diretório parametrizado na Manutenção de Parâmetros do Revisão de Contas. Ao final do processo são gerados os arquivos de acompanhamento e de erros.

Manutenção Avisos de Cobrança Exportados

No TOTVS 12, acesso o programa "Manutenção Avisos de Cobrança Exportados" para consulta aos avisos de cobrança exportados:

Estão disponíveis as seguintes opções de busca avançada:

A tela de manutenção dos avisos exportados permite consultar as informações do histórico dos documentos do contas que foram considerados para a geração do aviso, consultar o histórico da situação do aviso e remover avisos.

A remoção de avisos somente ocorre para os registros na situação "1-Exportado A520". O processo de remoção somente remove o registro do aviso de cobrança gerado pelo programa "Exportação Aviso de Cobrança" (hrc.exportacaoAvisoCobranca). O documento no módulo revisão de contas não sofre nenhuma alteração. Após a exclusão, o sistema irá permitir nova geração do aviso de cobrança para as contas afetadas.

Nas configurações da tela é possível parametrizar o número de registros mínimos para execução batch da exclusão dos avisos. Caso o número de avisos seja superior ao parametrizado, o processo irá criar um pedido para execução em RPW da exclusão.

Importação Aviso de Cobrança (A520)

Para o processo batch de importação do arquivo lote guias referente ao aviso de cobrança (A520), no TOTVS 12, acesse  o programa "Exportação/Importação Lote Guias" (hrc0310p).

Na opção "Parâmetros" deve-se marcar o parâmetro "Carga Arq. XML - LoteGuias":

A configuração dos diretórios para importação dos arquivos referentes ao layout A520 segue o padrão já utilizado pelo processamento do arquivo lote guias padrão. O arquivo de retorno, layout A525, é gerado no diretório de resposta do processo do lote guias.

A importação dos avisos de cobrança irá gerar um lote de importação do tipo "Importação XML PTU A520". O prestador utilizado para criação do lote corresponde ao prestador parametrizado como representante da unidade informada na tag <ans:origem> do arquivo lote guias:

Manutenção Avisos de Cobrança Importados

No TOTVS 12, acesse o programa "Manutenção Avisos de Cobrança Importados" (hrc.noticeBillingImport) para consulta e manutenção dos avisos de cobrança importados:

Na tela principal da consulta, a área denominada como "Documento" apresenta a chave utilizada pelo TOTVS 12 para referência ao aviso importado. Esse dado é apresentado nos relatórios de contabilização.

Estão disponíveis as seguintes opções de busca avançada:

A tela de manutenção dos avisos importados permite consultar as informações dos avisos importados, consultar o histórico da situação do aviso e realizar a manutenção dos avisos importados.

Na manutenção dos avisos importados, é possível alterar os seguintes campos:

• Guia de Consulta: Tipo de Consulta, Indicação de Acidente, Atendimento a RN:
• Guia de SP/SADT: Tipo de Atendimento, Tipo de Consulta, Indicação de Acidente, Atendimento a RN e Motivo de Encerramento;
• Guia Resumo de Internação: Tipo de Internação, Regime de Internação, Indicação de Acidente, Tipo de Faturamento, CID Óbito, Declaração de Óbito, Número da Declaração de Óbito, Atendimento a RN e Motivo de Encerramento;
• Guia de Honorário Individual: Não permite a alteração das informações;

Envio Baixa Aviso Cobrança (A530)

Para envio da baixa do aviso de cobrança (A530), no TOTVS 12, acesse o programa "Envio Baixa Aviso Cobrança" (hrc.processaBaixaAviso). O programa foi desenvolvido utilizando o conceito de RPW que permite o agendamento das execuções:

A cada execução do processo de baixa do aviso, pode-se selecionar até três tipos de execuções distintas:

Aviso Indevido: Para cada aviso de cobrança exportado através do programa Exportação Aviso de Cobrança (hrc.exportacaoAvisoCobranca), o sistema irá verificar se o documento do revisão de contas vinculado ao registro do A520 sofreu cancelamento ou exclusão física. Em caso afirmativo, será enviado à unidade origem do beneficiário a baixa do aviso com o indicador de aviso indevido;

Glosa Total no Prestador: Para cada aviso de cobrança exportado através do programa Exportação Aviso de Cobrança (hrc.exportacaoAvisoCobranca), caso o documento do revisão de contas esteja faturado e todos seus movimentos foram glosados, então será enviado à unidade origem do beneficiário a baixa do aviso com o indicador de glosa total no prestador;

Prazo Expirado: Para cada aviso de cobrança importado através do programa Exportação/Importação Lote Guias (hrc0310p) e que estejam na situação 1-Importado A520, o sistema ira realizar o cálculo dos dias de prazo para recebimento da fatura. Caso o prazo esteja expirado, será enviado à unidade executora a baixa do aviso com o indicador de prazo expirado. Para o cálculo dos dias de prazo para recebimento da fatura, o sistema considera o parâmetro "Dias Receb." do programa Manutenção Negociação Entre Unidade (hrc0110t). Se informado, será considerado seu valor, caso contrário será considerado o parâmetro "Dias para Recebimento da Fatura" do programa Manutenção Parâmetros Revisão de Contas (hrc.param).

O parâmetro Tipo de Seleção fica disponível quando o tipo de execução for Aviso Indevido ou Glosa Total no Prestador. Suas opções são:

• Intervalo de data: permite ao usuário informar um intervalo de data de conhecimento do aviso para filtro dos avisos a serem cancelados;
• Informar número de dias: permite ao usuário informar o número de dias retroativos. Nessa opção, são considerados todos avisos cuja data de conhecimento esteja compreendida entre a data atual e a data retroativa calculada com base no número de dias informados.

Exportação de movimentos para cobrança (hrc0510m)

As contas exportadas no processo de exportação de movimentos faturados em custo operacional que foram previamente avisadas, terão os seguintes campos referentes ao aviso informados no arquivo A500:

• R502, Seq 56 - ID_AVISO;
• R502, Seq 58 - NR_LOTEPREST;
• R502, Seq 59 - DT_CONHECIMENTO;
• R504, Seq 77 - ID_AVISO_ITEM.

Os movimentos da conta que foram avisados através do layout A520 e que foram excluídos do documento do revisão de contas ou que não foram cobrados da unidade origem do beneficiário por motivo de glosa terão o campo da sequência 77 do registro R504 (ID_AVISO_ITEM) exportados com o valor "S" e os campos Seq. 13 (VL_SERV_COB), Seq 14 (VL_CO_COB), Seq. 15 (VL_FILME_COB), Seq. 22 (VL_ADIC_SER), Seq. 23 (VL_ADIC_CO) e Seq. 24 (VL_ADIC_FILME) exportados com valor igual a zero.

Os registros de aviso de cobrança das contas que foram exportadas no A500 têm sua situação alterada para 7-Exportado A500.

Importação de movimentos (hrc0510n)

Na importação das contas do layout PTU A500, o sistema consiste os campos referentes ao aviso de cobrança. Caso o aviso não for encontrado ou possuir situação diferente de 1-Importado A520 o usuário será alterado alertado com mensagem, porém o processamento do arquivo não será interrompido.