Histórico da Página

...

Produto:

TOTVS Saúde Planos

Solucoes_totvs

Solucao

Solucoes_totvs_cross

SolucaoCross

Solucoes_totvs_parceiros

SolucaoParceiros

Solucoes_totvs_parceirosexptotvs

SolucaoParcsExpsTOTVS

Linha de Produto:

Linha Protheus

Linhas_totvs

Segmento:

Saude

Segmentos_totvs

Segmento

Módulo:

PLANO DE SAÚDE (SIGAPLS)

Função:

Protocolo de Negativas (PLSA773)
API GPU (PLSGPURest)

Ticket:

10771696

Requisito/Story/Issue (informe o requisito relacionado) :

DSAUBE-13814

02. SITUAÇÃO/REQUISITO

Necessidade de implementar integração com o GPU - Gestão de Protocolos Unimed através de API REST, substituindo a integração via Web Service Soap.

03. SOLUÇÃO

Implementada melhoria no processo da RNº 395 para Operadoras Cooperativas Médicas Unimed, onde Foram criados serviços REST, para gerenciamento de protocolos de atendimento de beneficiários de intercâmbio.

Na nova versão do PTU foram alteradas as tabelas utilizadas para trafegar:

Image Removed

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.

Totvs custom tabs box

tabs	Implementação, Configuração, Atualizações do Compatibilizador, Procedimento para UtilizaçãoAmbiente, Autenticação, Api PLSGPUREST, Atualizações de Dicionário
ids	passo1,passo2,passo3,passo4

Configuração de Parâmetros:

No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure o(s) parâmetro(s) a seguir:

Tabelas:

1 - Criação de Tabelas no arquivo SX2 - Tabela

2 - Criação de Índices no arquivo SIX - Índices

3 - Criação de Campos no arquivo SX3 - Campos

1 - Criação de Tabelas no arquivo SX2 - Tabela

2 - Criação de Índices no arquivo SIX - Índices

3 - Criação de Campos no arquivo SX3 - Campos

Totvs custom tabs box items

default	yes
referencia	passo1

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>

Importante: Para funcionamento correto do processo de comunicação com o GPU, é necessário configurar o REST na porta 443 e o Endpoint tem que ter o nome domínio do certificado, Exemplo:

Image Removed

Logo, a minha URL será: http://localhost:8080https://gpu.xx.unimed.com.br/rest/PLSGPUREST/v1/solicitarProtocolocancelarAtendimento

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_R395SOL	Solicitar Protocolo de Atendimento - Beneficiário
MV_R395COM	Complementar Protocolo de Atendimento
MV_R395RES	Responder Atendimento
MV_R395STA	Consulta Status de Protocolo
MV_R395HIS	Consultar Histórico do Protocolo
MV_R395CAN	Cancelar Atendimento
MV_R395ENC	Encaminhar Execução da Manifestação

Autenticação de Usuário no GIU

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.

Totvs custom tabs box items

default	no
referencia	passo2

Itens/Pastas

Descrição

Nome:

MV_PTUVEON

Tipo:

Caracter

Cont. Por.:

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

Totvs custom tabs box items

default	no
referencia	passo3

Totvs custom tabs box

tabs	B6M,B6L,BR8,BE2,BQV,BEJ,BA0
ids	passo01,passo02,passo03,passo04,passo05,passo06,passo07

Totvs custom tabs box items

default	yes
referencia	passo01

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

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

Campo:

B6M_FILIAL

Tipo:

C - Caractere

Tamanho:

Título:

Filial

Descrição:

Filial

Picture:

Usado:

Não usado

Contexto:

Real

Propriedade:

Visualizar

Campo:

B6M_OPEMOV

Tipo:

C - Caractere

Tamanho:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

Título:

Mens. Livre

Descrição:

Mensagem Livre

Picture:

Usado:

Usado

Contexto:

Real

Propriedade:

Visualizar

Help

Descrição da Mensagem Livre

Totvs custom tabs box items

