Linha Datasul

Á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-15118 - Obtendo detalhes do item... STATUS

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.

Novas Regras PTU Online 9.0

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/

01. 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. Retirados da Pesquisa os Campos:

      Campos Eliminados
      Nome do Beneficiário
      Data de Nascimento
      CNS
      Sobrenome

    2. Retirado do Resultado os Campos:

      Campos Eliminados
      Nascimento
      Sexo
      Plano
      Data Exclusão Plano
      Empresa
      Data Validade Contrato
      Número Via Cartão

    3. Inclusão no Resultado da Pesquisa dos Campos:

      Campos Incluídos
      Nome
      Idade do Beneficiário

Detalhe do manual PTU 9.0:


Caso esteja parametrizado na Manutenção Parâmetros Globais Sistema (pr1410p) a versão do PTU Online 8.0 a tela será apresentada da forma que será sem as modificações citadas anteriormente.

02. Inclusão do Campo Indicador de Cobertura Especial

Ao ser parametrizada a nova propriedade do autorizador com.totvs.saude.tiss.version.newFields com o valor 4.00.01 no Registro de Consulta, Solicitação de Exame e Registro de Exame, tanto autorizador quanto perfil médico, passará a ser apresentado o campo de cobertura especial para ser informado. Tal campo é opcional então será iniciado com valor vazio como default.


  • Autorizador

  • Perfil Médico

É necessário que seja parametrizado no programa Manutenção Parâmetros Revisão de Contas (hrc.paramrc) a versão da TISS para que sejam compatíveis na hora de comunicar, sem ocorrer falhas.

Alterações e Inclusões PTU Online 9.0 

01. Alteração "quantidadeServico"

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

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:



  • Auditoria Pré (hau.authorizationAudit)


  • Manutenção de Guia (AT0110z)

02. Alteração "descricaoServico"

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 programa PTU da Manutenção Associativas GPS X PTU (hrc.ptuAssociative) - Associativa Conversão de Insumo. 

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

      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)

03. Alteração Bloco Prestador Solicitante e Inclusão do "numeroCBO"

  • Alterado o nome do bloco de Prestador Requisitante para Prestador Solicitante
  • O bloco do conselho profissional foi movido para dentro do bloco do Prestador Solicitante
  • Adicionado ao bloco o campos numeroCBO de acordo com as regras do Manual do PTU Online 9.0.
Campos IncluídosTipo
nomePrestadorSolicNumber
siglaConselhoString
numeroConselho Number
unidadeFederativaString
numeroCBONumber


Detalhe do manual PTU 9.0:

Transações que foram alteradas no bloco prestador Solicitante:

  • Transação: 00600 – Pedido de Autorização
  • Transação: 00605 – Pedido de Complementação de Autorização
  • Transação: 00806 – Ordem de Serviço

04. Alteração Bloco Prestador Executante e inclusão do "numeroCBO"

  • Alterado o nome do bloco de Prestador para Prestador Executante
  • Adicionado ao bloco o campos numeroCBO de acordo com as regras do Manual do PTU Online 9.0
CampoTipo
numeroCBONumber
  • No Autorizador não existe o campo para informar "Especialidade". Então para solicitações oriundas do Autorizador, iremos considerar a primeira "Especialidade" para o prestador Executante informado e consequentemente buscando o primeiro CBO válido encontrado para essa especialidade.
  • No AT0110Z, no momento de informar o Prestador Executante é pedido em tela a "Especialidade", então através da especialidade informada iremos buscar o primeiro CBO válido para essa especialidade e será a informação trafegada no PTU Online.

Detalhe do manual PTU 9.0

Transações que foram alteradas no bloco prestador Executante:

  • Transação: 00600 – Pedido de Autorização
  • Transação: 00605 – Pedido de Complementação de Autorização
  • Transação: 00806 – Ordem de Serviço

05. Inclusão do Campo "nomeSocial"

CampoTipo
nomeSocialString

Transações que foram alteradas:

  • Transação: 00413 – Resposta da Consulta de Beneficiário
  • Transação: 00501 – Resposta de Pedido de Autorização
  • Transação: 00806 – Ordem de Serviço

Detalhe do manual PTU 9.0:

06. Inclusão do Campo "idCoberturaEspecial"

O campo Indicador de Cobertura Especial é um domínio TISS de preenchimento opcional e deverá listar os valores cadastrados na tabela correspondente ao seu cadastro (Cobertura especial das tabelas criadas). 

CampoTipo
idCoberturaEspecialNumber

Detalhe do manual PTU 9.0


Transações que foram alteradas:

  • Transação: 00600 – Resposta de Pedido de Autorização
  • Transação: 00806 – Ordem de Serviço

07. Inclusão do Campo "saudeOcupacional"

CampoTipo
saudeOcupacionalNumber

Realizado no Autorizador, AT, Auditoria Médica para que nas solicitações de intercâmbio 600 e 806 quando selecionado o um tipo de atendimento referente a Saúde Ocupacional essa informação seja enviado no PTU Online 9.0.  No PTU 9.0 os domínios foram modificados, dessa forma, deve ser enviado o valor seu equivalente. Salvo em caso de consulta, onde foi criado na tela do at0110z um campo para ser informado.

Tipo de Atendimento no Autorizador

Enviado no PTU

14 Saúde Ocupacional - Admissional

1 = Admissional

15 Saúde Ocupacional - Demissional

2 = Demissional

16 Saúde Ocupacional - Periódico

3 = Periódico

17 Saúde Ocupacional - Retorno ao Trabalho

4 = Retorno ao Trabalho

18 Saúde Ocupacional - Mudança de Função

5 = Mudança de Função

19 Saúde Ocupacional - Promoção a Saúde

6 = Promoção a Saúde

Detalhe do manual PTU 9.0

Transações que foram alteradas:

  • Transação: 00600 – Resposta de Pedido de Autorização
  • Transação: 00806 – Ordem de Serviço

Manutenção de Guias (AT0110z) - Guia do Tipo Consulta:

Ao solicitar uma guia de consulta através do at0110z ficará disponível o campo Saude Ocupac.


8. Adequação da Consulta de Guias Negadas (AT0110t):

  Realizado ajustes no processo para que ocorra na versão do PTU 9.0 e implementação de novos campos ao recriar a Guia. 


A criação de autorização é possível apenas para guias pendentes e negadas



Campos Removidos PTU Online 9.0  

01. Exclusões de Campos Transações 600 - Pedido de Autorização

 Eliminando os campos ao realizar um Pedido de Autorização (00600) de acordo com as regras do Manual do PTU Online 9.0 para que não sejam mais enviados na solicitações de autorização.

  • Realizado ajuste nos processos do Autorizador, WebService, AT0110Z e Auditoria Médica para que ao solicitar uma guia para beneficiário de fora os campos destacados abaixo não sejam considerados.
Campos Eliminados
tipoCliente
numeroViaCartao
codigoEspecialidadeMedica
idAcidente
idAnexo
tpSexo
nrIdade 
idOrdemServico 
valorUnitarioServico  

02. Exclusões de Campos Transações 806 - Ordem de Serviço

Eliminando os campos ao solicitar uma Ordem de Serviço (00806) de acordo com as regras do Manual do PTU Online 9.0 para que não sejam mais enviados na solicitações de autorização.

  • Realizado ajuste nos processos do Autorizador, WebService, AT0110Z e Auditoria Médica para que ao solicitar uma guia para beneficiário de fora os campos destacados abaixo não sejam considerados.
Campos Eliminados
tipoCliente
numeroViaCartao
codigoEspecialidadeMedica
nomePrestadorRequisitante
siglaConselhoRequisitante
numeroConselhoRequisitante
unidadeFederativaRequisitante
idAcidente
idAnexo
valorUnitarioServico  

03. Exclusões de Campos Transações 605 - Pedido Complemento de Autorização

 Eliminando os campos ao solicitar um Pedido de Complemento de Autorização (00605) de acordo com as regras do Manual do PTU Online 9.0 para que não sejam mais enviados na solicitações de autorização.

  • Realizado ajuste nos processos do Autorizador, WebService, AT0110Z e Auditoria Médica para que ao solicitar uma guia para beneficiário de fora os campos destacados abaixo não sejam considerados.
Campos Eliminados
tipoCliente
codigoEspecialidadeMedica
idAnexo
tpSexo
nrIdade 
valorUnitarioServico  

