01. DADOS GERAIS

Produto:

TOTVS Saúde Planos

Linha de Produto:

Linha Protheus 

Segmento:

Saude 

Módulo:PLANO DE SAÚDE (SIGAPLS)
Função:
Ticket:10771696
Requisito/Story/Issue (informe o requisito relacionado) :DSAUBE-13814


02. SITUAÇÃO/REQUISITO


03. SOLUÇÃO


Configuração REST

Para iniciar a instalação do processo, devemos configurar seu INI Protheus com a funcionalidade REST para habilitar o acesso as API´s.
Com o INI Protheus configurado, a nomenclatura das API´s ficará no formato: <url + Porta + Chave rest definidos no INI Protheus> +  PLSGPUREST/v1/ + <nome da API>
Exemplo:

Logo, a minha URL será: http://localhost:8080/rest/PLSGPUREST/v1/solicitarProtocolo



Endpoints do GPU - Gestão de Protocolos Unimed

Solicite para a Unimed do Brasil, os Endpoints em Produção do GPU, para que seja informado nos seguintes parâmetros (SX6):

MV_R395SOLSolicitar Protocolo de Atendimento - Beneficiário
MV_R395COMComplementar Protocolo de Atendimento
MV_R395RESResponder Atendimento
MV_R395STAConsulta Status de Protocolo
MV_R395HISConsultar Histórico do Protocolo
MV_R395CANCancelar Atendimento
MV_R395ENCEncaminhar Execução da Manifestação



Autenticação de Usuário no GIU

  1. Solicite para a Unimed do Brasil, um certificado para sua operadora. 
  2. Renomeie o arquivo de certificado .p12 para certificado.p12.
  3. Em seu rootpath, crie a estrutura de pastas \ptuonweb\certificados\. Copie o arquivo certificado.p12 para este diretório.
  4. Ao utilizar a comunicação PTU pela primeira vez, o sistema criará os arquivos para comunicação ca.pem, cert.pem e key.pem.
  5. Importante: informe no parâmetro MV_PTONSEN a senha do certificado disponibilizado pela Unimed do Brasil.

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
cBox1=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
cBox1=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
cBoxA=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
cBox0=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
cBox1=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


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. 


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.


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




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