default	no
referencia	passo02

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

Ordem

Chave

1

B6L_FILIAL+B6L_OPEMOV+B6L_ANOAUT+B6L_MESAUT+B6L_NUMAUT

2

B6L_FILIAL+B6L_NRTROL

Campo:

B6L_FILIAL

Tipo:

C - Caractere

Tamanho:

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

Totvs custom tabs box items

default	no
referencia	passo03

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.

Totvs custom tabs box items

default	no
referencia	passo04

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

Totvs custom tabs box items

default	no
referencia	passo05

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

Totvs custom tabs box items

default	no
referencia	passo06

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

Totvs custom tabs box items

default	no
referencia	passo07

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

Card documentos

Informacao	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.
Titulo	Importante

Totvs custom tabs box items

default	no
referencia	passo4

Totvs custom tabs box

tabs	Tipos de Tabelas, Tabela PTU Online,Configuração SISPAC,Transações com Pacote,Schedule SISPAC
ids	passo08,passo09,passo10,passo11,passo12

Totvs custom tabs box items

default	yes
referencia	passo08

Card documentos

Informacao	Importante que todos os serviços que forem trafegar no PTU Online estejam vinculados com a Terminologia TISS.
Titulo	Observação

Totvs custom tabs box items

default	no
referencia	passo09

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:

Image Removed

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.

Totvs custom tabs box items

default	no
referencia	passo10

Para comunicação do sistema com o WebService do SISPAC, é necessário que os seguintes campos estejam configurados no cadastro da operadora saúde:

Image Removed

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.

Totvs custom tabs box items

default	no
referencia	passo11

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.

Card documentos

Informacao	Todas as alterações descritas neste item foram necessárias devido a regras impostas pela Unimed do Brasil em seus manuais e comunicados.
Titulo	Importante

Totvs custom tabs box items

default	no
referencia	passo12

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

Image Removed

04. DEMAIS INFORMAÇÕES

Não se aplica

05. ASSUNTOS RELACIONADOS

Observação: Para habilitar a API de envio para os Endpoints do GPU, deverá ser ativado o parâmetro MV_PGPURES com o conteúdo igual a "1".

Totvs custom tabs box items

default	no
referencia	passo2

Autenticação de Usuário para o GPU

Para que seja realizada uma requisição a API do GPU, deverá ser realizado a autenticação de uma Conta de Serviço ou Aplicação no GIU:

Operação: Obter Token a partir de login e senha
Image Added

No Remote, os dados de Login, Senha e Enpoint deveram ser informados no Cadastro de Operadoras de Saúde, na Aba Integrações Unimed:

Image Added

Login GIU: Login do usuário no GIU/Client ID
Senha GIU: Senha do usuário no GIU / Client Secret
EndPoint GIU: Endpoint Produção da Unimed Brasil
Bearer GIU: Token de autenticação
Cookie GIU: Cookie utilizado para Autenticação
Tempo Exper.: Tempo para expiração do Token. no Formato: Data|Segundos

Observação: Os campos de Bearer, Cookie e Tempo Exper. serão preenchidos automaticamente pelo sistema ao realizar alguma requisição ao GPU. Na questão de expiração do acesso, o sistema irá sempre verificar o campo Tempo Exper. para verificar se será solicitado um novo Token de acesso.

Totvs custom tabs box items

default	no
referencia	passo3

Serviços disponíveis para Integração GPU:

Totvs custom tabs box

tabs	solicitarProtocolo,complementaProtocolo,responderAtendimento,consultaStatusProtocolo,historicoProtocoloConsulta,cancelarAtendimento,encaminharExecucao
ids	passo01,passo02,passo03,passo04,passo05,passo06,passo07

Totvs custom tabs box items

default	yes
referencia	passo01

Serviço de Solicitação Protocolo de Atendimento - Beneficiário

Objetivo: Disponibilizar o serviço “Solicitar Protocolo de Atendimento - Beneficiário”.
Enviar uma mensagem para a Unimed referente à uma manifestação de seu beneficiário. O retorno da mensagem será um Protocolo conforme padrão ANS.

