Histórico da Página

CONTEÚDO

1. Visão Geral
2. Detalhamento
3. Nova tela de controle de DPS
   
4. Novas tabelas
   
5. Tabelas utilizadas

01. VISÃO GERAL 

Âncora
VIS VIS

      A presente especificação visa detalhar as regras para importação dos arquivos SIMPRO® no módulo SIGAPLS, para efeitos de pagamento/cobrança dos prestadores.  A tabela SIMPRO®, segundo o site, é "um banco de dados de materiais e medicamentos, utilizado como referência de informações (preço, apresentação, registro Anvisa, código tuss, classificação, embalagem, e outros), destinada , direcionado a compras, faturamento, licitações, análise e auditoria de contas médico-hospitalares" (site: https://www.SIMPRO®.com.br/PortalPages/CentralClientes/DuvidasFrequentes.aspx, pesquisado em 30/08/2021).

      Por se tratar de tema técnico e inicial, a presente especificação pode passar por atualizações em seu conteúdo e durante o desenvolvimento, visto que passará por diferentes crivos de análise e testes diversos, de forma a enriquecer o material e entrega da funcionalidade.

02. Detalhamento 

Âncora
ATUAL ATUAL

A) Configurador de Importação – Tabela B6G (Configurações Brasíndice®)

Atualmente, devido a importação da tabela Brasíndice®, já temos tela de configuração de importação, para facilitar o processo de importar os arquivos.  Vamos utilizar o mesmo conceito e tabela, para realizar as mesmas configurações para a SIMPRO®, mas observando as seguintes diferenças:

1. Criar fonte exclusivo para a importação da SIMPRO®, com o nome PLSSIMPRO.PRW.
   1. Utilizar neste fonte o conceito de herança do MVC, onde devemos herdar as características do fonte PLSBRASIN1 e realizar os devidos ajustes.   Para gerdar a MODEL, basta na 
2. Pelo manual e layout, o sistema VideoFarma® permite que todos os itens – independente se é um medicamento ou material, sejam, exportados em arquivo único, permitindo sua diferenciação por uma classificação própria, no campo CD_MERC, onde: 
   • (20) Material Hospitalar
   • (50) Medicamentos
   • (70) Perfumaria
   • (90) Reagentes
   • (30) Saneantes
3. Contudo, como necessitamos saber em qual TDE o item será importado - para quando houver codificação TUSS ou não – será necessário a configuração individual para cada item a ser importador.  Ou seja, devemos ter um registro na B6G para cada tipo de material, medicamento, perfumaria, reagente ou saneante a ser importado.
   • Deixar claro no Documento de Referência que não deve ser gerado arquivo único, mas um individual para cada item a ser importado.  E se mesmo assim gerar um arquivo único, todos os itens serão importados para a tabela no qual ocorrer o match, sem diferenciar medicamento ou material pelo tipo de registro.
4. Com relação os itens Perfumaria, Reagentes e Saneantes, esses itens deverão ser incluídos no combo do campo B6G_TIPPRO.
5. O campo B6G_TIPARQ fica oculto na VIEW, ao visualizara tela de configuração. Assim:
   • O campo agora deverá ficar visível na VIEW e no browse de configuração;
   • Identificar de forma automática de qual menu foi a chamada, para colocar no campo B6G_TIPARQ o cadastro correspondente. Por exemplo, se a ação originou na tela da Brasíndice® (PLSBRASIN1), colocar no campo B6G_TIPARQ o valor 1=Brasíndice®. Se originou na SIMPRO® (PLSSIMPRO), colocar 2=SIMPRO®.
6. Será necessário revisar o fonte de Configuração de Importação (PLSBRASIN2), pois temos regras específicas do Brasíndice®, que não consideram o campo B6G_TIPARQ para validar, como as funções AtuCmpVal (que deve considerar agora o campo B6G_TIPARQ para validar apenas Brasíndice®); a função ChkVlrDup (que possui query para evitar itens repetidos com o mesmo tipo de material e valor, onde deverá verificar o campo B6G_TIPARQ, não mais apenas 1=Brasíndice®).
7. Validar na tela o que é pertinente a cada item:
   • Se estou cadastrando um item Brasíndice®, não posso usar as opções Reagentes / Saneantes / Perfumaria (B6G_TIPPRO), bem como a opção Preço Usuário (B6G_TIPO);
   • Se estou cadastrando SIMPRO®, não posso usar a opção Soluções.
   • Demais regras que existem para a Brasíndice®, como para Soluções e Materiais usar apenas Preço de Fábrica devem ser mantidas para Brasíndice®.
     • Solução: manipular o conteúdo do CBOX do campo B6G_TIPPRO, para exibir apenas as opções pertinentes para cada cadastro: Exemplo: cadastro no X3_CBOX as novas opções de Perfumaria / Saneantes / Reagentes, ficando 1=Materiais;2=Medicamentos;3=Soluções;4=Perfumaria;5=Saneantes;6=Reagentes;  
     • Na VIEW do PLSBRASIN2, manipular para exibir apenas as opções pertinentes para cada tipo de tabela, pelo atributo MVC_VIEW_COMBOBOX, onde podemos passar esse atributo, seguido de um array ou função. Nesse caso, passar uma função, que vai recuperar os valores do X3_CBOX do campo B6G_TIPPRO - GetSx3Cache("B6G_TIPPRO","X3_CBOX") e na função, tratar o retorno do campo de acordo com a tabela selecionada -  SIMPRO® ou Brasíndice®.
     • https://tdn.totvs.com/pages/releaseview.action?pageId=6815033 -> GetSx3Cache
