Melhoria na validação/gravação da especialidade de arquivos XML TISS.

Descrição

Realizada melhoria no processo de gravação da especialidade de guias oriundas de importação XML. Todos os blocos e funções referentes à submissão/importação de XML que envolviam a interpretação do CBOs dos arquivos foram estudados e reescritos em novas funções. 

Introdução

Image Modified

No fluxograma acima podemos observar o início do processo de submissão/importação do XML que será explorado nessa documentação.
Com a TISS 3 existe A partir da versão 3 dos arquivos XML TISS o campo de CBOs se tornou obrigatório. Existe a necessidade de gravar a especialidade dos eventos executados com base no CBOS do Solicitante e Executante, tais informações são de suma importância em processos posteriores à importação XML, como por exemplo a validação de regras de cobertura das críticas 017 (Limite de Quantidade ultrapassada.) e 018 (Limite de Periodicidade ultrapassada.), uma vez que as mesmas podem ser parametrizadas para levar em consideração a especialidade enviada no atendimento, a incoerência nessas informações pode levar o sistema a negar ou autorizar um atendimento indevidamente.

Caminhos das tags de CBOs

Conforme ultima versão vigente dos SCHEMAS 3.02.01 dos schemas das guias TISS, esses são os caminhos em que o prestador pode enviar o CBOS nos diferentes tipos de guias XML tratados suportados pelo sistema:

Image Modified

Alterações realizadas

Antes de partirmos para as alterações realizadas nesse chamado, devemos entender os passos básicos no fluxo de processamento XML TISS dentro do sistema.

Submissão

Image Modified

Índice de funções envolvidas no processo:

PNewVldXML – Função principal de validação de arquivos XML superiores à versão 3.00.01.

PAjustUnic – Atualiza a matriz de dados únicos do XML.

PlsVarTISS – Cria as variáveis dinâmicas da tabela BVP (NOMEConfiguração Variáveis XML TISS).

PlsExecExp – Executa as expressões das criticas da tabela BVN (NOMEConfiguração da Validação do XML TISS).

PlTrCBOSUB – Função genérica para validação de criticas referentes ao CBOs enviados no arquivo.

PLCarCBOVar – Inicializa as variáveis dinâmicas referente às TAGs de CBOS e especialidade dos profissionais da guia.

LEGENDA:

Funções envolvidas

Funções alteradas

Funções criadas

As validações de CBOS CBOs no processo de submissão do XML se divide nas seguintes etapas:

PNewVldXML
Armazena todas as TAGS TAGs e dados do XML na matriz aDados. Toda a validação gira em torno dessa matriz pois o sistema carrega as críticas cadastradas na tabela BVN (NOME DA TABELA), e as executa conforme parametrização. (cTpVld).
Com o aDados inicializado o sistema monta uma outra matriz com dados únicos, ou seja, uma matriz que contém todos os dados do XML porém sem tags repetidas. Porém as tags de CBOs entram em uma exceção, já que as tags possuem o mesmo nome mas contém dados tanto do solicitante quanto do executante.

PlsVarTISS
Antes de iniciar o loop na matriz aDados, é feita a carga inicial de todas as variáveis dinâmicas utilizadas nas expressões das críticas da tabela BVN. Posteriormente, a cada loop que o sistema faz em cima da matriz aDados, é verificado se existe alguma TAG na chamada da expressão cadastrada na tabela BVP para que a variável seja atualizada antes da execução da regra de validação da crítica. Por exemplo: Se estou validando a TAG <ans:codigoProcedimento> e existe a variável CCODPRO que utiliza essa informação em sua expressão, o sistema chama novamente a função para atualizar os dados da variável dinâmica CCODPRO.

PLCarCBOVar

Image Modified
Função criada para inicializar o conteúdo das novas variáveis dinâmicas de CBOs e Especialidade (_CCBOSOL, _CCBOEXE, _CESPSOL, _CESPEXE, _CCODESP). A função identifica qual o tipo de dado solicitado no cadastro da tabela BVP, e faz a busca na matriz de dados únicos conforme o caminho definido no Schema schema do XML. 

PAjustUnic
A cada dado do XML validado, o sistema faz a chamada da função de ajuste da matriz de dados únicos para atualização de conteúdo.

PlsExecExp
Antes da chamada da função PlsExecExp, uma matriz é alimentada com todas as críticas existentes para a TAG em validação.
A partir dessa matriz, o sistema chama as funções de validação das críticas X25 e 047.
Critério para alimentar a matriz: caminho e nome da tag TAG que está sendo validada deve estar contida nos campos BVN_CAMTAG e BVN_TAG respectivamente. 

PlTrCBOSub

Image AddedImage Removed

Nova função genérica de validação de críticas de CBOs. Recebe os parâmetros cCodGlo, cCboExe, cCboSol, cCodEsp, cEspExe, cEspSol, aDadUser e cEspSolaDadPres.
O conteúdo da variável cCodGlo corresponde a crítica que está sendo analisada no momento e o restante são as variáveis dinâmicas definidas na função PLCarCBOVar.

047 - Especialidade bloqueada para esta RDA.

Validação Única: Retorna uma variável lógica informando se a especialidade enviada pelo executante está no cadastro de especialidades do Prestador (BAX). Caso a mesma não exista, existe a possibilidade de considerar as especialidades definidas no parâmetro MV_PESPPLA. 

As demais variáveis são informadas apenas para que o sistema atualize o valor de cada uma das variáveis dinâmicas da tabela BVP ao executar a expressão de validação. 

X25 - Especialidade não encontrada X25 - Especialidade nao encontrada no sistema com base no CBOS informado no arquivo.
Primeira Validação: Verifica se para o CBO enviado, existe vinculo De/Para cadastrado no sistema.
Segunda Validação: Verifica se para a especialidade retornada a partir do De/Para, o Profissional Executante a possui em seu cadastro. Também é feito o tratamento para o CBO não informado (Codigo de terminologia ‘999999’).
Se ambas validações retornarem o valor lógico Verdadeiro, o arquivo é acatado caso não haja nenhuma outra crítica pertinente a submissão.

X55 - Procedimento bloqueado na especialidade do Prestador.
Verifica se existe algum nível de parametrização (ex.: BBM - Padrao de Saude ou BE9 - Procedimentos por Produtos) ao qual está definido que o profissional não possui autorização para executar o procedimento de acordo com a especialidade enviada.

X59 - Especialidade bloqueada para este Prestador.
Verifica se a especialidade enviada está bloqueada no cadastro do Prestador. 

IMPORTANTE:

As validações e carga de variáveis levam em conta o estado do parâmetro MV_PLSCTES.

Essa função pode ser customizada, para maiores informações acesse este linkImage Added e confira a documentação do ponto de entrada PLTISESP.

Importação

Image Modified

Índice de funções envolvidas no processo:

PlsTpTran – Processa o arquivo conforme tipo de transação. 

PLSPCONGR – Retorna o conteúdo da TAG conforme caminho enviado.

PlsLGSP3 – – Processamento da importação do XML.

PlTrCBOIMP – Retorna os dados de CBOs e Especialidade do arquivo XML

PlRtCBOPath – Retorna o caminho da TAG solicitada.

PlRtEspPre – – Retorna a especialidade do prestador.

LEGENDA:

Funções envolvidas

Funções alteradas

Funções criadas

PlsTpTran 

Após interpretar o arquivo já submetido e salvo no banco de conhecimento, o sistema faz a chamada da função PlsTpTran para identificar qual o tipo de transação do XML. Essa função determina define qual o tipo de guia e qual a origem da solicitação, passo que determina como o sistema irá interpretar o arquivo XML de acordo com os diferentes tipos de guias definidos no schema.

PlsLGSP3

Função de leitura e gravação do arquivo XML. É basicamente composta por blocos de leitura e armazenamento dos dados do XML. A parte da leitura fica a cargo da função PLSPCONGR, que recebe a TAG e caminho da TAG como parâmetro e retorna o dado solicitado. Após a interpretação, o dado é armazenado em duas outras matrizes dependendo da natureza da informação (cabeçalho ou item), que posteriormente são utilizadas para a gravação dos dados na base. Nos blocos de interpretação do XML foram incluídas chamadas para as novas funções de retorno do CBOs. O retorno dessas funções, diferente do restante das informações do XML, são armazenados em duas matrizes (cabeçalho e item) exclusivas para a gravação das especialidades. Posteriormente essas matrizes são salvas nas principais de maneira bilateral.

PlTrCBOIMP

Image Modified

Retorna uma matriz com o CBOs e Especialidade do tipo de dado solicitado (Executante/Solicitante).

PlRtCBOPath

Recebe como parâmetro qual a origem da transação, tipo de dado solicitado (Executante/Solicitante) e tipo de guia, dados que irão definir qual o caminho da TAG que o CBOs deve ser pesquisado.

PLSPCONGR

Após definir qual o caminho da tag, busca na matriz com os dados do XML a informação solicitada e assim que encontrada, é feito o De/Para com a tabela de terminologias TISS 24 para localizar a especialidade correspondente no sistema. Feito isso, a função retorna a matriz de duas posições, sendo a primeira a especialidade e a segunda o CBOs.

PlRtEspPre

Image Modified

Retorna a especialidade do prestador respeitando a seguinte lista de prioridades:

1ª Especialidade enviada pelo executante está contida no cadastro de especialidades do Prestador (BAX), utiliza a mesma.
2ª Especialidade enviada pelo executante NÃO está no cadastro de especialidades do Prestador (BAX), verifica se o prestador possui alguma especialidade contida no parâmetro MV_PESPPLA.
3ª Especialidade principal do prestador
4ª Primeira Especialidade encontrada no cadastro do prestador

IMPORTANTE: Se o parâmetro MV_PLSCTES estiver desativado, o sistema irá buscar somente a especialidade cadastrada no local de atendimento identificado através do CNES enviado no arquivo. Caso contrário, o sistema traz todos as especialidades do Prestador.

O valor retornado nessa função é adicionado à posição 3 da matriz exclusiva de especialidades.

PLSXAUTP

Após consistir todos os dados nas matrizes de cabeçalho e item, os dados são transferidos para a função PLSXAUTP responsável pela gravação da guia. Após realizar a gravação de todos os demais itens da guia, cada função de gravação faz a chamada da função PlGrvEspXML, nova função criada para realizar consolidar os dados de especialidade das guias.

PlGrvEspXML

Recebe como parâmetro o alias da tabela que está sendo gravada e para cada alias, existe um tratamento diferente definido na tabela abaixo:

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

Versão 11

1. Aplique o patch do chamado e execute a rotina Versões TISS 
2. Selecione a a versão desejada e clieque clique em Ações Relacionadas/Recarregar
3. Leia atentamente o alerta exibido
   1. Confirme se estiver de acordo.
4. As tabelas referente a submissão dos arquivos TISS serão recarregadas.

Versão 12

1. Aplique o patch do chamado e execute a rotina PLSWIZARD 
2. Realizar o backup da base de dados do ambiente que será atualizado (\PROTHEUS12_DATA\DATA).
3. Descarregue os arquivos '*.CSV' contidos no pacote do chamado na diretório do PLSWIZARD (\PROTHEUS12_DATA\PLSWIZARD)
   O diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
4. Siga a orientação do wizard do programa.
5. As tabelas referente a submissão dos arquivos TISS serão recarregadas.