Operação: solicitarProtocolo
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/solicitarProtocolo
Tipo: Rest Full
Método requisição: POST
Método resposta: GET

Bloco de código

theme	RDark
title	JSON de Envio
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "001",
        "tp_cliente": "UNIMED",
        "cd_uni_origem": "0001",
        "cd_uni_destino": "0667",
        "nr_ans": "000667",
        "nr_transacao_prestadora": "0000046846",
        "dt_manifestacao": "2020-08-01 12:00:00",
        "id_usuario": "teste",
        "nr_versao_protocolo": "001"
    },
    "solicitar_protocolo": {
        "nome": "teste",
        "cd_unimed": "0666",
        "id_benef": "0000000000006",
        "cd_cpf": "09520811990",
        "ddd": "11",
        "telefone": "964269563",
        "email": "[email protected]",
        "cd_uf": "SC",
        "cd_cidade": "4205407",
        "cd_uni_atendimento": "0025",
        "tp_manifestacao": "7",
        "tp_categoria_manifestacao": [18],
        "id_resposta": 3,
        "nr_transacao_intercambio": "0000054545",
        "nr_protocolo_anterior": null,
        "mensagem": "Nathali"
    }
}

Bloco de código

theme	RDark
title	JSON de Resposta
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "002",
        "tp_cliente": "PORTAL",
        "cd_uni_origem": "0999",
        "cd_uni_destino": "0666",
        "nr_ans": "999999",
        "nr_transacao_prestadora": "0000046846",
        "id_usuario": "fgdfgg",
        "nr_versao_protocolo": "001"
    },
    "resposta_solicitar_protocolo": {
        "cd_unimed": "0666",
        "id_benef": "0000000000005",
        "nr_protocolo": "12345678912345677777",
        "id_resposta": 3,
        "mensagem": "teste",
        "id_sistema": 2
    }
}

Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".

Totvs custom tabs box items

default	no
referencia	passo02

Serviço Complementar Protocolo de Atendimento

Objetivo: Disponibilizar o serviço “Complementar Protocolo de Atendimento”.
Enviar uma mensagem para a Unimed referente à uma manifestação de seu beneficiário. Essa mensagem poderá ser vinculada à uma transação de Intercâmbio entre as Unimeds e/ou a um protocolo de atendimento existente.

Operação: complementaProtocolo
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/complementaProtocolo
Tipo: Rest Full
Método requisição: POST
Método resposta: GET

Bloco de código

theme	RDark
title	JSON de Envio
linenumbers	true
collapse	true

{
    "cabecalho_transacao":{
        "cd_transacao":"003",
        "tp_cliente":"UNIMED",
        "cd_uni_origem":"0001",
        "cd_uni_destino": "0667",
        "nr_ans": "000667",
        "nr_transacao_prestadora":"0000046846",
        "dt_manifestacao":"2020-08-01 12:00:00",
        "id_usuario":"teste",
        "nr_versao_protocolo":"001"
    },
    "pedido_complemento_protocolo":{
        "cd_unimed":"0667",
        "id_benef": "0000000000002",
        "nr_protocolo":"12345678912345679999",
        "mensagem":"teste",
        "nr_transacao_intercambio":"1234567891",
        "id_resposta":3
    }
}

Bloco de código

theme	RDark
title	JSON de Resposta
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "004",
        "tp_cliente": "PORTAL",
        "cd_uni_origem": "0999",
        "cd_uni_destino": "0666",
        "nr_ans": "999999",
        "nr_transacao_prestadora": "0000046846",
        "id_usuario": "fgdfgg",
        "nr_versao_protocolo": "001"
    },
    "resposta_complemento": {
        "cd_unimed": "0666",
        "id_benef": "0000000000005",
        "id_origem_resposta": 2
    }
}

Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".

Totvs custom tabs box items

default	no
referencia	passo03

