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/ |
Domínios Tipo de TabelaNa 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 Procedimentos | 0 | 22 | Serviços hospitalares / Taxas / Complementos | 1 | 18 | TNUMM Materiais | 2 | 00 | TUSS Materiais | 5 | 19 | TNUMM Medicamentos | 3 | 00 | TUSS Medicamentos | 6 | 20 | Serviço com custo fechado (Pacotes) | 4 | 98 | Tabelas Próprias | Não existe | 00 |
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.0Realizado 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)
Retirados: Campos Eliminados |
---|
Nome do Beneficiário | Data de Nascimento | CNS | Sobrenome |
Inclusão: Campos |
---|
Nome | Idade do Beneficiário |
Campos INCLUIDOS Transação: 00413 – Resposta da Consulta de Dados do Beneficiário 
|
Alterações PTU Online 9.0
01. Alteração "descricaoServico" A nova regra para a descrição de serviço que apenas deve ser enviada para códigos genéricos. 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.
|
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)
02. Alteração Bloco Prestador SolicitanteOs novos campos incluídos no bloco de prestador solicitante de acordo com as regras do Manual do PTU Online 9.0. Campos | Tipo |
---|
nomePrestadorSolic | Number | siglaConselho | String | numeroConselho | Number | unidadeFederativa | String | numeroCBO | Number |
Importante: - O sistema verifica a classe da nota para determinar o tipo de guia pois para "SADT" e "Internação" são mandatórios.
|
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
03. Alteração Bloco Prestador Executante
O novo campo incluído no bloco de prestador executante de acordo com as regras do Manual do PTU Online 9.0. Importante: - 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 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. Inclusão do Campo "nomeSocial"Implementação do novo campo "nomeSocial" para solicitar e receber Autorizações. Transações que foram alteradas no bloco prestador Solicitante: - 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
|
Retiradas Recebimento PTU Online 9.0
01. Exclusões de Campos Transações 600 - Pedido de Autorização (Recebimento) Eliminando os campos no recibo de Autorizações(00600) de acordo com as regras do Manual do PTU Online 9.0 para que não sejam mais retornados. - 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 (Recebimento)Eliminando os campos no recibo de Ordem de Serviço(00806) de acordo com as regras do Manual do PTU Online 9.0 para que não sejam retornados. - 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 (Recebimento) Eliminando os campos no recibo de Complemento de Autorização(00605) de acordo com as regras do Manual do PTU Online 9.0 para que não sejam retornados. - 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 413 - Resposta Consulta Dados do Beneficiário (Resposta) Eliminando os campos ao 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 |
05. Exclusões de Campos Transações 501 - Resposta Pedido de Autorização (Resposta)Campo Eliminado |
---|
tipoCliente | dtNasc |
06. Exclusões de Campos Transações 361 - Resposta Status da Transação (Resposta)Campo Eliminado |
---|
tipoCliente | tpSexo | dtNasc |
06. Exclusões de Campos Transações 750 - Comunicação de Internação ou Alta do Beneficiário Campo Eliminado |
---|
tipoCliente | numeroViaCartao |
06. Demais Transações:
|
Retiradas Solicitações PTU Online 9.0
01. Exclusões de Campos Transações 600 - Pedido de Autorização (Solicitação) Eliminando os campos ao solicitar Autorizações(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 (Solicitação)Eliminando os campos ao solicitar 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 (Solicitação) Eliminando os campos ao solicitar 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 (Solicitação) Eliminando os campos ao solicitar 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 |
|
|
|
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. |
FoundationPara 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). |
AutorizadorNovas Propriedades Criadas no Autorizador para PTU Online 8.0 e Software de Pacotes: Propriedade | Descriçã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 SistemaNo 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 CPCsPara 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
|
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". 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; 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çõesProcedimento: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. |

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 |
---|
99999999 | 18 | -- | 18 | 99999999 | 99999998 | 00 | 18 | 00 | 1899999999 |
|
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) |
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. 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: |
|
|
Consulta de BeneficiárioA 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árioA 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.
|
|
|
|