Objetivo

Documentar o processo da rotina de Monitoramento TISS.


Recebendo as movimentações através da API.

Guias de Monitoramento

     Ao receber as informações pela API "monitForm", estas movimentações são gravadas nas tabelas:

         BRA – Cabec Guias Temp - API Monitoramento

         BRB – Eventos Temp - API Monitoramento

         BRC – Pacotes Temp - API Monitoramento


Fornecimento Direto

     Ao receber as informações pela API "monitDirectSupply", a mesma realizará uma pré-validação e os eventos serão gravados inicialmente nas tabelas:

         BVQ – Cabec Guias Fornec Direto

         BVT – Eventos Fornec Direto

     Se houverem críticas, as mesmas serão gravadas na tabela B3F. Com as guias já salvas, o usuário deve acessar a rotina Fornecimento Direto / Movimentação, e acessar o botão Validar Geral. É realizada a validação total das guias, caso existam críticas, a mesma será gravada na tabela B3F,           caso não, a guia é marcada com o campo Validado (BVQ_VALID) = 1. Posteriormente na rotina Lotes, podemos criar um lote na Tabela BKW e atribuir as guias de fornecimento direto validadas no passo anterior.


Importante: Na utilização da API, caso seja recebida uma Operadora inválida, será retornado que aquela Operadora é Inválida. 

     

Outras Remunerações

     Ao receber as informações pela API, a mesma realizará uma pré-validação e os eventos serão gravados inicialmente na tabela:

         BVZ - Outra Remuneração

     Se houverem críticas, as mesmas serão gravadas na tabela B3F. Com a informação da Outra Remuneração salva, o usuário deve acessar a rotina Outra Remuneração / Movimentação, e acessar o botão Validar Geral. É realizada a validação total dos registros, caso existam críticas, a mesma           será gravada na tabela B3F, caso não, o registro é marcado com o campo Validado (BVQ_VALID) = 1. Posteriormente na rotina Lotes, podemos criar um lote no Alias BKW e atribuir os registros de fornecimento direto validadas no passo anterior.

        BKW – Lotes – API Monit.

     Com o lote gerado, é possível gerar o arquivo XML que será encaminhado para a ANS. Caso haja alguma crítica, a ANS gerará um arquivo de resposta que deve ser importado (Arquivo de retorno .XTR).


Valor Preestabelecido

     Ao receber as informações pela API, a mesma realizará uma pré-validação e os eventos serão gravados inicialmente na tabela:

        BVW – Valor Preestabelecido

     Se houverem críticas, as mesmas serão gravadas na tabela B3F. Com a informação do Valor Preestabelecido salvo, o usuário deve acessar a rotina Valor Preestabelecido / Movimentação, e acessar o botão Validar Geral. É realizada a validação total dos registros, caso existam críticas, a                   mesma será gravada na tabela B3F, caso não, o registro é marcado com o campo Validado (BVQ_VALID) = 1. Posteriormente na rotina Lotes, podemos criar um lote no Alias BKW e atribuir os registros de Valor Preestabelecido validados no passo anterior.

        BKW – Lotes – API Monit.

     Com o lote gerado, é possível gerar o arquivo XML (Arquivo de envio .XTE) que será encaminhado para a ANS. Caso haja alguma crítica, a ANS gerará um arquivo de resposta que deve ser importado.


Processando as movimentações que vieram da API.

Com as tabelas acima gravadas, é executado o JOB SVCPROCMON que é responsável por processar as guias de monitoramento.

O resultado do processamento do JOB, são seguintes tabelas, que são oriundas das tabelas:

     BRF – Cab Guias Process - API Monit

     BRG – Eventos Process - API Monit

     BRH - Pacotes Process - API Monit


Ainda no processamento realizado anteriormente, a guia também é registrada nas tabelas de Movimentações:

     BKR – Cabeçalho Guia Movimentação – armazena todos os dados da guia que serão enviadas para a ANS. Relação direta com a BRF.

     BKS – Eventos Movimentação – traz todos os dados dos eventos da guia que serão enviadas para a ANS. Relação direta com a BRG.

     BKT - Pacotes Movimentação – traz todos os dados dos eventos da guia que serão enviadas para a ANS. Relação direta com a BRH.


Importante: se recebermos novos dados para a guia no futuro, as tabelas BRF, BRG e BRH serão atualizadas, as tabelas BKR, BKS e BKT terão novos registros.

Com as guias já processadas, executaremos um processo para realizar a validação das guias. Caso existam críticas, as mesmas serão gravadas na tabela de críticas geral da Central de Obrigações B3F. Guias que não apresentem críticas serão marcadas com o campo Validado (BRF_VALID) = 1.

Posteriormente na rotina Lotes, criaremos um lote no Alias BKW e atribuiremos as guias validadas no passo anterior

Críticas

Código

Código ANS

Crítica

Solução

M0011012

Número do CNES Inválido.

Preencha o campo com Número do CNES válido e existente no Ministério da Saúde.

M002



M0031323Data da Guia de Solicitação é Inválida.Preencha o campo Data da Guia de Solicitação com uma data válida.
M0041323

