Histórico da Página

...

02. Detalhamento 

Âncora
ATUAL ATUAL

A) Entrada dos dados para a nova tela de Fornecimento Direto - Tela de medicamento de uso

...

Constante (portal beneficiário) e Análise de Receitas (PLSANRCT - remote)

Uma das entradas de solicitação de Fornecimento direto se dará por meio do Portal Web do beneficiário, por meio da tela de  solciitação do beenrficiário 

B) Importação - Regras

1. Vamos utilizar como padrão o arquivo TXT e o CSV, ambos separados por ponto e vírgula (;).  Essa informação deve estar de forma clara e concisa no documento de referência.
   1. Existe a opção de XML, mas para esse tipo de exportação, o cliente deve ter o módulo adicional.  Como nem todos possuem, será aceito para importação apenas os arquivos TXT e CSV, separados por ponto e vírgula.
      1. Ao realizar a leitura da primeira linha do arquivo, se o separador for diferente de ponto e vírgula, podemos recusar o arquivo e partir para o próximo arquivo, gravando essa inconsistência, para exibir ao usuário no final do processo.
2. Além do nome do arquivo, que deverá ter nome igual as regras cadastradas no B6G - Configuração de Importação - deverá ser colocado também o código da mensagem SIMPRO® de atualização, seguido dos dois últimos dígitos do ano.  Exemplo: Se temos uma regra onde o nome definido foi SANEANTES+PFB, e o arquivo de mensagem (atualização) SIMPRO® foi 6, do ano de 2021, o nome do arquivo deverá ser algo como SANEANTES_PFB_621.TXT ou SANEANTESPFB_621.CSV.
3. Ao clicar no botão Importar, deve ser exibido um ParamBox, onde o usuário deverá informar:
   1. Pasta onde os arquivos CSV/TXT estão localizados (OBRIGATÓRIO);
   2. Código Mensagem (atualização) SIMPRO® (igual ao do campo mensagens, existente no sistema VideoFarma®), seguido dos dois últimos dígitos do ano (OBRIGATÓRIO);
      1. Para cada atualização enviada, temos um código da VideoFarma® – como a edição na Brasíndice®.  Deverá ser colocado esse código, como: 33/2021, logo, deverá ser colocado 33 e os dois últimos dígitos do ano, ficando 3321.
   3. Data da mensagem da SIMPRO® (será informado como data inicial de vigência para os itens – BD4_VIGINI) e será subtraído um dia, quando for para fechar vigência (OBRIGATÓRIO);
   4. Campo para informar data de fim de vigência, para os itens que estiverem no status (L)Fora de Uso ou (D)Descontinuado (OBRIGATÓRIO);
   5. CheckBox para informar se nos itens com status (L)Fora de Uso ou (D)Descontinuado, se deseja usar a data fim de vigência da ANVISA ou a data do item acima, caso a data no arquivo esteja fora do padrão.
      1. Aqui, devemos ter atenção, pois não existe data de fim de vigência ou arquivo de exclusão, igual ocorre na Brasíndice®.  Assim, o usuário deve informar uma data de até quando deseja utilizar aquele item Descontinuado/Fora de Uso ou então, em conjunto com o checkbox, caso queira usar a data final de vigência da ANVISA, que consta no arquivo.
      2. Contudo, em alguns registros aparece apenas a informação “VIGENTE” ou outros e assim, vai usar a data inserida pelo usuário.
   6. Ao clicar em OK do ParamBox, o sistema deve varrer o diretório, localizando os arquivos TXT e CSV que tenham nomes similares as regras cadastradas na tela de configuração e que tenham código igual ao informado no Pergunte.
      1. Se localizar arquivo com nome igual a regra, mas a versão é diferente ou inexistente, o usuário deve ser indagado se deseja importar o arquivo, mas a versão utilizada será a que está no Pergunte, para fazer o relacionamento no campo BD4_CHVIMP.
      2. Só pode existir um arquivo para cada configuração!  Logo, se um arquivo já deu match com uma configuração, essa configuração não pode mais dar match com nenhum outro arquivo.
      3. Se encontrar arquivos, mas nenhum bate com as regras cadastradas, exibir uma caixa de desambiguação de arquivos, onde será exibido um browse com duas colunas, onde na primeira coluna, teremos os arquivos que não batem com nenhuma regra existente, e na segunda coluna, será exibido um combobox, com as regras que ainda não tiveram arquivos localizados, para o match manual.
         • Se todas as regras já tiverem um arquivo e mesmo assim, sobrou arquivos "órfãos", a janela de desambiguação não deve ser exibida, pois conforme item II acima, uma regra só pode ter um arquivo relacionado.
         • Registrar essa inconsistência, para exibir no final do processamento para o usuário.
         • Essas opções e janela existem na importação da Brasíndice®, no PLSBRSIN1.
