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 |
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
![](/download/attachments/622501343/image2021-6-8_17-12-13.png?version=1&modificationDate=1623183133637&api=v2) No Remote, os dados de Login, Senha e Enpoint deveram ser informados no Cadastro de Operadoras de Saúde, na Aba Integrações Unimed:
![](/download/attachments/622501343/image2021-6-8_17-26-4.png?version=1&modificationDate=1623183964933&api=v2)
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 | Decimal | Titulo | Descrição | Picture | Usado | Exibe Browser | Visual? | Contexto | Obrigatório | Pasta SXA |
---|
BA0_USRGIU | Caracter | 20 | 0 | Login GIU | Login do usuario no GIU |
| Sim | Não | Alterar | Real | Não | 56 | BA0_PASGIU | Caracter | 50 | 0 | Senha GIU | Senha do usuario no GIU |
| Sim | Não | Alterar | Real | Não | 56 | BA0_ENDGIU | Caracter | 60 | 0 | EndPoint GIU | EndPoint GIU |
| Sim | Não | Alterar | Real | Não | 56 | BA0_BEAGIU | Memo | 10 | 0 | Bearer GIU | Bearer Retorno GIU |
| Sim | Não | Visualizar | Real | Não | 56 | BA0_COOGIU | Memo | 10 | 0 | Cookie GIU | Cookie de Retorno GIU |
| Sim | Não | Visualizar | Real | Não | 56 | BA0_TMPGIU | Caracter | 20 | 0 | 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 | 65 |
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 |
---|
|
|
|