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) 

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.

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/

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:

      Campos Eliminados
      Nome do Beneficiário
      Data de Nascimento
      CNS
      Sobrenome
    2. Inclusão:

      Campos
      Nome
      Idade do Beneficiário

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


Alterações e Inclusões 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.

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"

CampoTipo
idCoberturaEspecialNumber

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

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"

Implementação do novo campo "saudeOcupacional" para solicitar e receber Autorizações.

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.

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


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

Campo Eliminado
tipoCliente
dtNasc

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

Campo Eliminado
tipoCliente
tpSexo

dtNasc

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

Campo Eliminado
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
Campo Eliminado
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 indica se os novos campos da TISS serão exibidos nos formulários de "Registro de Consulta" Solicitação e Registro de Exames no Autorizador e também no PERFIL MÉDICO.



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



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