4. Criar rotina específica para leitura dos arquivos TXT e CVD da SIMPRO®.
   1. Não é possível usar a mesma rotina da Brasíndice®, pois possui particularidades próprias
   2. A rotina deve contar com parte visual, para exibir o andamento do progresso das operações.
   3. Utilizar a classe FWFileReader() para leitura dos arquivos, setando um buffer de no mínimo, 10KB, para melhorar a performance da importação.
   4. https://tdn.totvs.com/display/framework/FWFileReader -> FwFileReader
5. Realizar o parse em cada linha, para desmembrar as colunas separadas com o ponto e vírgula, para trabalhar os dados e realizar as devidas inclusões/alterações e fechamento de vigências.
   1. Para quebrar a linha lida, coo foi usado o ponto e vírgula como separador, usar o StrTokArr2, para criar o array baseado na string lida.
6. No final da importação, exibir um resumo dos arquivos importados, com problemas e registros não válidos, caso aconteça.

C) Importações – Tabelas

1. Após as validações acima, necessitamos gravar ou atualizar as seguintes tabelas:
   1. BR8 - Tabela Padrão
   2. BA8 - Tabela Dinâmica de Eventos
   3. BD4 - Unidade de Saúde
   4. BTQ – Tabela de Terminologias
   5. B6F – Tabela de Histórico de Importações realizadas
   6. BF8 - Tabelas de Honorários.
      1. A BF8 só será criada se no campo B6G_CRITDE estiver como SIM. Caso contrário, não será gravada
2. No arquivo SIMPRO® – temos o código próprio da SIMPRO® e para maioria dos itens, temos o código TUSS equivalente.
   1. Se não existir código TUSS no registro analisado, deve ser gravado ou atualizado na TDE própria (informado no cadastro de configuração – B6G);
   2. Se existir o código TUSS no registro, devemos verificar na TDE própria – informada no cadastro da configuração (B6G) – se temos o código SIMPRO® do item cadastrado e se está com a data de vigência finalizado. Se não estiver com data de finalização (BD4_VIGFIM), devemos finalizar a vigência, utilizando a data do ParamBox (Data da mensagem da SIMPRO®) menos 1 dia. Ou seja, se foi informado 10/10/2021, devemos subtrair um dia, colocando no campo BD4_VIGFIM o valor 09/09/20210. 
      1. Na sequência, verificar se já existe o código TUSS cadastrado, para inclusão ou alteração dos dados.
   3. Para cada registro gravado, no campo BD4_CHVIMP, deve ser colocado a chave de registro de relacionamento, com as informações “SIMPRO| + código da atualização + ”|” + Tipo do Procedimento + “|” + Tipo Valor”. Ou seja, é a concatenação dos campos “SIMPRO|” + código da atualização (mensagem) informada no ParamBox + “|“ + B6G_TIPPRO + “|” + B6G_TIPO. Simplificando, se foi informando no ParamBox o código da atualização 3321, e estamos importando um arquivo de Material (B6G_TIPPRO = 1) e o valor Preço de Fábrica (B6G_TIPO = 2), o campo BD4_CHVIMP vai receber o valor como: SIMPRO|3321  |1|2.  
   4. Se existir um BD4 para evento, e na chave de relacionamento (BD4_CHVIMP), o código da atualização for menor que o atual, essa vigência será finalizada com a data do ParamBox (Data da mensagem da SIMPRO®) menos um dia, para gravar a nova BD4 com a nova vigência, com os dados necessários.
      1. Só gravar se tiver alteração de valor.  Se os dados são iguais, mesmo em atualizações diferentes, não precisa executar o passo acima.
   5. Ao gravar os registros, criar ou atualizar os mesmos na Tabela de Terminologia BTQ, terminologia 64, conforme padrão TISS. Atualizar da seguinte maneira:
      1. BTQ_CODGRU - Se medicamento, gravar o valor "030". Para os demais, gravar "029".
      2. BTQ_DESGRU - Se medicamento, gravar o texto "MEDICAMENTO". Para os demais, gravar "MATERIAIS E OPME".
      3. BTQ_FENVIO - Gravar o texto "CONSOLIDADO".
         • Para conhecimento: Grupo 029 - MATERIAIS E OPME / Grupo 030 - MEDICAMENTOS
