01. DADOS GERAIS


Linha de Produto:Datasul
Segmento:Saúde
Módulo:Gestão de Planos de Saúde
Função:

Manutenção de Guias (AT0110Z)

Autorização Guias pelo Auditor/Responsável (AT0110J)

Consulta Trans. Negadas - IE (AT0110T)

Comunica Guias Pendentes (AT0110V)

Consulta Status da Transação (AT0110P)

Consulta Dados do Beneficiário (HAT.BENEFICIARIESEXCHANGEQUERY) 

Consulta Dados do Prestador (AT0110S)

Contagem de Beneficiários (HAT.COUNTBENEFICIARIES)

Comunicação de Beneficiários - TISS (AT0110N)

Auditoria Médica Web

Issue:

02. SITUAÇÃO/REQUISITO


As implementações descritas neste documento correspondem as adequações efetuadas no TOTVS Saúde Planos - Linha Datasul para atender ao PTU Online 9.0.

03. SOLUÇÃO


Procedimentos 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) e também na console de atualização.

Para funcionamento correto das rotinas liberadas neste pacote, deverão ser garantidas a aplicação das atualizações referentes ao Banco de Dados.

Importação de Menus

Neste projeto houve a descontinuação e criação de novos menus, por isso é necessário que seja realizada a importação dos menus alterados.

No TOTVS12, acesse o programa Importação Menu Datasul (MEN706AA).
Importe os seguintes arquivos:

  • univdata\men_hat.p
  • univdata\men_hgp.p


Para mais informações de como importar menus no Datasul, verificar a pagina: Importação Menu Datasul (MEN706AA)


Alterações realizadas em cada um dos menus:

Carga novo campo Associativa Insumo Gestão Planos x PTU


Foi desenvolvida também uma SPP de atualização (sp-atualiza-ptuinsum-tabela-exp.p) para poder facilitar o preenchimento do campo "Código Tabela Exportação", que será apresentado na Manutenção Associativa para Conversão Insumo Gestão Planos x PTU (RC0510R).

Abaixo é detalhado como executar este programa de carga.

No TOTVS, executar o programa "Rodar Programa Progress" (htexcpro).

Deverá ser informado o programa de carga que deseja executar, neste caso o "sp-atualiza-ptuinsum-tabela-exp"

Nesta opção o usuário pode escolher o diretório e o nome do arquivo no qual será gerado os relatórios da execução.

Por padrão é gerado um relatório ".CSV" contendo as informações dos registros que foram atualizados. 

Na opção de seleção, serão apresentados em uma lista todos os tipos de insumos já cadastrados no sistema e que possuem pelo menos um registro vinculado no cadastro Manutenção Associativa Conversão Insumo Gestão de Planos x PTU(RC0510R) com o campo "Tipo Associativa" parametrizado como "Exportação" ou "Ambos".

Ao selecionar uma das linhas, deverá ser pressionado o botão "ENTER", para que seja aberta uma nova tela. Nesta tela, o usuário poderá informar o novo valor do campo "Código Tabela Exportação" (apenas valores válidos no domínio da TISS atual), que será assumido para todos os registros do cadastro que possuírem, além das situações descritas acima, seu respectivo insumo estiver vinculado a tabela "00 - Tabela Própria" na Manutenção Insumos (RC0110C).

Ao selecionar a opção de geração é apresentada uma mensagem, informando ao usuário que os registros da lista de "Tipo Insumo" que não foram preenchidos com o novo valor da "Tabela de Exportação", não serão considerados no processo de atualização.

Ao confirmar a mensagem é realizada a atualização dos dados e gerado o relatório de acompanhando dos dados alterados no diretório informado na opção Arquivo.

Todas as alterações descritas neste item foram necessárias devido a regras impostas pela Unimed do Brasil em seus manuais e comunicados.

Para mais informações poderá ser consultado os manuais e comunicados no site http://www.unimed.coop.br/

Domínios Tipo de Tabela

Na nova versão do PTU foram alteradas as tabelas utilizadas para trafegar nos serviços médicos (insumos, procedimentos e pacotes).

Os dados contidos no cadastro Manutenção Associativa Tabela Serviços x Tipo Insumo (hrc0410h) passam a ser inutilizado no PTU Online 8.0. 

A tag passa a respeitar os domínios da TISS:

Diferenças entre as tabelas do PTU Online 7.0 x Tabela PTU Online 8.0:

Descrição

Tabela PTU Online 7.0

Tabela PTU Online 8.0

