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.

Procedimento para Configuração

• 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;

• 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)":
  
• Para o funcionamento da mensagem de baixa de aviso (A530), é necessário adicionar as seguintes propriedades no arquivo foundation-exchange.properties, disponível no servidor do Foundation no caminho <caminho jboss>/server/<instância>/conf:

  • connector.External.Foundation.batch.v100 = com.totvs.foundation.exchange.connector.ptu.implementation.batch.v100.DefaultExternalConnector

  • com.totvs.foundation.exchange.connector.ptu.implementation.batch.v100.DefaultExternalConnector.baixarAviso.namespace.URI = http://nc.unimed.coop.br/baixarAviso/webservices/V1_00_00

  • com.totvs.foundation.exchange.connector.ptu.implementation.batch.v100.DefaultExternalConnector.baixarAviso.WSDL = http://localhost/wsdl/ptu/v100batch/baixarAviso_V1_00_00.wsdl

  • com.totvs.foundation.exchange.connector.ptu.implementation.batch.v100.DefaultExternalConnector.baixarAviso.ENDPOINT = https://cxs-squad-ie01.jv01.local:28443/htz-foundation/PtuBaixarAvisoBatchWSv100

  • connector.Internal.PtuXml.batch.v100.BaixaAvisoRequest = com.totvs.foundation.exchange.connector.foundation.implementation.batch.v100.BaixarAvisoInternalConnector

• Ainda no programa Manutenção Parâmetros Revisão de Contas (hrc.param), informe os campos "Diretório de Carga A520", "Diretório de Processamento A520" e "Diretório Resposta A520":
  Image Added

• Para acesso aos procedimentos de configuração do módulo Foundation Saúde, utilize o link HTZ - Foundation.

  Para o funcionamento do envio de avisos de cobrança online (A520), no mesmo arquivo é necessário adicionar as seguintes propriedades:

• com.totvs.foundation.exchange.connector.ptu.implementation.batch.v100.DefaultExternalConnector.enviarAviso.WSDL = http://localhost/wsdl/tiss_v3_3_3/tissLoteGuiasV3_03_03.wsdl

• com.totvs.foundation.exchange.connector.ptu.implementation.batch.v100.DefaultExternalConnector.enviarAviso.ENDPOINT = https://cxs-squad-ie01.jv01.local:28443/htz-foundation/PtuEnviarAvisoCobrancaWSv100?wsdl

• com.totvs.foundation.exchange.connector.ptu.implementation.batch.v100.DefaultExternalConnector.enviarAviso.namespace.URI = http://www.ans.gov.br/tiss/ws/tipos/tissloteguias/v30303

connector.Internal.PtuXml.batch.v100.EnvioAvisoRequest = com.totvs.foundation.exchange.connector.foundation.implementation.batch.v100.EnviarAvisoInternalConnector

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.

Image AddedImage Removed

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 intervalo de data de conhecimento para filtro das contas 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 correnteintervalo definido nos campos "Data Inicial de Conhecimento e Data Final de Conhecimento. 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)

No TOTVS12, acesse o menu Importação Aviso de Cobrança (hrc.importaAvisoCobranca) para realizar a importação dos avisos de cobrança modo batch.

Image Added

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":

Image Removed

este processo é necessário a parametrização dos seguintes diretórios na Manutenção Parâmetros Revisão de Contas (hrc.paramrc):

• Diretório de Carga A520: diretório onde devem ser depositados os arquivos com extensão XML do A520. Para cada arquivo depositado no diretório o sistema cria um lote de importação;
• Diretório de Processamento A520: diretório onde o sistema armazena os arquivos após a carga e criação dos lotes de importação. Após a carga, o sistema obtém os arquivos deste caminho para realizar a importação do aviso de cobrança.
• Diretório de Resposta A520: diretório onde são depositados os arquivos de resposta do A520 (arquivo PROTOCOLO_RECEBIMENTO da TISS).

Após o processo de importação, o sistema irá gerar um arquivo de acompanhamento e outro de erros na central de documentos:

Image Added

O arquivo de acompanhamento irá listar cada arquivo processado, informações do lote criado e a situação. O campo situação pode conter três estados possíveis:

• Arquivo não foi carregado: Indica que ocorreram erro na carga do arquivo. Nessa situação, os avisos de cobrança não serão importados e não será gerado arquivo de resposta. Os erros ocorridos podem ser consultados no relatório de erros;
• Lote importado com erros: Durante a importação dos avisos de cobrança, caso ocorra alguma inconsistência em algum movimento presente no arquivo, o sistema não irá importar o item. Nessa situação, o sistema irá importar os itens que não acusaram erro, os erros ocorridos com os demais procedimentos/insumos serão direcionados ao relatório de erros e o arquivo será listado no relatório de acompanhamento com a situação "Lote importado com erros". Caso o cliente deseje que os itens com erro sejam importados, deverá ser ajustada a parametrização que disparou o erro, remover o lote de importação no programa Atualização Lote Importação (hrc0510p) e depositar novamente o arquivo no diretório de carga para novo processamento. Os arquivos listados com a situação "Lote Importado com erros" terão seu respectivo arquivo de resposta gerado, porém sem as inconsistências;
• Lote importado: Indica que a importação do arquivo ocorreu sem nenhuma inconsistência. O arquivo de resposta será depositado no diretório de resposta parametrizado na Manutenção Parâmetros Revisão de Contas (hrc.paramrc).

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.