8. Com relação aos valores, a SIMPRO® permite exportar o Preço de Fábrica (PFB), o Preço Máximo ao Consumidor (PMC) e iremos incluir o Preço do Usuário (PUSU), no campo B6G_TIPO.
   • O controle do campo deve ser efetuado igual ao do campo B6G_TIPPRO, para exibir de forma correta somente para a SIMPRO® a opção Preço do Usuário.
   • Como na Brasíndice®, temos também a possibilidade de preço total ou fracionado, informado no campo B6G_TIPVAL.  que será idêntico na SIMPRO®. Na parte xxx, iremos detalhar melhor os itens do layout.
9. Demais regras e campos serão mantidos de forma igual.
10. Ao acionar a opção de Configurar pela tela da Brasíndice® – PLSBRASIN1 – as configurações que deverão ser exibidas no Browse deverão ser apenas Brasíndice®. Se acionei a opção Configurar via tela SIMPRO® – PLSSIMPRO, no browse devem ser exibidos apenas os itens da SIMPRO®, usando o campo B6G_TIPARQ para este fim.

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 Deverá , deve ser exibido um paramboxParamBox, 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® (deverá ser igual ao do campo mensagens, existente no sistema VideoFarma) VideoFarma®), seguido dos dois últimos dígitos do ano (OBRIGATÓRIO);
      1. Para cada atualização enviada, temos um código da VideoFarma VideoFarma® – como a edição na Brasíndice®.  Deverá ser colocado esse código aqui, 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 -1 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 para os itens nos status 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, a saída encontrada foi ter o campo para 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 paramboxParamBox, 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 deverá 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 nenhumanenhum 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 sem match com regrasque não batem com nenhuma regra existente, e na outra segunda coluna, será exibido um combobox, exibir 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
         deverá
         • deve ser exibida
         essa janela de escolha manual
         • , pois conforme item
         B
         • II acima, uma regra só pode ter um arquivo relacionado.
         Logar
         • Registrar essa inconsistência, para exibir no final do processamento para o usuário.

...

1. 1. 1. • Essas opções

...

1. 1. 1. • e janela existem na importação da Brasíndice®, no PLSBRSIN1.
2. Criar rotina específica para leitura dos arquivos txt TXT e csv CVD da SIMPRO®, baseado no da Brasíndice®.
   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 -> FwFileReaderUtilizar o StrTokArr2 para criar o array baseado na string.
3. Realizar o parser 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.
4. No final da importação, exibir um resumo dos arquivos importados, com problemas e registros não válidos, caso aconteça.

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® – similar ao Brasíndice® – 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 pergunte 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.
      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® “SIMPRO| + código da atualização + ”|” + Tipo do Procedimento + “|” + Tipo Valor”. Ou seja, é a concatenação dos campos “SIMPRO®“SIMPRO|” + código da atualização (mensagem) informada no parambox 621ParamBox + “|“ + B6G_TIPPRO + “|” + B6G_TIPO, ficando, por exemplo: “SIMPRO®|721 |1|2”. 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 atual -1, e 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 ados dados são iguais, mesmo em edição diferente, não precisa executar o passo acima.
   5. Ao gravar os registros, criar ou atualizar os mesmos na tabela Tabela de terminologia Terminologia BTQ, terminologia 64, conforme padrão TISS. Deve indicar na BTQ o código do Grupo (029 - MATERIAIS E OPME e 030 – MEDICAMENTOS).
      1. Medicamentos – 030
      2. Material – 029

• Perfumaria / Reagentes / Saneantes - 029

03. Nova tela de Controle de DPS 

Âncora
NEW NEW

04. Tabelas  

Âncora
ALTER ALTER

• Não será necessário criar nenhuma tabela nova, apenas modificar as existentes, para se adequar ao processo da SIMPRO®.

05. TABELAS UTILIZADAS 

Âncora
TAB TAB

• SF1 - Cabeçalho das NF de Entrada
• SD1 - Itens das NF de Entrada
• SA2 - Fornecedores
• BQ2 - Cabeçalho da DPS
• BQ3 - Detalhes da DPS
• BQ4 - Histórico e Logs DPS

...