TUSS Procedimentos022
Serviços hospitalares / Taxas / Complementos118
TNUMM Materiais200
TUSS Materiais519
TNUMM Medicamentos300
TUSS Medicamentos620
Serviço com custo fechado (Pacotes)498
Tabelas PrópriasNão existe00


A partir desta versão, será utilizado para preenchimento desta tag "tipoTabela" os valores parametrizados nos cadastros de movimentos.

  • Pacotes: Sempre será enviado o valor "98 - Tabela Própria de Pacotes";
  • Procedimentos: Será utilizado o valor do campo "Tabela TISS 3.0";

  • Insumos: Será utilizado o valor do campo "Codigo Tabela";



Modificações realizadas nas transações do PTU Online 9.0

Realizado ajustes ao solicitar e receber Autorizações com a nova quantidade de serviço que foi alterada de 3,4 para 5,4.

Todas as alterações descritas neste item foram necessárias devido a regras impostas pela Unimed do Brasil em seus manuais e comunicados.

Importante: Alterado as entradas de movimentos no Autorizador e AT e Auditoria Médica e Webservices para insumos, ou seja, as tabelas (18, 19, 20 e 00) para que possa ser informando a nova quantidade (99999.9999). 


O TOTVS Saúde Planos - Linha Datasul irá processar estas transações da seguinte maneira:

As transações que sofreram alterações com o novo tamanho de "quantidadeServico":

  • Transação: 00600 – Pedido de Autorização
  • Transação: 00605 – Pedido de Complementação de Autorização
  • Transação: 00806 – Ordem de Serviço
  • Transação: 01101 – Resposta da Consultas transações Respondidas pelo WSD - respostaA1101WS

Detalhe do manual PTU 9.0(se repete na transações acima)


Retirada de campos da tela e Inclusão de novos campos "Nome" e "Idade do Beneficiário"

Foram disponibilizados novos campos no PTU , ajustamos o sistema para que esteja apto a enviar e receber os dados do Beneficiário de acordo com o novo manual:

  • Consulta Dados do Beneficiário (hat.beneficiariesexchangequery)
    1. Retirada dos campos:
      Nome do Beneficiário
      Data de Nascimento
      CNS
      Sobrenome

    2. Inclusão dos Campos:
      Nome 
      Idade do Beneficiário

Campos INCLUIDOS Transação: 00413 – Resposta da Consulta de Dados do Beneficiário


Alteração "descricaoServico" 

A nova regra para a descrição de serviço que apenas deve ser enviada para códigos genéricos.

Detalhe do manual PTU 9.0


Transações que foram alteradas conforme a regra para preenchimento:

  • Transação: 00600 – Pedido de Autorização
  • Transação: 00501 – Resposta de Pedido de Autorização
  • Transação: 00404 – Resposta de Auditoria
  • Transação: 00605 – Pedido de Complementação de Autorização
  • Transação: 00361 – Resposta do Status da Transação
  • Transação: 00806 – Ordem de Serviço
  • Transação: 00804 – Autorização de Ordem de Serviço
  • Transação: 01101 – Resposta da Consultas transações Respondidas pelo WSD - respostaA1101WS (remover mesmo se for genérico)

Importante:

  • Alterada rotinas do sistema para que a descrição do insumos APENAS seja enviada quando o mesmo for GENÉRICO e respeitado o parâmetro "Exporta Descrição do Insumo no PTU". 
  • Caso o insumo seja marcado como genérico e o campo "Exportar Descrição do Insumo no PTU" esteja marcado como:
    Somente PTU Batch ou Nenhum, então deve ser gerado um erro na solicitação.
  • Caso o insumo seja marcado como genérico e o campo "Exportar Descrição do Insumo no PTU" esteja marcado como:
    Ambos(Online e Batch) ou Somente PTU Online, então  nesse caso a descrição deve ser envida sem apresentar erro.
  • Casos onde o insumo é genérico, e o campo "Exporta Descrição do Insumo no PTU" estiver marcado como Ambos(Online e Batch) ou Somente PTU Online deve ser possível informar a descrição do insumo.

Campo Token

O campo token foi alterado aumentando seu numero de caracteres para 10 dígitos.

O Token de validação do beneficiário é utilizado para validar a autenticidade do beneficiário. Seu preenchimento é opcional e deverá ser preenchido sempre que a Unimed Origem do beneficiário validar a informação, pois o mesmo é trafegado nas seguintes transações:

  • 00600 – Pedido de Autorização
  • 00605 – Pedido de Complementação de Autorização
  • 00412 – Consulta de Dados do Beneficiário
  • 00750 – Comunicação de internação ou alta do beneficiário