Serviço Responder Atendimento

Objetivo: Disponibilizar o serviço “Responder Atendimento”.
Enviar uma mensagem para a Unimed referente à resposta de manifestação de seu beneficiário.

Operação: responderAtendimento
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/responderAtendimento
Tipo: Rest Full
Método requisição: POST
Método resposta: GET

Bloco de código

theme	RDark
title	JSON de Envio
linenumbers	true
collapse	true

{
   "cabecalho_transacao": {
        "cd_transacao": "005",
        "tp_cliente": "UNIMED",
        "cd_uni_origem": "0001",
        "cd_uni_destino": "0667",
        "nr_ans": "000667",
        "nr_transacao_prestadora":"0000046846",
        "dt_manifestacao": "2020-08-01 12:00:00",
        "id_usuario": "teste",
        "nr_versao_protocolo": "001"
    },
    "resposta_atendimento": {
        "cd_unimed": "0666",
        "id_benef": "0000000000006",
        "nr_protocolo": "12345678912345679999",
        "id_resposta": 3,
        "nr_transacao_origem_benef": "1234567891",
        "nr_transacao_intercambio": "1234567891",
        "mensagem": "teste"
    }
}

Bloco de código

theme	RDark
title	JSON de Resposta
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "006",
        "tp_cliente": "PORTAL",
        "cd_uni_origem": "0999",
        "cd_uni_destino": "0666",
        "nr_ans": "999999",
        "nr_transacao_prestadora": "0000046846",
        "id_usuario": "fgdfgg",
        "nr_versao_protocolo": "001"
    },
    "resposta_atendimento": {
        "cd_unimed": "0666",
        "id_benef": "0000000000005",
        "id_origem_resposta": 1
    }
}

Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".

Totvs custom tabs box items

default	no
referencia	passo04

Consultar Status do Protocolo

Objetivo: Disponibilizar o serviço “Consulta Status de Protocolo”.
Enviar uma mensagem para a Unimed referente à consulta de status de um protocolo existente.

Operação: consultaStatusProtocolo
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/consultaStatusProtocolo
Tipo: Rest Full
Método requisição: POST
Método resposta: GET

Bloco de código

theme	RDark
title	JSON de Envio
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "007",
        "tp_cliente": "UNIMED",
        "cd_uni_origem": "0001",
        "cd_uni_destino": "0032",
        "nr_ans": "304701",
        "nr_transacao_prestadora": "0000046846",
        "dt_manifestacao": "2020-08-01 12:00:00",
        "id_usuario": "teste",
        "nr_versao_protocolo": "001"
    },
    "consulta_status_protocolo": {
        "cd_unimed": "0666",
        "id_benef": "0000000000006",
        "nr_protocolo": "12345678912345679997"
    }
}

Bloco de código

theme	RDark
title	JSON de Resposta
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "008",
        "tp_cliente": "PORTAL",
        "cd_uni_origem": "0001",
        "cd_uni_destino": "0032",
        "nr_ans": "304701",
        "nr_transacao_prestadora": "0000046846",
        "dt_sol_protocolo": "2020-08-01 12:00:00",
        "nr_versao_protocolo": "001"
    },
    "resposta_consulta_status_protocolo": {
        "cd_unimed": "0666",
        "id_benef": "0000000000006",
        "nome": "teste",
        "tp_manifestacao": null,
        "tp_categoria_manifestacao": [
            18
        ],
        "nr_protocolo": "12345678912345679997",
        "id_resposta": 3,
        "num_trans_interc_prestadora": null,
        "num_trans_origem_beneficiario": null,
        "id_origem_resposta": 2,
        "id_usuario": "teste",
        "dt_solicitacao_protocolo": "2021-01-14 14:27:02",
        "mensagem": "Nathali"
    }
}

Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".

Totvs custom tabs box items

default	no
referencia	passo05

Consultar Histórico do Protocolo