04. Exclusões de Campos Transações 412 - Consulta Dados do Beneficiário

 Eliminando os campos ao realizar a Consulta Dados do Beneficiário (00412) de acordo com as regras do Manual do PTU Online 9.0 para que não sejam mais enviados na consulta.

Campos Eliminados
tipoCliente
dataNascimento
nomeBeneficiario
ultimoSobrenomeBeneficiario 
numeroCNS 

05. Exclusões de Campos Transações 413 - Resposta Consulta Dados do Beneficiário

 Eliminando os campos ao retornar a Resposta Consulta Dados do Beneficiário (00413) de acordo com as regras do Manual do PTU Online 9.0 para que não sejam retornados.

Campos Eliminados
tipoCliente
nome
dataNascimento
sexoBeneficiario 
nomeEmpresa 
nomePlano 
dataValidadeCarteira
numeroViaCartao 

06. Exclusões de Campos Transações 501 - Resposta Pedido de Autorização

Campos Eliminados
tipoCliente
dtNasc

07. Exclusões de Campos Transações 361 - Resposta Status da Transação

Campos Eliminado
tipoCliente
tpSexo

dtNasc

08. Exclusões de Campos Transações 750 - Comunicação de Internação ou Alta do Beneficiário 

Campos Eliminados
tipoCliente
numeroViaCartao

09. Demais Transações:

  • Exclusão de Campos da Transação: 00302 – Pedido de Insistência
  • Exclusão de Campos da Transação: 00404 – Resposta de Auditoria
  • Exclusão de Campos da Transação: 00311 – Cancelamento 
  • Exclusão de Campos da Transação: 00309 – Confirmação
  • Exclusão de Campos da Transação: 00310 – Erro Inesperado
  • Exclusão de Campos da Transação: 00360 – Status da Transação
  • Exclusão de Campos da Transação: 00418 – Consulta Prestador
  • Exclusão de Campos da Transação: 00419 – Resposta da Consulta de Prestador
  • Exclusão de Campos da Transação: 00430– Requisição de Contagem de Beneficiários
  • Exclusão de Campos da Transação: 00431 – Resposta de Requisição de Contagem de Beneficiários

  • Exclusão de Campos da Transação: 00700 – Comunicação de Decurso de Prazo

  • Exclusão de Campos da Transação: A01100 – Consultas Transações Respondidas WSD

Campo Eliminado
tipoCliente
  • Exclusão de Campos da Transação: A01101 – Consultas Transações Respondidas WSD
Campos Eliminados
tipoCliente
codigoUnimedSolicitante
dataSolicitacao
descricaoServico

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 9.0, foram disponibilizadas na página PTU ONLINE 9.0 (Foundation).

Autorizador

Novas Propriedades Criadas no Autorizador para PTU Online 9.0:


Propriedade

Descrição

com.totvs.saude.tiss.version.newFields

Propriedade que exibe os novos campos da TISS.

Caso parametrizado com o valor "4.00.01" será disponibilizado o campo Identificador de Cobertura Especial na Solicitação de Exame, Registro de Exame e Registro de Consulta.

Caso parametrizado com o valor "3.05.00" a tela permanece como anteriormente.

OBS: A propriedade deve estar parametrizada conforme utilizada na Manutenção Parâmetros Revisão de Contas (hrc.paramrc).

Mais Informações

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 8.0 para 9.0.


a. No campo "Versão do PTU", deverá ser informado a nova versão "7 - 9.0".
b. No campo "URL de Comunic.", deverá ser informado o novo endpoint do PTU Online 9.0 parametrizado no Foundation. Deverá ser informado o endpoint "WsdPtuSenderWSv9000?wsdl", conforme exemplo: http://<servidor>:<porta>/htz-foundation/WsdPtuSenderWSv9000?wsdl.
c. No campo "Namespace", informar o valor "http://implementation.v9000.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-PTU90.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-ptu80.i", deverá ser alterada a mesma de modo que passe a utilizar a nova include "atp/atapi023-ptu90.i".

  • CPC-API-RECEBE-PTU80.P:

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

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

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

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

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

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



4. ASSUNTOS RELACIONADOS