Data da Realização do Atendimento/Procedimento da Guia é Inválida.

A data deve ser válida e diferente da Data Atual e menor ou igual a data de Registro da Transação.

M005


M006


M007


M008


M009


M010


M011


M012


M013


M014


M015


M016


M017


M018


M019


M020


M021


M022


M023


M024


M025


M026


M027


M028


M029


M030


M031


M032


M033


M034


M035


M036


M037


M038


M039


M040



Geração de Lote

O objetivo desta rotina é aglutinar os registros processados que não tem críticas em lotes para serem enviados a ANS. Ao entrar na rotina, o Alias carregado é o BKW.

Os lotes serão gerados através do JOB SVCGERALOTE.

Na tela teremos os botões:

                      Guias Monitoramento – Exibe as guias do lote (Alias BKR).

                      Fornecimento Direto – Exibe os registros de Fornecimento Direto do lote (Alias BVQ).

                      Outra Remuneração Exibe os registros de Outra Remuneração do lote (Alias BVZ).

                      Valor Pré-Estabelecido Exibe os registros de Valor Pré-Estabelecido do lote (Alias BVW).

Tela:

Guia Monitoramento

Esta rotina Apresenta as movimentações das guias de monitoramento que foram geradas após a execução do JOB SVCPROMON.

Fornecimento Direto

Esta rotina Apresenta as movimentações das guias de Fornecimento Direto que foram geradas após a execução do JOB SVCPROFOR.

Outra Remuneração

Esta rotina Apresenta as movimentações das guias de Outras Remunerações que foram geradas após a execução do JOB SVCPROOREM.

Valor Preestabelecido

Esta rotina Apresenta as movimentações das guias de Valor Preestabelecido que foram geradas após a execução do JOB SVCPROCPRE.


Download XTE

Baixa o arquivo de envio para máquina local.

Import XTR Retorno

Importa o arquivo de retorno XTR.


Export XTR sem Movimentação.

Gera um arquivo de envio .XTE sem movimentação para um compromisso que não tem lote gerado.


Configurando a Importação do Arquivo da Qualidade (XTQ)


Disponibilize em um diretório na sua máquina Local o arquivo de Retorno da Qualidade:

Print 1.


Na estrutura de Menu da Central de Obrigações escolha a opção Arquivos da Qualidade.

Print 2.


Ao abrir a tela clique no Botão "Importar XTQ" e será aberta a tela para indicar o diretório onde foi salvo o XTQ em sua máquina local.

Print 3.


Ao clicar em abrir o sistema perguntará se deseja executar o JOB. Neste caso clicaremos em "Não" para que não seja executado o JOB.

Print 4.


Em seguida será apresentada a mensagem abaixo, como o JOB não foi executado neste momento, somente será copiado o arquivo que selecionamos para a estrutura do servidor.

Print 5.


Na estrutura do servidor o arquivo que copiamos ficará disponível para o processamento do JOB. Não é necessário que seja criado os diretórios monitoramento, xtq, ano e mês pois o sistema faz isso automaticamente ao copiar o arquivo. O nome do Arquivo XTQ é composto da seguinte forma:

REGANSAAAAMMSSSS.xtq       Ou seja, os 6 primeiros dígitos são do Registro da Operadora (em meu exemplo 123456), ano (em meu exemplo 2020), mês (em meu exemplo 02) e sequência. Neste caso repare que a estrutura foi criada com monitoramento/xtq/2020/02.

Print 6.


Voltando a tela acima, onde é perguntado se deseja executar o JOB (Print 4), considere que clicamos em "SIM". Neste caso o sistema também irá copiar o arquivo XTQ para o servidor, porém irá executar o JOB naquele momento (em segundo plano) e exibirá a mensagem abaixo:

Print 7.


Ao fechar a tela acima (Print 7), o JOB ficará em segundo plano e posteriormente ao acessar a tela de Arquivo da Qualidade repare que a movimentação foi Criada.

Print 8.


Veja as Opções que temos no botão Outras Ações:

Print 9.


Clico na Opção "Ocorrências Gerais"

Na Tela de Ocorrências Gerais, encontramos todas ocorrências que houve no lote. Esta tela é semelhante ao arquivo que foi importado.

Print 10.


Na tela acima clico no botão "Guia", será aberta a tela de Processamentos (BRF) do Monitoramento. Repare no botão "Outras Ações". Há a opção de clicar em beneficiário. Ao clicar será aberto o cadastro de beneficiário da Central (B3K).

Print 11.


Tela de Beneficiário aberta, após ter clicado no botão.

Print 12.


Agora saímos de todas essas telas e voltamos a tela de Importação. Repare que temos o botão Ocorrências por Guia. Clique nele.

Print 13.


Trata-se de todas as Guias que vieram no arquivo XTQ. AO clicar em "Guia" é aberta a tela de Processamentos conforme Print 11 e na sequência após abrir a tela em questão também é disponibilizado o botão beneficiário conforme já demonstrado.

No print abaixo, posicionamos em uma Guia e clicamos em Ocorrências.

Print 14.