Atualmente no TOTVS Saúde Planos - Linha Datasul, ainda não realiza a validação do campo para seus beneficiários e permite o preenchimento do campo para beneficiários de intercâmbio. 


Procedimentos para Configuração


Todas as etapas descritas nos itens a seguir, deverão ser realizadas para parametrização correta do Intercâmbio Eletrônico.

Foundation

Para facilitar a leitura todas as instruções de implantação e configuração do Foundation Saúde para o PTU Online 8.0, foram disponibilizadas na página PTU ONLINE 8.0 (Foundation).

Autorizador

Novas Propriedades Criadas no Autorizador para PTU Online 8.0 e Software de Pacotes:

PropriedadeDescrição

com.totvs.saude.wac.insurance.syncBenef 

Define se será exibido o botão Sincronizar o beneficiário na tela de checkin com beneficiário de intercambio e também o botão de Consultar Unidade na tela de cadastro de beneficiário de intercambio.

com.totvs.saude.guide.internmentExtension.sugestPackages 

Propriedade que indica se os pacotes serão sugeridos ao buscar procedimentos que estiverem contidos nos pacotes, na prorrogação de internação.

com.totvs.saude.guide.internment.sugestPackages

Propriedade que indica se os pacotes serão sugeridos ao buscar procedimentos que estiverem contidos nos pacotes, na solicitação de internação.


Nova funcionalidade para Sincronizar ou Consultar os Dados de beneficiário de intercambio através do autorizador, a documentação está disponível na página Consulta Beneficiários de Intercâmbio.


Parâmetros Globais do Sistema

No TOTVS12, acesse o programa Manutenção Parâmetros Globais Sistema - PR1410P:

Após efetuar a alteração desses parâmetros, deverá ser comunicado a Unimed do Brasil para que a Versão PTU utilizada pela operadora seja alterada na Ferramenta WSD, de 7.0 para 8.0.


a. No campo "Versão do PTU", deverá ser informado a nova versão "6 - 8.0".
b. No campo "URL de Comunic.", deverá ser informado o novo endpoint do PTU Online 8.0 parametrizado no Foundation. Deverá ser informado o endpoint "WsdPtuSenderWSv8000?wsdl", conforme exemplo: http://<servidor>:<porta>/htz-foundation/WsdPtuSenderWSv8000?wsdl.
c. No campo "Namespace", informar o valor "http://implementation.v8000.ws.exchange.foundation.totvs.com/".


Ajustes CPCs

Para os clientes que utilizam programas CPC no processo do PTU Online deverão atentar-se para as orientações abaixo:

As orientações a seguir são obrigatórias para o funcionamento correto das CPCs, as mesmas se fazem necessárias devido a implementações realizadas e versionamento das rotinas do produto.

Todas as CPCs que tenham ação relacionada ao processo de envio ou recebimento de transações PTU, deverão obrigatoriamente compiladas para que utilizem as includes disponibilizadas no pacote. Dentre estas CPCs é possível citar:

  • CPCs CPC-ATAPI023.P;
  • CPC-API-SOLICITAFOUNDATION.P;
  • CPC-API-RECEBE-PTU80.P;
  • CPC-AT0115C.P;
  • CPC-AT0115C-IE.P
  • CPC-ATAPI023.P:

Caso seja utilizada a CPC-ATAPI023.P contendo a definição da include de linha "atp/atapi023-ptu70.i", deverá ser alterada a mesma de modo que passe a utilizar a nova include "atp/atapi023-ptu80.i".

  • CPC-API-RECEBE-PTU70.P:

Caso seja utilizada a CPC-API-RECEBE-PTU70.P:

a. Deverá ser efetuada cópia do programa original, renomeando-o para CPC-API-RECEBE-PTU80.P;

b. Dentro do fonte do programa CPC, deve ser alterada a definição da include cpc/cpc-api-recebe-ptu70.i para cpc/cpc-api-recebe-ptu80.i;

c. Substituir os trechos de código que fazem uso das temporárias tmp-cpc-api-recebe-ptu70-entrada e tmp-cpc-api-saida-ptu70-saida, sendo alterados para tmp-cpc-api-recebe-ptu80-entrada e tmp-cpc-api-saida-ptu80-saida, respectivamente;

d. Caso o programa específico utilize a definição da include de linha atp/atapi023-ptu70.i, esta deve ser alterada de modo a passar a utilizar a nova include atp/atapi023-ptu80.i. 

e. Os trechos de código que fazem uso da temporária tmp-atapi023-ptu70-serv-saida devem ser alterados para tmp-atapi023-ptu80-serv-saida;