3. No final da importação, gravar os dados pertinentes na tabela B6F - Importações Brasíndice, para efeitos históricos e consultar os registros importados. 

D) Exclusão das Importações

1. O usuário pode deletar alguma importação realizada, bastando no browser do PLSSIMPRO posicionar no registro desejado e clicar no botão Excluir.  Contudo, temos algumas regras a serem seguidas:
   1. Ao solicitar a exclusão do registro posicionado, devemos garantir se é o último importado, pela sequência do campo BD4_CHVIMP, que armazena o código da mensagem (atualização) da SIMPRO.  Se tentar excluir qualquer um que não seja o último importado, o sistema deve proibir, de acordo com o tipo de produto e valor.
      1. Por exemplo, importei à atualização 3021 - Material - PFB e no outro mês, importei o 3121 - Material - PFB.
      2. Se tentar excluir o 3021 - Material - PFB, o sistema não deve deixar, pois existe atualização superior, que pode ter finalizado e criado novas BD4 com outros vigências.  No nosso exemplo, só podemos excluir o 3121 - Material - PFB, pois é a última importação.
   2. Caso possa excluir, conforme regra acima, devemos:
      1. Deletar os registros BD4 relacionados a essa importação, pelo campo de relacionamento BD4_CHVIMP.
      2. Após deletar o BD4 relacionado, devemos reabrir a vigência do último BD4 disponível para o item, seguindo a cronologia do campo BD4_CHVIMP.  
         • Se existir registro BD4 anterior, o campo BD4_VIFGIM deve ser limpo, para ser utilizado no sistema;
         • Se não existir nenhum BD4 anterior (imagine um item adicionado nessa versão excluída), a BA8 relacionada ao BD4 deve ser excluída, pois não pode existir um BA8 sem BD4;
         • Se a BA8 foi excluída, devemos atualizar na BR8 - relacionada ao registro da BA8 - o campo BR8_BENUTL como Não, já que o item não existe mais na BA8.
      3. Ou seja, como visto acima, a exclusão deve ser em "cascata", obedecendo aos critérios definidos.  Logo, se excluir uma BD4 e tiver outro registro BD4 para reabrir a vigência, apenas limpo a data final e o processo acabou por aí.  Se não, tenho que deletar os demais envolvidos, que é a BA8 e BR8, para manter a consistência dos registros.

E) Detalhes Técnicos 

1. Utilizar MVC e herança, quando necessário;
2. Utilizar para leitura de arquivos a classe FWFileReader();
3. Utilizar para gravar arquivo de texto a classe FWFileWriter();
4. Tratar as descrições e campos de textos, para evitar caracteres especiais e que possam atrapalhar a visualização no Portal ou arquivos de exportação (Monitoramento / PTUs / RPS e outros);
5. Utilizar os índices disponíveis nas tabelas ou criar os necessários, para otimizar buscas e querys;
6. Criar os fontes pensando nas automações necessárias, para evitar retrabalhos futuros;
7. Como temos um layout de importação, pode-se criar um função, contendo o layout e posição dos campos, caso o desenvolvedor julgue necessário;
8. Todas as ações de importação, arquivos e registros inválidos, devem ser registradas e exibidas no final do processamento, para conhecimento do usuário:
   1. Utilizar o FWDialogModal() com FwBrowse(), para exibir esses erros, ao invés de utilizar a função PLSCRIGEN.
9. Verificar a possibilidade de realizar a gravação das tabelas usando classes MVC, levando em consideração o tempo de desenvolvimento vs ganho de performance obtido.
10. Utilizar a importação da Brasíndice como modelo.  Fontes PLSBRASIN1 / PLSBRASIN2 / PLSBRASINI.  
    1. Documento de referência em Importação Brasíndice® - PLSBRASIN1.
11. Padrão de arquivos para importação: TXT ou CSV.  Os demais devem ser ignorados.
12. Separador padrão dos arquivos CSV e TXT: ponto e vírgula (;).  Nenhum outro deve ser aceito.
    1. Se basear em um dos itens, onde na primeira linha, podemos validar se o separador é ponto e vírgula e se não for, interromper a importação e partir para o próximo arquivo.

...

• Layout TXT 

...

...

de Cadastro Medicamento Uso Constante.

Nessa tela, podemos ter duas ações:

• Criar um checkbox, para o usuário indicar que se trata de um medicamento/item de alto custo e que deve ser fornecido pela Operadora (alto risco de erro por parte do usuário).
• Descobrir - via chamado na ANS ou outro meio - quais são os código mais comumente usados ou obrigatórios para esse fim, para que quando o cliente informar esse código, o sistema já entenda que se trata de uma solicitação de fornecimento direto.

Em ambos os casos, criar um campo novo na tabela B7D - Receitas Medicamento x Usuario, para identificar que o item é fornecimento direto, conforme diretrizes abaixo. Características do campo:

• Campo B7D_FORDIR, tipo caracter, tamanho 1, combobox: 0=Não;1=Sim, valor padrão: 0.
• Na tela do Portal, de acordo com a escolha do preenchimento do campo - ou seja, se o usuário deverá marcar que se trata de medicamento de fornecimento direto, este campo deverá estar visível e disponível para escolha do usuário (sugestão: pode ser um campo do tipo check ou combobox), no grupo Incluir Medicamentos.  Se a escolha for de acordo com o código digitado o sistema separa o que é fornecimento direto ou não, este campo ficará oculto e será preenchido pelo sistema, na hora de salvar os dados da receita.
• Image Added
• Este campo deverá estar visível e disponível para uso do operador do sistema - na tela de Analise de Receitas (PLSANRCT), no grid Receitas Medicamento x Usuario - para que possa alterar o campo, caso constate que o item discriminado pelo usuário seja fornecimento direto ou não. 
• Image Added
• Na hora de gravar a análise de receita, caso o medicamento aprovado seja de fornecimento direto - os dados deverão ser clonados dessa análise, para a nova tela de Fornecimento Direto, para que seja possível sua geração, controle e rastreamento pela Operadora.

B) Tela de Fornecimento Direto 

Essa tela será a responsável por centralizar os dados do Fornecimento Direto, que serão utilizados para controle dos medicamentos/itens dados ao ao beneficiário e no monitoramento TISS.

A tela deverá conter os dados necessários, conforme schema da ANS, para envio do monitoramento, bem como os demais campos auxiliares para a Operadora e usuários, para as anotações devidas.

Abaixo, iremos descrever as tabelas utilizadas e o modelo em MVC, para a criação dessa nova tela:

• Alias disponíveis para uso - consultado ATUSX, Fontes e Trello. A sugestão de campos desses alias estarão disponíveis no final do documento. 

• As tabelas BJF e BJG serão preenchidas automaticamente, após o aceite do analista da Operadora, na tela de Cadastro de Receita.
  • Contudo, a nova tela deverá ter a opção de inserir os dados do cabeçalho e itens pela Operadora, pois nem sempre, a solicitação virá do cadastro de receita.
• O fonte da nova tela deverá ter o nome PLSFORDIR, para ligação mnemônica com o que a rotina propõe.
• Abaixo, um exemplo da rotina em MVC.
• Image Added

• Image Added

C) Importações – Tabelas

1. Após as validações acima, necessitamos gravar ou atualizar as seguintes tabelas:
   1. BR8 - Tabela Padrão
   2. BA8 - Tabela Dinâmica de Eventos
   3. BD4 - Unidade de Saúde
   4. BTQ – Tabela de Terminologias
   5. B6F – Tabela de Histórico de Importações realizadas
   6. BF8 - Tabelas de Honorários.
      1. A BF8 só será criada se no campo B6G_CRITDE estiver como SIM. Caso contrário, não será gravada
2. No arquivo SIMPRO® – temos o código próprio da SIMPRO® e para maioria dos itens, temos o código TUSS equivalente.
   1. Se não existir código TUSS no registro analisado, deve ser gravado ou atualizado na TDE própria (informado no cadastro de configuração – B6G);
   2. Se existir o código TUSS no registro, devemos verificar na TDE própria – informada no cadastro da configuração (B6G) – se temos o código SIMPRO® do item cadastrado e se está com a data de vigência finalizado. Se não estiver com data de finalização (BD4_VIGFIM), devemos finalizar a vigência, utilizando a data do ParamBox (Data da mensagem da SIMPRO®) menos 1 dia. Ou seja, se foi informado 10/10/2021, devemos subtrair um dia, colocando no campo BD4_VIGFIM o valor 09/09/20210. 
      1. Na sequência, verificar se já existe o código TUSS cadastrado, para inclusão ou alteração dos dados.
   3. Para cada registro gravado, no campo BD4_CHVIMP, deve ser colocado a chave de registro de relacionamento, com as informações “SIMPRO| + código da atualização + ”|” + Tipo do Procedimento + “|” + Tipo Valor”. Ou seja, é a concatenação dos campos “SIMPRO|” + código da atualização (mensagem) informada no ParamBox + “|“ + B6G_TIPPRO + “|” + B6G_TIPO. Simplificando, se foi informando no ParamBox o código da atualização 3321, e estamos importando um arquivo de Material (B6G_TIPPRO = 1) e o valor Preço de Fábrica (B6G_TIPO = 2), o campo BD4_CHVIMP vai receber o valor como: SIMPRO|3321  |1|2.  
   4. Se existir um BD4 para evento, e na chave de relacionamento (BD4_CHVIMP), o código da atualização for menor que o atual, essa vigência será finalizada com a data do ParamBox (Data da mensagem da SIMPRO®) menos um dia, para gravar a nova BD4 com a nova vigência, com os dados necessários.
      1. Só gravar se tiver alteração de valor.  Se os dados são iguais, mesmo em atualizações diferentes, não precisa executar o passo acima.
   5. Ao gravar os registros, criar ou atualizar os mesmos na Tabela de Terminologia BTQ, terminologia 64, conforme padrão TISS. Atualizar da seguinte maneira:
      1. BTQ_CODGRU - Se medicamento, gravar o valor "030". Para os demais, gravar "029".
      2. BTQ_DESGRU - Se medicamento, gravar o texto "MEDICAMENTO". Para os demais, gravar "MATERIAIS E OPME".
      3. BTQ_FENVIO - Gravar o texto "CONSOLIDADO".
         • Para conhecimento: Grupo 029 - MATERIAIS E OPME / Grupo 030 - MEDICAMENTOS
3. No final da importação, gravar os dados pertinentes na tabela B6F - Importações Brasíndice, para efeitos históricos e consultar os registros importados. 

D) Exclusão das Importações

1. O usuário pode deletar alguma importação realizada, bastando no browser do PLSSIMPRO posicionar no registro desejado e clicar no botão Excluir.  Contudo, temos algumas regras a serem seguidas:
   1. Ao solicitar a exclusão do registro posicionado, devemos garantir se é o último importado, pela sequência do campo BD4_CHVIMP, que armazena o código da mensagem (atualização) da SIMPRO.  Se tentar excluir qualquer um que não seja o último importado, o sistema deve proibir, de acordo com o tipo de produto e valor.
      1. Por exemplo, importei à atualização 3021 - Material - PFB e no outro mês, importei o 3121 - Material - PFB.
      2. Se tentar excluir o 3021 - Material - PFB, o sistema não deve deixar, pois existe atualização superior, que pode ter finalizado e criado novas BD4 com outros vigências.  No nosso exemplo, só podemos excluir o 3121 - Material - PFB, pois é a última importação.
   2. Caso possa excluir, conforme regra acima, devemos:
      1. Deletar os registros BD4 relacionados a essa importação, pelo campo de relacionamento BD4_CHVIMP.
      2. Após deletar o BD4 relacionado, devemos reabrir a vigência do último BD4 disponível para o item, seguindo a cronologia do campo BD4_CHVIMP.  
         • Se existir registro BD4 anterior, o campo BD4_VIFGIM deve ser limpo, para ser utilizado no sistema;
         • Se não existir nenhum BD4 anterior (imagine um item adicionado nessa versão excluída), a BA8 relacionada ao BD4 deve ser excluída, pois não pode existir um BA8 sem BD4;
         • Se a BA8 foi excluída, devemos atualizar na BR8 - relacionada ao registro da BA8 - o campo BR8_BENUTL como Não, já que o item não existe mais na BA8.
      3. Ou seja, como visto acima, a exclusão deve ser em "cascata", obedecendo aos critérios definidos.  Logo, se excluir uma BD4 e tiver outro registro BD4 para reabrir a vigência, apenas limpo a data final e o processo acabou por aí.  Se não, tenho que deletar os demais envolvidos, que é a BA8 e BR8, para manter a consistência dos registros.

...

• Layout CSV

...

...

ARQUIVO NO FORMATO CSV 

...

• Layout PDF para análise:

...

03. Tela de Importação / Configuração SIMPRO® 

Âncora
NEW NEW

...