Objetivo: Disponibilizar o serviço “Consultar Historico do Protocolo”.
Enviar uma mensagem para a Unimed referente à consulta do histórico de protocolos do beneficiário

Operação: historicoProtocoloConsulta
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/historicoProtocoloConsulta
Tipo: Rest Full
Método requisição: POST
Método resposta: GET

Bloco de código

theme	RDark
title	JSON de Envio
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "009",
        "tp_cliente": "UNIMED",
        "cd_uni_origem": "0001",
        "cd_uni_destino": "0667",
        "nr_ans": "000667",
        "nr_transacao_prestadora": "0000046846",
        "dt_manifestacao": "2021-02-15 01:00:00",
        "id_usuario": "teste",
        "nr_versao_protocolo": "001"
    },
    "consulta_historico": {
        "cd_unimed": "0666",
        "id_benef": "0000000000006",
        "dt_inicio_historico": "2021-01-01 12:00:00",
        "dt_fim_historico": "2021-02-18 12:00:00"
    }
}

Bloco de código

theme	RDark
title	JSON de Resposta
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "010",
        "tp_cliente": "PORTAL",
        "cd_uni_origem": "0999",
        "cd_uni_destino": "0666",
        "nr_ans": "999999",
        "nr_transacao_prestadora": "0000046846",
        "id_usuario": "fgdfgg",
        "nr_versao_protocolo": "001"
    },
    "resposta_consulta_historico": {
        "dt_manifestacao": "2020-08-01 12:00:00",
        "nr_protocolo": "12345678912345677777",
        "id_resposta": 4,
        "id_sistema": 2
    }
}

Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".

Totvs custom tabs box items

default	no
referencia	passo06

Cancelar Atendimento

Objetivo: Disponibilizar o serviço “Cancelar Atendimento”.
Enviar uma mensagem de cancelamento para a Unimed.

Operação: cancelarAtendimento
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/cancelarAtendimento
Tipo: Rest Full
Método requisição: POST
Método resposta: GET

Bloco de código

theme	RDark
title	JSON de Envio
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "011",
        "tp_cliente": "UNIMED",
        "cd_uni_origem": "0001",
        "cd_uni_destino": "0667",
        "nr_ans": "000667",
        "nr_transacao_prestadora": 1234567891,
        "dt_cancelamento": "2020-01-01 14:14:00",
        "id_usuario": "GPU Teste local",
        "nr_versao_protocolo": "001"
    },
    "cancelamento": {
        "cd_unimed": "0971",
        "id_benef": "0000000000005",
        "nr_protocolo": "12345678912345679999",
        "motivo_cancelamento": "teste"
    }
}

Bloco de código

theme	RDark
title	JSON de Resposta
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "012",
        "tp_cliente": "PORTAL",
        "cd_uni_origem": "0618",
        "cd_uni_destino": "0971",
        "nr_ans": "367087",
        "nr_transacao_prestadora": "1234567891",
        "id_usuario": "GPU Teste local",
        "nr_versao_protocolo": "001"
    },
    "confirmacao": {
        "cd_unimed": "0971",
        "id_benef": "0000000000005",
        "id_resposta": 4,
        "nr_protocolo": "12345678912345678912",
        "id_sistema": 2
    }
}

Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".

Totvs custom tabs box items

default	no
referencia	passo07

Encaminhar Execução

Objetivo: Disponibilizar o serviço “Encaminhar Execução da Manifestação”.
Enviar uma mensagem da Unimed Origem do Beneficiário para a Unimed Repasse resolver uma manifestação (conforme acordo prévio entre as Singulares). O retorno da mensagem será uma Confirmação de recebimento e uma posterior Resposta do Atendimento pela Unimed Repasse. Detalhes em: RN 395 – Fluxo REPASSE.
Premissa: No cenário descrito a Unimed Origem já enviou o número do Protocolo para a Unimed Solicitante e apenas está encaminhando a manifestação para resolução da Unimed Repasse.

Operação: encaminharExecucao
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/encaminharExecucao
Tipo: Rest Full
Método requisição: POST
Método resposta: GET