f. Caso o cliente possua algum programa específico que utilize a include atbo/boptutransactionstatus.i, o campo serviceType da tabela temporária transactionstatusServicesOutput teve seu tipo de dado alterado de INTEGER (int) para CHARACTER (char).

Manutenção Associativa Conversão Insumo Gestão de Planos x PTU

Para preenchimento do campo novo foi desenvolvido a SPP de carga "sp-atualiza-ptuinsum-tabela-exp.p", descrita na seção de Implantação deste documento.


O programa Manutenção Associativa Conversão Insumo Gestão de Planos x PTU (RC0510R) foi alterado para que seja solicitado o preenchimento do campo "Código Tabela Exportação", apenas quando o "Tipo de Associativa" for igual a Exportação ou Ambos.
Abaixo segue um exemplo de ajuste neste novo campo:


Procedimentos para Utilização


Trafegando serviços (Procedimentos, insumos e pacotes)

Devido as mudanças no campo "tipoTabela" e "codigoServico", foram necessários alguns ajustes nas rotinas de solicitação e envio de transações do PTU Online.

Nas seções a seguir, serão apresentadas estas alterações.


Solicitando transações

Procedimento:

Os procedimentos assinalados como 'Pacote fechado' no programa Manutenção de Procedimentos (hpr0110h), NÃO serão considerados como pacotes no PTU Online 8.0. 

A partir das regras da Unimed do Brasil, todo o pacote trafegado, deverá estar obrigatoriamente cadastrado no SISPAC.


  • Para procedimentos o campo tipo de tabela será preenchido considerando o valor do campo "Tabela TISS 3.0" no programa Manutencao Procedimentos (hpr0110h).

    Exemplo de como ficará os insumos, conforme regras descritas acima.

    Insumo

    Tabela TISS PR0110H

    Tabela Enviada

    Serviço Enviado

    99999999222299999999
    9999999800002299999998


XML da Solicitação de Autorização - 00600.

XML da Solicitação de Autorização - 0600.

Insumos:

Para o tráfego dos insumos, o sistema passa a considerar o valor informado no campo "Código Tabela" do programa Manutenção Insumos (hrc0110c) para exportar no campo "tipoTabela" do PTU.

Exemplo de como ficará os insumos, conforme regras descritas acima.

Insumo

Tabela TISS RC0110C

Tabela Ptuinsum RC0510R

Tabela Enviada

Serviço Enviado

9999999918--1899999999
999999980018001899999999

Ambas as situações, descritas abaixo, continuaram realizando a conversão do código do insumo através dos valores parametrizados na Manutenção Associativa Conversão Insumo Gestão Planos x PTU (RC0510R)


  • Insumos TUSS:

Será considera como um insumo TUSS quando o mesmo insumo estiver parametrizado com um dos tipos de tabela:

    • 18 = TUSS Taxas hospitalares, diárias e gases medicinais
    • 19 = TUSS Materiais
    • 20 = TUSS Medicamentos 

Neste caso será enviado na transação o valor do tipo de tabela parametrizado e o serviço contendo 8 dígitos.


Associativa insumo PTU para o insumo 00000014.


Sistema exportou código de tabela do insumo GP e o código do insumo igual ao código do insumo PTU parametrizado.

  • Insumos Próprios:

Será considera como um insumo próprio quando o mesmo insumo estiver parametrizado com o tipo de tabela 00 - Tabela Própria da Operadora.

Neste caso será enviado na transação o valor do tipo de tabela parametrizado e o serviço contendo 10 dígitos (dois primeiros dígitos igual ao tipo de tabela TISS correspondente na Manutenção Associativa Conversão Insumo Gestão Planos x PTU e os 8 dígitos restantes o código do insumo).

Para todos os insumos parametrizados com tabela "00 - Tabela Própria da Operadora" no programa Manutenção Insumos (hrc0110c), é necessário informar o tipo de tabela correspondente no programa Manutenção Associativa para Conversão Insumo Gestão Planos X PTU (hrc0510r).

Caso não informado, o sistema acusará erro na comunicação com a unidade origem do beneficiário.


Associativa insumo PTU para o insumo 00000003 e tipo de tabela 20.


Sistema exportou código do insumo com 10 dígitos

Pacotes:

  • Para o envio dos pacotes, todos os movimentos (procedimentos e insumos) que estiverem vinculados a um mesmo pacote, serão agrupados e enviados de maneira "fechada" no PTU Online 8.0.

Para mais informações poderá ser consultado a seção Novas Regras > Transações com Pacotes, onde é descrita todas as mudanças de regras do PTU Online 8.0.

Recebendo transações:

