01. DADOS GERAIS
Produto: | TOTVS Saúde Planos
|
---|---|
Linha de Produto: | Linha Protheus |
Segmento: | Saúde |
Módulo: | SIGAPLS |
Função: | PLPTUONWEB |
Ticket: | 6333723 |
Requisito/Story/Issue (informe o requisito relacionado) : | DSAUBE-10330 |
02. SITUAÇÃO/REQUISITO
Atualização do Sistema para a versão 8.0 do PTU Online.
03. SOLUÇÃO
Implementada melhoria atualizando o sistema para a versão 8.0 do PTU Online.
Os WebServices atualizados:
- pedidoAutorizacao (00600) - PTOnPedAut.APW
- pedidoComplementoAutorizacao (00605) - PTOnComAut.APW
- pedidoInsistencia (00302) - PTOnPedIns.APW
- respostaAuditoria (00404) - PTOnResAud.APW
- cancelamento (00311) - PTOnCancel.APW
- consultaDadosBeneficiario (00412) - PTOnDadBen.APW
- consultaDadosPrestador (00418) - PTOnDadPre.APW
- statusTransacao (00360) - PTOnStaTra.APW
- comunicacaoDecursoPrazo (00700) - PTOnDecPra.APW
- ordemServico (00806) - PTOnOrdSer.APWauto
- AutorizacaoOrdemServico (00804) - PTOnAutOS.APW
- contagemBeneficiariosWS (00430) - PTOnConBen.APW
- comunicacaoInternacaoAltaWS (00750) - PTOnComInt.APW
Estes WebServices vão utilizar o endereço e porta de seu Portal do Plano de Saúde. Assim a URL para acessar um WebService será: http://[endereçoportal]:[porta]/portal/[nome do webservice].APW
Exemplos:
http://127.0.0.1:433/portal/PTOnPedAut.APW
http://127.0.0.1:443/portal/PTOnComAut..APW
Estes endereços serão seus EndPoints que deverão ser informados para a Unimed do Brasil.
Importante: a porta parametrizada deve ser a 443 (definição da Unimed do Brasil).
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
Schemas
- Baixe a última versão dos schemas disponibilizados através dos Boletins Mais Informações Tecnologia da Unimed do Brasil.
- Em seu rootpath, crie a estrutura de pastas \ptuonweb\schemas\.
- Copie os schemas disponibilizados pela Unimed do Brasil para o diretório \ptuonweb\schemas\.
Certificado
- Solicite para a Unimed do Brasil, um certificado para sua operadora.
- Renomeie o arquivo de certificado .p12 para certificado.p12.
- Em seu rootpath, crie a estrutura de pastas \ptuonweb\certificados\. Copie o arquivo certificado.p12 para este diretório.
- Ao utilizar a comunicação PTU pela primeira vez, o sistema criará os arquivos para comunicação ca.pem, cert.pem e key.pem.
- Importante: informe no parâmetro MV_PTONSEN a senha do certificado disponibilizado pela Unimed do Brasil.
Binário
- Para a utilização dos novos recursos do PTU Online 8.0 com troca de informações via Web Service é necessário a atualização do binário a partir da Build 19.3.0.6 (Disponível na Central de Downloads).
- Consulte a documentação: PSIGABD0053 - Procedimento para atualizar o binário do Protheus.
Configuração de Parâmetros:
No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure o(s) parâmetro(s) a seguir:
Itens/Pastas | Descrição |
Nome: | MV_PTUVEON |
Tipo: | Caracter |
Cont. Por.: | 80 |
Descrição: | Versão da Transação PTU Online |
Itens/Pastas | Descrição |
Nome: | MV_PTONXSD |
Tipo: | Caracter |
Cont. Por.: | ptu_Transacoes-V80_00.xsd |
Descrição: | Nome do arquivo .xsd das transações PTU |
Itens/Pastas | Descrição |
Nome: | MV_PTONVER |
Tipo: | Caracter |
Cont. Por.: | V80_00 |
Descrição: | Versão do PTU Online Web Service |
Itens/Pastas | Descrição |
Nome: | MV_PTONNAM |
Tipo: | Caracter |
Cont. Por.: | v80 |
Descrição: | Informe o NameSpace das tags Ptu Online |
Itens/Pastas | Descrição |
Nome: | MV_PLPACPT |
Tipo: | Caracter |
Cont. Por.: | |
Descrição: | Pacote Genérico para o PTU |
Tabelas:
1 - Criação de Tabelas no arquivo SX2 - Tabela
Tabela: | B6M |
Nome: | Protocolo de Transacoes Unimed |
Modo: | Compartilhado |
Modo Unidade: | Exclusivo |
Modo Empresa: | Exclusivo |
Chave Única: | B6M_FILIAL+B6M_OPEMOV+B6M_ANOAUT+B6M_MESAUT+B6M_NUMAUT+B6M_NRTROL |
2 - Criação de Índices no arquivo SIX - Índices
Ordem | Chave |
1 | B6M_FILIAL+B6M_OPEMOV+B6M_ANOAUT+B6M_MESAUT+B6M_NUMAUT |
2 | B6M_FILIAL+B6M_NRTROL+B6M_OPEMOV+B6M_ANOAUT+B6M_MESAUT+B6M_NUMAUT |
3 - Criação de Campos no arquivo SX3 - Campos
Campo: | B6M_FILIAL |
Tipo: | C - Caractere |
Tamanho: | 8 |
Título: | Filial |
Descrição: | Filial |
Picture: | |
Usado: | Não usado |
Contexto: | Real |
Propriedade: | Visualizar |
Campo: | B6M_OPEMOV |
Tipo: | C - Caractere |
Tamanho: | 4 |
Título: | Oper. Movto. |
Descrição: | Operadora Movimento |
Picture: | @! |
Usado: | Não usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Operadora que realizou a movimento |
Campo: | B6M_ANOAUT |
Tipo: | C - Caractere |
Tamanho: | 4 |
Título: | Ano Autoriz. |
Descrição: | Ano Autorização |
Picture: | @! |
Usado: | Não usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Ano da Autorização |
Campo: | B6M_MESAUT |
Tipo: | C - Caractere |
Tamanho: | 2 |
Título: | Mes Autoriz. |
Descrição: | Mes Autorização |
Picture: | @! |
Usado: | Não usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Mês da Autorização |
Campo: | B6M_NUMAUT |
Tipo: | C - Caractere |
Tamanho: | 8 |
Título: | Num Autoriz. |
Descrição: | No. Autorização |
Picture: | @! |
Usado: | Não usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Numero da Autorização da Operadora |
Campo: | B6M_NRTROL |
Tipo: | C - Caractere |
Tamanho: | 20 |
Título: | Tr.Prest.Exe |
Descrição: | Trans. Unimed Prestadora |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Número da transação da Unimed Prestadora. |
Campo: | B6M_NRAOPE |
Tipo: | C - Caractere |
Tamanho: | 20 |
Título: | Tr.Orig.Bene |
Descrição: | Trans. Origem Beneficiari |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Número da transação na Unimed Origem do Benef. |
Campo: | B6M_ALIAS |
Tipo: | C - Caractere |
Tamanho: | 3 |
Título: | Alias Ref. |
Descrição: | Alias de Referência |
Picture: | @! |
Usado: | Não usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Tabela de Referência |
Campo: | B6M_ETAAUT |
Tipo: | C - Caractere |
Tamanho: | 1 |
Título: | Etapa Autor. |
Descrição: | Etapa de Solic. de Autor. |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
cBox | 1=Solicitação de Autorização Previa;2=Solicitação de Autorização pelo Prestador Executante |
Help | Indica a etapa da solicitação de autorização |
Campo: | B6M_DTSOLI |
Tipo: | D - Data |
Tamanho: | 8 |
Título: | Data Solici. |
Descrição: | Data da Solicitação |
Picture: | |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Momento em que a Unimed Prestadora toma conhecimento do pedido |
Campo: | B6M_TIPGUI |
Tipo: | C - Caractere |
Tamanho: | 1 |
Título: | Tipo Guia |
Descrição: | Tipo da Guia |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
cBox | 1=Consulta;2=SP/SADT;3=Internação |
Help | Classifica o tipo de Guia TISS |
Campo: | B6M_TPACOM |
Tipo: | C - Caractere |
Tamanho: | 2 |
Título: | Acomodacao |
Descrição: | Tipo de Acomodação |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
cBox | A=Coletiva;B=Individual;C=Não se Aplica |
Help | Tipo de acomodação na qual o beneficiário será submetido |
Campo: | B6M_MSGLIV |
Tipo: | M - Memo |
Tamanho: | 10 |
Título: | Mens. Livre |
Descrição: | Mensagem Livre |
Picture: | |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Descrição da Mensagem Livre |
1 - Criação de Tabelas no arquivo SX2 - Tabela
Tabela: | B6L |
Nome: | PTU Online x Pacote |
Modo: | Compartilhado |
Modo Unidade: | Exclusivo |
Modo Empresa: | Exclusivo |
Chave Única: | B6L_FILIAL+B6L_OPEMOV+B6L_ANOAUT+B6L_MESAUT+B6L_NUMAUT+B6L_SEQUEN+B6L_ALIAS+B6L_NRTROL |
2 - Criação de Índices no arquivo SIX - Índices
Ordem | Chave |
1 | B6L_FILIAL+B6L_OPEMOV+B6L_ANOAUT+B6L_MESAUT+B6L_NUMAUT |
2 | B6L_FILIAL+B6L_NRTROL |
3 - Criação de Campos no arquivo SX3 - Campos
Campo: | B6L_FILIAL |
Tipo: | C - Caractere |
Tamanho: | 8 |
Título: | Filial |
Descrição: | Filial |
Picture: | |
Usado: | Não Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Campo: | B6L_OPEMOV |
Tipo: | C - Caractere |
Tamanho: | 4 |
Título: | Oper. Movto. |
Descrição: | Operadora Movimento |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Operadora do Movimento da Guia |
Campo: | B6L_ANOAUT |
Tipo: | C - Caractere |
Tamanho: | 4 |
Título: | Ano Autoriz. |
Descrição: | Ano Autorização |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Ano da Autorização da Guia |
Campo: | B6L_MESAUT |
Tipo: | C - Caractere |
Tamanho: | 2 |
Título: | Mes Autoriz. |
Descrição: | Mes Autorização |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Mês da Autorização da Guia |
Campo: | B6L_NUMAUT |
Tipo: | C - Caractere |
Tamanho: | 8 |
Título: | Num Autoriz. |
Descrição: | No. Autorização |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Numero da Autorização da Guia |
Campo: | B6L_SEQUEN |
Tipo: | C - Caractere |
Tamanho: | 3 |
Título: | Sequencia |
Descrição: | Sequência do Item |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Sequência do Item na Guia |
Campo: | B6L_ALIAS |
Tipo: | C - Caractere |
Tamanho: | 3 |
Título: | Alias Ref. |
Descrição: | Alias de Referência |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Tabela de Referência da Guia |
Campo: | B6L_UNIORI |
Tipo: | C - Caractere |
Tamanho: | 4 |
Título: | Unimed Orig. |
Descrição: | Unimed Origem Pacote |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Código da Unimed Origem do Pacote |
Campo: | B6L_CODRDA |
Tipo: | C - Caractere |
Tamanho: | 8 |
Título: | Cd.Prestador |
Descrição: | Código do Prestador |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Codigo do Prestador vinculado ao Pacote |
Campo: | B6L_DTATEN |
Tipo: | D - Data |
Tamanho: | 8 |
Título: | Dt. Referenc |
Descrição: | Data de Referência |
Picture: | |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Data da referência do Pacote |
Campo: | B6L_CODPAC |
Tipo: | C - Caractere |
Tamanho: | 8 |
Título: | Cd. Pacote |
Descrição: | Código do Pacote |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Código do Pacote |
Campo: | B6L_COMUNI |
Tipo: | C - Caractere |
Tamanho: | 1 |
Título: | Comunicacao? |
Descrição: | Comunicação WebService |
Picture: | @! |
Usado: | Usado |
cBox | 0=Não;1=Sim |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Comunicação com o WebService de Pacotes |
Campo: | B6L_NRTROL |
Tipo: | C - Caractere |
Tamanho: | 20 |
Título: | Tr.Prest.Exe |
Descrição: | Trans. Unimed Prestadora |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Transação da Unimed Executora |
3 - Criação de Campos no arquivo SX3 - Campos
Campo: | BR8_ROLUNI |
Tipo: | C - Caractere |
Tamanho: | 1 |
Título: | Rol Unimed |
Descrição: | Rol Unimed |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Alterar |
cBox | 1=Coberto sem Valor;2=Sem Cobertura |
Help | Informa se o procedimento no Rol Unimed não possui cobertura ou possui cobertura sem valor, caso não seja informado, entende-se que o procedimento é totalmente coberto no Rol. |
3 - Criação de Campos no arquivo SX3 - Campos
Campo: | BE2_CDPACO |
Tipo: | C - Caractere |
Tamanho: | 8 |
Título: | Cd Pacote |
Descrição: | Codigo do Pacote |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Código do Pacote Origem |
Campo: | BE2_DESPAC |
Tipo: | C - Caractere |
Tamanho: | 211 |
Título: | Desc. Pacote |
Descrição: | Descrição do Pacote |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Descrição do Pacote Origem |
3 - Criação de Campos no arquivo SX3 - Campos
Campo: | BQV_CDPACO |
Tipo: | C - Caractere |
Tamanho: | 8 |
Título: | Cd Pacote |
Descrição: | Codigo do Pacote |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Código do Pacote Origem |
Campo: | BQV_DESPAC |
Tipo: | C - Caractere |
Tamanho: | 211 |
Título: | Desc. Pacote |
Descrição: | Descrição do Pacote |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Descrição do Pacote Origem |
3 - Criação de Campos no arquivo SX3 - Campos
Campo: | BEJ_CDPACO |
Tipo: | C - Caractere |
Tamanho: | 8 |
Título: | Cd Pacote |
Descrição: | Codigo do Pacote |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Código do Pacote Origem |
Campo: | BEJ_DESPAC |
Tipo: | C - Caractere |
Tamanho: | 211 |
Título: | Desc. Pacote |
Descrição: | Descrição do Pacote |
Picture: | @! |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Visualizar |
Help | Descrição do Pacote Origem |
3 - Criação de Campos no arquivo SX3 - Campos
Campo: | BA0_URLPAC |
Tipo: | C - Caractere |
Tamanho: | 128 |
Título: | UrlSisPacUni |
Descrição: | URL SISPAC Unimed Bra |
Picture: | |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Alterar |
Campo: | BA0_STKPAC |
Tipo: | C - Caractere |
Tamanho: | 128 |
Título: | STkSisPacUni |
Descrição: | STk SISPAC Unimed Bra |
Picture: | |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Alterar |
Campo: | BA0_USRPAC |
Tipo: | C - Caractere |
Tamanho: | 64 |
Título: | UsrSisPacUni |
Descrição: | Usr SISPAC Unimed Bra |
Picture: | |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Alterar |
Campo: | BA0_PWDPAC |
Tipo: | C - Caractere |
Tamanho: | 64 |
Título: | PwdSisPacUni |
Descrição: | Pwd SISPAC Unimed Bra |
Picture: | |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Alterar |
Campo: | BA0_TOKPAC |
Tipo: | M - Memo |
Tamanho: | 50 |
Título: | TokSisPacUni |
Descrição: | Tok SISPAC Unimed Bra |
Picture: | |
Usado: | Usado |
Contexto: | Real |
Propriedade: | Alterar |
Observação
O Campo de Token Bearer (BA0_TOKPAC) não deverá ser informado no cadastro, esse campo é utilizado pelo sistema para armazenar o token nas consultas ao SISPAC.
Importante
A alteração de dicionário referente a essa implementação estará disponível no próximo pacote de Expedição Contínua do módulo SIGAPLS.
Na nova versão do PTU foram alteradas as tabelas utilizadas para trafegar:
Na versão anterior o sistema utilizava o campo BR8_TPPROC para definir o tipo de tabela daquele serviço. Na nova versão o sistema utilizará o cadastrado de terminologia para vincular o serviço com a tabela.
Os pacotes a partir dessa versão serão enviados na transação, portanto também precisaram ser cadastrados no Cadastrado de Terminologia TISS com o Tipo de tabela 98 e realizado o vinculo.
Para realizar o vinculo de um serviço é só acessar: Tabela Padrão > Outras Ações > Vinculo TISS.
Observação
Importante que todos os serviços que forem trafegar no PTU Online estejam vinculados com a Terminologia TISS.
No versão atual do PTU Online, foram disponibilizadas novas tags no XML (tipoEtapaAutorizacao, dataSolicitacao, tipoGuia, tpAcomodacao), essas tags passaram a ser gravadas em uma tabela separa (B6M), além disso será gravada as mensagens de resposta da auditoria (00404) em um campo memo:
Será possível consultar essa tela após realizar a comunicação e gravação da Guia.
Botão Outra Ações > PTU Online da tela principal.
Para visualizar as transações de Complemento ou Prorrogação (00605): Botão Outras Ações > PTU Online do Grid do Complemento.
Ao realizar a comunicação, esses campos serão preenchidos automaticamente, sendo que as tags:
- tipoEtapaAutorização será 1 (Solicitação de autorização prévia) quando for informado o prestador genérico do sistema, definido pelo parâmetro MV_PLSRDAG e 2 (Solicitação de autorização pelo prestador executante) quando for informado o prestador na guia.
- dataSolicitacao será a data em que foi incluída a guia no sistema.
- tipoGuia será 1 para consulta, 2 para SADT e 3 para Internação.
- tpAcomodacao será preenchido de acordo com a acomodação do beneficiário, sendo que para guias do tipo 1 (Consulta) ou 2 (SADT) utilizar a opção C - Não se aplica.
Para comunicação do sistema com o WebService do SISPAC, é necessário que os seguintes campos estejam configurados no cadastro da operadora saúde:
1 Campo: A url do EndPoint.
2 Campo: token da aplicação
3 Campo: Login
4 Campo: Senha
Todas essas informações deveram ser solicitas a Unimed Brasil.
Mudanças realizadas nas transações do PTU Online 8.0 contendo pacotes
Todas as transações que contiverem pacotes deverão trafegar o código do pacote e o seu procedimento principal, sendo que o procedimento principal não possuíra nenhuma tag no XML que indique a qual pacote pertence na transação.
Devido a estas validações, SIGAPLS irá processar estas transações da seguinte maneira:
- Enviando Transação
Para realizar o envio de uma transação, precisará ser informado no preenchimento da guia o código do pacote (tipo de tabela 98) + o código do procedimento principal, informando no campo (BE2_PACOTE, BEJ_PACOTE ou BQV_PACOTE) o conteúdo 1 - Sim, para identificar no sistema que aquele procedimento faz parte do pacote. - Recebendo Transação
Para o recebimento de um transação, precisará que seja cadastrado um pacote genérico na tabela padrão e informa-lo no parâmetro MV_PLPACPT, esse pacote servira como De-para para o recebimento de pacotes de outras Unimeds. O Pacote genérico também precisa esta cadastrado é vinculado com a terminologia TISS com o tipo de tabela 98.
O código do Pacote da Unimed origem será gravado nos novos campos do item da guia: BE2_CDPACO, BEJ_CDPACO e BQV_CDPACO.
Após o recebimento de uma transação que contém pacote, o sistema irá se comunicar com o SISPAC para gravação da composição do pacote (B43).
Todos os pacotes recebidos ficaram na tabela B6L.
Importante
Todas as alterações descritas neste item foram necessárias devido a regras impostas pela Unimed do Brasil em seus manuais e comunicados.
Schedule SISPAC
Foi criado um schedule para comunicação com o SISPAC.
Todos os pacotes recebidos estão na tabela B6L, portanto esse schedule poderá ser agendado para o sistema consultar novamente o SISPAC, caso algum pacote não tenha gravado a composição no momento do recebimento, por erro de comunicação ou algo do tipo.
Configuração do Schedule:
Rotina: PLSSisPacSc
Parâmetro: Código da Operadora
04. DEMAIS INFORMAÇÕES
Não se aplica.
05. ASSUNTOS RELACIONADOS
- Não se aplica.