Validações no Foundation e Outras Melhorias

Características do Requisito

Descrição

Foram criadas validações no processo de "upload de XML", para que o arquivo enviado pelo prestador seja verificado antes da geração do protocolo. Além disso outras melhorias no processo foram realizadas. Importante salientar que tais melhorias valem para instalações do Foundation, integradas com o sistema Gestão de Planos de Saúde.

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).

Observação: A implantação do pacote deve criar a nova tabela WS_TISSLOG_INVOICE, necessária para a funcionalidade Pesquisa por Número da Guia do Prestador (Pesquisa Lotes).

Importante:

O recurso só estará funcional se utilizar  o sistema Gestão de Planos de Saúde na versão 12.1.9 ou superior e com bancos unificados.

Antes de executar a atualização é recomendável realizar o backup do banco de dados bem como dos arquivos do Sistema (executáveis, .dlls e arquivos de configuração).

Realizar a atualização antes no ambiente de homologação e posterior a devida validação, no ambiente de produção.

Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS

Validações do arquivo XML enviado (Upload XML)

A partir dessa implementação, o Foundation Saúde, que estiver integrado ao GPS, não realizará a leitura das regras definidas pelo arquivo "tissrules.xml". A configuração de quais regras serão executadas é de opção do cliente, o que pode ser realizada no arquivo <JBoss>/server/<instancia>/deploy/properties-service.xml, com as seguintes propriedades:

• tiss.validation.dataFaturamento=true
  • valida se as tags dataInicioFaturamento e dataFimFaturamento das guias de Resumo de Internação são anteriores à postagem do XML e se a data de início é anterior à final;

• tiss.validation.dataSolicitacao=true
  • valida se a tag dataSolicitacao das guias SADT são anteriores à postagem do XML;

• tiss.validation.dataAutorizacao=true
  • valida se a tag dataAutorizacao das guias SADT, Odonto e Resumo de Internação são anteriores à postagem do XML;

• tiss.validation.dataEmissao=true
  • valida se a tag dataEmissaoGuia das guias de Honorários são anteriores à postagem do XML;

• tiss.validation.dataAtendimento=true
  • valida se a tag dataAtendimento das guias de Consulta são anteriores à postagem do XML;

• tiss.validation.guiaPrestadorDuplicada=true
  • valida a inexistência de guias em duplicidade pela tag numeroGuiaPrestador;

• tiss.validation.guiaPrestadorIgualPrincipal=true
  • nas guias SADT, é validado se o número da guia do prestador (tag numeroGuiaPrestador) não é igual ao número da guia principal (tag guiaPrincipal), caso este tenha sido informado;

• tiss.validation.guiaPrincipal=true
  • nas guias SADT, é validado se o número da guia principal (tag guiaPrincipal) contém somente números;

• tiss.validation.beneficiarioDaBase=true
  • se os 4 primeiros dígitos do campo documento do beneficiário (tag numeroCarteira) indicarem que o beneficiário é da operadora, então o documento existe na base;

• tiss.validation.tipoAtendimentoMO=true
  • é validado se o tipo de atendimento (tag tipoAtendimento) está entre 14 e 21 (conforme tabela TISS) caso os 4 primeiros dígitos do campo documento do beneficiário (tag numeroCarteira) indicarem que o beneficiário é da operadora e se a modalidade do beneficiário é de Medicina Ocupacional;

• tiss.validation.beneficiarioForaDigitoVerificador=true
  • se os 4 primeiros dígitos do campo documento do beneficiário (tag numeroCarteira) indicarem que o beneficiário não é da operadora, é validado o dígito verificador do documento;

• tiss.validation.procedimento.dataExecucao=true
  • valida se a tag dataExecucao de cada procedimento das guias SADT, Odonto, Resumo de Internação e Honorários são anteriores à postagem do XML;

Importante: A ausência da propriedade no arquivo ou a configuração de qualquer outro valor que não seja "true", indicará que a regra está desativada.

A imagem abaixo ilustra como ficará o arquivo "properties-service.xml".

Período de Movimentação (Upload XML)

Foi criado o novo parâmetro "Visível no Foundation" no programa Manutenção Períodos Movimentação (RC0110N), para indicar se o período deve ficar visível na tela de Upload XML do Foundation.

Procedimento para Utilização

Validações do arquivo XML enviado (Upload XML)

Após a operadora definir e configurar quais regras serão ativadas, o Foundation validará os arquivos XML enviados pelo prestador através do programa Upload XML. O resultado da validação é uma mensagem para o usuário na mesma tela de upload com o seguinte formato:

Guia do prestador xxxxxxxxxxxxxx
Código da glosa TISS - mensagem de erro (todos os erros encontrados na guia)
Nome do campo relacionado ao erro e seu respectivo valor (todos os campos necessários)

Exemplo:

Arquivo [ TISS_V3_02_01_SADT.xml] : O XML enviado contém erros e não pode ser processado. Confira os erros abaixo.
Guia do prestador 20140718000000000051 com o(s) seguinte(s) erro(s)
1001 - Cartão do beneficiário da operadora não cadastrado
2701 - Procedimento executado/realizado não encontrado ou fora da vigência
Cartão do beneficiário: 01202900001123029
Código da tabela: 22
Código do procedimento: 28040481
Descrição do procedimento: CONSULTA EM CONSULTORIO

Guia do prestador 20140718000000000051 com o(s) seguinte(s) erro(s)
1308 - Número da guia do prestador duplicado
1001 - Beneficiário de intercâmbio com carteira inválida
1323 - Data da execução posterior à postagem do XML
Cartão do beneficiário: 0122360100006000015
Código da tabela: 22
Código do procedimento: 10101012
Descrição do procedimento: CONSULTA EM CONSULTORIO
Data da execução: 2016-07-01

Guia do prestador 20140718000000000051 com o(s) seguinte(s) erro(s)
1308 - Número da guia do prestador duplicado
1602 - Tipo de atendimento inválido para beneficiário de Medicina Ocupacional
Cartão do beneficiário: 01202900001000029
Tipo de Atendimento: 05

Abaixo um exemplo da tela de Upload de XML após a postagem de um arquivo.

Período de Movimentação (Upload XML)

Ao abrir a tela de Upload de XML, a lista de Períodos de Movimentação retorna com os registros cadastrados em aberto e que estejam com o campo "Visível no Foundation" configurado como "Sim" no programa Manutenção Períodos Movimentação (RC0110N).

Pesquisa por Número da Guia do Prestador (Pesquisa Lotes)

Foi incluído o campo "Nº da Guia do Prestador" que permite ao usuário localização de lote que contenha o número de guia informado.