Bloco de código

theme	RDark
title	JSON de Envio
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "013",
        "tp_cliente": "UNIMED",
        "cd_uni_origem": "0001",
        "cd_uni_destino": "0032",
        "nr_ans": "304701",
        "nr_transacao_prestadora": "0000046846",
        "dt_manifestacao": "2020-08-01 12:00:00",
        "id_usuario": "teste",
        "nr_versao_protocolo": "001"
    },
    "encaminhar_execucao": {
        "cd_unimed": "0666",
        "id_benef": "0000000000006",
        "nome": "teste",
        "cd_cpf": "09520811990",
        "ddd": "0048",
        "telefone": "96426956",
        "email": "[email protected]",
        "tp_manifestacao": "1",
        "tp_categoria_manifestacao": [1],   
        "nr_transacao_intercambio": "0000054545",
        "nr_protocolo_anterior": "30470120210119900003",
        "mensagem": "Nathali"
    }
}

Bloco de código

theme	RDark
title	JSON de Resposta
linenumbers	true
collapse	true

{
    "cabecalho_transacao": {
        "cd_transacao": "014",
        "tp_cliente": "PORTAL",
        "cd_uni_origem": "0001",
        "cd_uni_destino": "0032",
        "nr_ans": "304701",
        "nr_transacao_prestadora": "0000046846",
        "id_usuario": "Gestão de Protocolos - Contingência",
        "nr_versao_protocolo": "001"
    },
    "confirmacao": {
        "cd_unimed": "0032",
        "id_benef": "0000000000006",
        "id_resposta": 4,
        "nr_protocolo": "30470120210119900003",
        "id_sistema": 2
    }
}

Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".

Totvs custom tabs box items

default	no
referencia	passo4

Inclusão no Arquivo SX3 - Campos:

Campo	Tipo	Tamanho	Titulo	Descrição	Picture	Usado	Exibe Browser	Visual?	Contexto	Obrigatório	Pasta SXA
BA0_USRGIU	Caracter	20	Login GIU	Login do usuario no GIU		Sim	Não	Alterar	Real	Não	6
BA0_PASGIU	Caracter	50	Senha GIU	Senha do usuario no GIU		Sim	Não	Alterar	Real	Não	6
BA0_ENDGIU	Caracter	60	EndPoint GIU	EndPoint GIU		Sim	Não	Alterar	Real	Não	6
BA0_BEAGIU	Memo	10	Bearer GIU	Bearer Retorno GIU		Sim	Não	Visualizar	Real	Não	6
BA0_COOGIU	Memo	10	Cookie GIU	Cookie de Retorno GIU		Sim	Não	Visualizar	Real	Não	6
BA0_TMPGIU	Caracter	20	Tempo Exper.	Tempo de Expericao	@!	Sim	Não	Visualizar	Real	Não	6

Alteração no Arquivo SX3 - Campos:

Campo	Pasta SXA
BA0_URLPAC	6
BA0_STKPAC	6
BA0_USRPAC	6
BA0_PWDPAC	6
BA0_TOKPAC	6

Inclusão no Arquivo SX6 - Parâmetros:

Itens/Pastas	Descrição
Nome:	MV_PGPURES
Tipo:	Caracter
Descrição:	Habilita Protocolos GPU via Rest
Cont. Por.:	0

Inclusão no Arquivo SXA - Pastas:

Tabela	Ordem	Descrição
BA0	6	Integrações Unimed

Card documentos

Informacao	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.
Titulo	Importante

04. DEMAIS INFORMAÇÕES

Não se aplica.

05. ASSUNTOS RELACIONADOS

12045528 DSAUBE-15638 DT GPU - Serviços de Protocolo para não Clientes Não se aplica

Templatedocumentos

HTML

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

Árvore de páginas

Versões comparadas

Versão antiga 3

Nova versão Atual

Chave

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO

Mudanças realizadas nas transações do PTU Online 8.0 contendo pacotes

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS