PTU Batch 10.0 - A520, A530

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:

Procedimento para Configuração

• No TOTVS 12, acesse o programa Manutenção Parâmetros Revisão de Contas (hrc.paramrc) e informe os campos "Diretório de Geração A520" e "Utiliza Aviso de Cobrança (A520) On-line". O funcionamento desses campos está descrito abaixo, na área "Exportação Aviso de Cobrança (A520)":
  
• 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;
  • O parâmetro "Cobrar valores alterados após valorização para" permite ao usuário informar para quais tipos de movimentos o sistema exportará como valor de cobrança o valor alterado após a valorização do contas. As opções disponíveis são: Nenhum, Procedimento, Insumo ou Ambos.
• 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.

A geração dos avisos de cobrança respeita o parâmetro "Utiliza Aviso de Cobrança (A520) On-line" do programa Manutenção Parâmetros Revisão de Contas (hrc.paramrc). Caso o parâmetro esteja ativo, cada aviso de cobrança conterá apenas um documento do revisão de contas e o sistema realizará a comunicação com a unidade origem do beneficiário de forma on-line, aguardando a resposta e realizando seu processamento. Neste tipo de execução, no diretório parametrizado no campo "Diretório Geração A520" do programa Manutenção Parâmetros Revisão de Contas (hrc.paramrc) será criado um subdiretório para cada dia de execução, onde os arquivos de requisição e resposta são depositados. Tais arquivos são gerados com a nomenclatura AVE<número do lote>.xml (requisição) e AVR<número do lote>.xml (resposta). Na geração on-line do A520, todos os avisos exportados que retornaram com erro da unidade origem do beneficiário são comunicados novamente.

Caso o cliente opte pelo processo batch ("Utiliza Aviso de Cobrança (A520) On-line" desativado), 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), é necessário criar um sub-diretório intitulado "retorno" no diretório parametrizado na Manutenção de Parâmetros do Revisão de Contas. O programa processará todos os arquivos ali depositados e ao final do processo são gerados os arquivos de acompanhamento e de erros.

Manutenção Avisos de Cobrança Exportados

No TOTVS 12, acesse 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:

Essa tela permite realizar as seguintes ações nos avisos exportados:

• 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;
• Remover avisos: para os registros na situação "Exportado A520" (processo batch) ou "Retorno com Erro" o sistema realiza a exclusão física dos registros. Já os registros na situação "Importado Retorno", antes da exclusão física do registro, o sistema envia à unidade origem do beneficiário a baixa do aviso através da mensagem A530.
• Reprocessar avisos com erro: essa opção está disponível para o processo on-line, conforme parâmetros do RC. O reprocessamento do aviso de cobrança realiza nova tentativa de comunicação com a unidade origem do beneficiário.
• Consulta às mensagens de erro: permite consulta as mensagens de erro retornadas pela unidade origem do beneficiário no XML de resposta do aviso de cobrança.

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, realizar a manutenção dos avisos importados e consultar as mensagens de erro (para registros na situação Importado com Erro).

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á alertado com mensagem, porém o processamento do arquivo não será interrompido.