Procedimentos:

  • Para procedimentos (serviços informados com o campo tipoTabela igual a 22 - TUSS procedimentos e eventos em saúde ou tipoTabela igual a 00 - Outras Tabelas e os dois primeiros dígitos do código do procedimento iguais a 22), caso a guia possua apenas procedimentos que seja considerado de baixo risco, são obrigatoriamente serem autorizados ou negados. 
  • Caso exista qualquer procedimento que não seja considerado de baixo risco, a guia permanece em estudo (Pendente de Auditoria/Liberação).

Insumos:

  • Para a importação dos insumos serão lidos todos os registros equivalentes no programa Manutenção Associativa para Conversão Insumo Gestão Planos X PTU RC0510R considerando o campo Insumo PTU igual ao código do serviço e que estejam dentro do período de vigência. Para cada insumo PTU encontrado, será localizado o registro equivalente na Manutenção Insumos RC0110C considerando o código do insumo GPS e o Código Tabela igual ao recebido na transação. O primeiro registro que o sistema encontrar com essa combinação e que esteja com data de vigência válida, será assumido como o insumo que será criado na guia de autorização.
  • Caso não encontrado o registro correspondente na Manutenção Associativa para Conversão Insumo Gestão Planos X PTU RC0510R ou não for encontrado o insumo na Manutenção Insumos RC0110C o sistema acusará erro na conversão do insumo e não prosseguirá com a criação da guia.

Pacotes:

  • Caso o procedimento principal seja considerado de baixo risco, o pacote como um todo deverá ser obrigatoriamente autorizado ou negado.

  • Caso o procedimento principal não seja considerado de baixo risco, a guia será deixada no status em estudo (Pendente de Auditoria/Liberação).

    Caso exista qualquer procedimento que não seja de baixo risco e a guia possuir pacotes, a mesma será deixada no status em estudo (Pendente de Auditoria/Liberação).

Consulta de Beneficiário

A tela de consulta para dados de beneficiários foi convertida para Portinari.

No autorizador houve a inserção de um novo botão que permite realizar comunicação com a Unimed Origem do beneficiário de intercâmbio a fim de consultar e atualizar seus dados.
Pode ser necessário informar o token do beneficiário de intercambio.

No AT0110Z foi desenvolvida uma funcionalidade semelhante ao autorizador.

Contagem de Beneficiário

A tela de Contagem de Beneficiário foi convertida para Portinari.

Para cada um dos tipos de Contrato e Pessoa, foram removidos os 3 campos que sinalizavam a quantidade total (naoRepassado, repassadoOutraUnimed e recebidoOutraUnimed). No lugar deste foi adicionado um único campo para cada um dos tipos de Contrato e Pessoa, que irá indicar o numero de beneficiários, daquela pessoa e no contrato em questão e que possuem contrato com a Unimed.

Demais alterações

  • As rotinas do PTU Online envolvidas com os módulos HAW-Autorizador Web e Auditoria Médica Web, e os programas da Solicitação TISS/XML via WebServices também foram adequados para trafegar solicitações na versão 8.0 do PTU Online. Não foram acrescidos campos em tela nesses programas.
  • Foi alterada a regra para solicitar a descrição do insumo na inclusão de guias. Além da regra já existente, onde a descrição do insumo era solicitada quando codificação genérica, quando selecionado nos parâmetros do sistema que o cliente utiliza a versão 8.0 do PTU Online, o sistema passará a solicitar a descrição quando no programa Manutenção Insumos RC0110C o Código Tabela for igual a 19-Materiais Tuss ou 00 - Outras Tabelas.
  • Alterada a regra para solicitação do código ANVISA do material/medicamento e o código de referência do material no fabricante. Com a inutilização do antigo cadastro Manutenção Associativa Tabela Serviços X Tipo Insumo RC0410H no PTU Online 8.0, no momento da digitação de um insumo que possua tabela igual a 00 - Outras Tabelas, o sistema passou a verificar o Código Tabela da Manutenção Associativa para Conversão Insumo Gestão Planos X PTU RC0510R. Quando informado 19 - TUSS Materiais ou 20 - TUSS Medicamentos, então será solicitado o código ANVISA do material. E quando informado 19 - TUSS Materiais, então será solicitado o código de referência do material no fabricante.
  • Para o novo campo tipoEtapaAutorizacao, o valor informado será sempre 1 - Solicitação de Autorização Prévia. Tanto no envio como no recebimento dos pedidos de autorização e complemento, o sistema não realiza nenhum tipo de validação deste campo. Ele apenas é preenchido com o valor padrão para respeitar o schema do PTU Online 8.0.





4. ASSUNTOS RELACIONADOS



<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>