Foi aberta a tela de Ocorrências por Guia. Trata-se da visualização das ocorrências que vieram no arquivo, porém filtradas de acordo com número da Guia.

Obs.: O Botão visualizar apenas abre a tela do registro selecionado.

Print 15.


Voltando a tela inicial temos a opção de Ocorrências Agrupadas.

Print 16.


Esta tela trata-se de todas as ocorrências contidas no arquivo XTQ agrupadas por Código e Descrição.

Print 17.


Ao clicar em Detalhar o sistema apresenta as Guias que tiveram aquele Código do Erro selecionado anteriormente. Repare que também há o botão de "Guia" nesta tela, é a mesma funcionalidade dos botões "Guia" apresentado anteriormente, ou seja, ao clicar o sistema abre a tela de Guias Processadas do monitoramento e posteriormente é possível visualizar o Beneficiário.

Obs.: O Botão Visualizar apenas abre a tela com o registro que estamos posicionados.

Print 18.


Importante: Como vimos, a Importação do Arquivo de Retorno de Qualidade está fora do menu de compromisso da Central. Isso porque o arquivo de Qualidade não tem relação com compromisso.

Print 19.


Configurando os JOBs

SVCPROCMON - Processa os dados das Guias de monitoramento

SVCVLMGGRP  -  Realiza a validação em Grupo das Guias

SVCVLINGMO  - Realiza a validação em individual das Guias

SVCPROCFOR  - Processa as Guias de Fornecimento direto.

SVCPROCPRE   - Processa as Guias de Valor Pré-Estabelecido.

SVCPROOREM - Processa Guias de Outras Remunerações.

SVCGERALOTE  - Gera o Lote de Guias. 

SVCGERXTE      -  Gera o Arquivo de Envio .XTE

SVCIMPXTR      - Realiza a importação do arquivo de retorno .XTR  

SVCIMPXTQ     - Realiza a importação do Arquivo da Qualidade .XTQ



Abrir o Configurador

Print 20.


Selecionar a Opção Schedule

Print 21.


Adicionar um Agent de acordo com seu ambiente. Para isso clique em "Adicionar Agents Padrão" localizado no canto superior direito da tela.

Print 22.


Criação dos JOBs 

Com o Agent criado e iniciado, vamos criar o agendamento. Para isso clique em Agendamentos/ Cadastro na Visão do Schedule. Em seguida, no grid inferior, clique em incluir  e o sistema já irá "gatilhar" as informações de código, usuário, ambiente e data.

O primeiro campo a parametrizar é o Rotina. Repare no print abaixo que estou inserindo no campo o JOB SVCPROCMON. Quando finalizarmos a criação deste JOB, devemos repetir estes mesmos passos deste item "Criação dos JOBs", porém inserindo no campo rotina o próximo JOB de acordo com a lista abaixo.


Veja os nomes dos JOBs que devem ser inseridos no campo rotina.


SVCPROCMON - Processa os dados das Guias de monitoramento

SVCVLMGGRP  -  Realiza a validação em Grupo das Guias

SVCVLINGMO  - Realiza a validação em individual das Guias

SVCPROCFOR  - Processa as Guias de Fornecimento direto.

SVCPROCPRE   - Processa as Guias de Valor Pré-Estabelecido.

SVCPROOREM - Processa Guias de Outras Remunerações.

SVCGERALOTE  - Gera o Lote de Guias. 

SVCGERXTE      -  Gera o Arquivo de Envio .XTE

SVCIMPXTR      - Realiza a importação do arquivo de retorno .XTR  

SVCIMPXTQ     - Realiza a importação do Arquivo da Qualidade .XTQ


Clique na Consulta do campo Empresa/Filial e selecione a Empresa que irá utilizar o JOB


Em seguida a Filial


Na sequência clique na Consulta e indique o módulo que será utilizado.

Obs.: Caso esteja abrindo a Central de Obrigações através do módulo 33 (Plano de Saúde), informe 33 no campo módulo.


Nomeie o JOB no campo Descrição:


Preencha a descrição e clique no botão   será aberta a tela de Recorrência. Informe o Padrão e Intervalo da Recorrência. 

Obs.: Os valores informados na tela abaixo são apenas para efeito de teste. Avalie o Padrão e Intervalo que será utilizado em seu ambiente. A opção "Sempre Ativo" não deve ser utilizada.


Com todos os campos parametrizados Confirme o Grid clicando em  a descrição do JOB irá para o Grid superior.


Execução manual do JOB.

Conforme parametrização acima, foram configurados todos os JOBs. Caso seja necessário executar algum deles manualmente (sem aguardar o período parametrizado), podemos seguir os passos abaixo.

Dentro do Grid de Visões clique no botão   (monitor) . No Grid Agendamentos (ao lado) posicione no JOB que deseja executar e clique no botão Executar Agora 

Esses passos devem ser seguidos para cada um dos JOBs que deseja executar manualmente.


Clique em Atualizar  no Grid Tarefas e ela aparecerá no Grid Tarefas.


Importante: Para que o JOB seja executado o Agent deve estar Iniciado.