Árvore de páginas

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:DSAUGPSAUTOR-7334

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

Importante

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 8.0 contendo pacotes

Foram realizados alguns ajustes relacionados a transações dos pacotes:

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

Importante: Foi removido o campo idPacote das transações do PTU Online 8.0.


Todas as transações que contiverem pacotes deverão trafegar o pacote e seu procedimento principal em "linhas" separadas, isto é, serão enviados com o campo "sqItem" diferentes na transação. Este procedimento principal não possuíra nenhum campo que indique a qual pacote da transação o mesmo pertence e esta validação também não será realizada pelo WSD da Unimed do Brasil.

Atualmente, o WSD irá realizar apenas a validação se há algum pacote cadastrado no SISPAC com a unidade origem da transação + código do pacote e se há pelo menos um procedimento discriminado na transação (não validando se é ou não o principal do pacote em questão, cabendo aos ERPs que enviem corretamente).

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

  • Recebendo Transação

Ao detectar um pacote, será realizada a associação do pacote ao procedimento principal, selecionado o primeiro procedimento que ainda não está associado a nenhum pacote. Isto se faz necessário devido a Unimed do Brasil não indicar a conexão ao SISPAC durante os intervalo de tempo da transação.

Na inclusão de uma guia, apenas será gravado um registro de procedimento (procedimento principal) com indicação do pacote de intercâmbio ao qual foi atrelado.

O pacote irá possuir o mesmo status de autorização que o procedimento atrelado a ele.

  • Enviando Transação

Ao realizar um envio de transação, será exportado uma linha contendo as informações do pacote e outra contendo seu procedimento principal de maneira automática.

Ao receber o retorno o status do pacote é replicado para os procedimentos e insumos que o compõem.

  • Resposta de Auditoria

Ao receber uma resposta o status do pacote é replicado para os procedimentos e insumos que o compõem.

Ao enviar uma resposta é lido todos os movimentos que possuem pacote de intercâmbio, criando uma linha para cada pacote e outra para o procedimento principal do pacote.

  • Resposta de Status de Transação

Ao receber um pedido de status de transação é lido todos os movimentos que possuem pacote de intercâmbio, criando uma linha para cada pacote e outra para o procedimento principal do pacote.

Ao solicitar um pedido de status de transação o status do pacote é replicado para os procedimentos e insumos que o compõem.

Campo Tipo de Acomodação

Foi disponibilizado um novo campo "tpAcomodacao" no PTU , onde seu principal objetivo é ser utilizado na consulta do software de pacotes. Seu preenchimento é realizado conforme as regras a seguir:

  • Para guias de Consulta ou SP/SADT, o valor informado no novo campo será igual a C - Não se aplica;
  • Para guias de Internação, o sistema irá consultar na Manutenção de Classe Hospitalar (hcg.accommodationType), a partir do valor do campo Clas.Hos informado na digitação da guia, a qual Tipo de Acomodação essa classe hospitalar está vinculada.


Campo Tipo de Guia

Foi disponibilizado um novo campo "tipoGuia" no PTU.  Seu preenchimento é realizado conforme as regras a seguir:

  • Será utilizada a classe de nota informada na guia para localizar a qual tipo de guia o registro pertence:

Classe de nota (TOTVS)

Tipo de Guia (PTU)

1 - Consulta

1 - Consulta

23 - Consulta (Primeira Consulta)

24 - Consulta (Seguimento)

25 - Consulta (Pre-Natal)

2 - SADT

2 - SP/SADT

8 - Consulta em Emergência

4 - Internação Clínica

3 - Internação

5 - Internação Cirurgica

6 - Internação Obstetrica

9 - Internação Hospital-Dia

10 - Internação Domiciliar

11 - Internação Pediátrica

12 - Internação Psiquiátrica

26 - Prorrogação de Internação

Qualquer outro valor

2 - SP/SADT

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