Ir para o final dos metadados
Ir para o início dos metadados

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

Versão 1 Atual »

Só são suportadas integrações no padrão REST.

Introdução

Método de listagem dos indicadores favoritos do paciente

Método "aps/atividade/realizaAtividade"

Endpoint

Endpoint

Método

Header Content-Type

Descrição

exemplo.com / aps/curso/inscricao

POST

application/json

 

Parâmetros de entrada

Serão enviados no HEADER os headers estáticos definidos ao configurar a integração, combinado com os tokens retornados pela configuração de autorização da integração (caso seja vinculada) e os headers de segurança retornado no login do beneficiário.

Serão enviados no BODY os seguintes parâmetros:

Parâmetro

Obrigatório

Tipo

Descrição

 Regra de preenchimento

chaveUnica

M

String

Chave de identificação do usuário retornada no login

 

integracao

OP

Objeto

Nó integração retornado no login do usuário

 

beneficiario

M

Objeto

Beneficiario selecionado para agendamento da consulta

 

idAtividade

C

String

Código identificador da atividade

Obrigatorio quando for atraves da realizacao de uma atividade

idAtendimento

C

String

Código identificador do atendimento

Obrigatorio quando for atraves da realizacao de uma atividade

idCurso

M

String

Código identificador do tipo de atendimento

idTurma

M

String

Código identificador do questionario cadastrado no previva

 

{
    "chaveUnica":"String",
    "integracao":{ Objeto },
    "beneficiario":{ Objeto }
    "idAtividade": "String",
    "idAtendimento": "String",
    "idTurma": "String",
    "idCurso": "String"
}

 

Objeto beneficiario

Atributo

Critério

Tipo

Descrição

Regra de preenchimento

chaveUnica

M

String

Chave de identificação do paciente

 

numeroContrato

M

String

Número do contrato do paciente

 

integracao

OP

Objeto

Nó integração retornado no login do usuário

 

{
    "beneficiario":{
      "chaveUnica":"String",
      "numeroContrato":"String",
      "integracao":{ Objeto }
}

Exemplo request

{
  "chaveUnica": "101012",
  "integracao": {
    "cpf": "123456789123",
    "numero_cartao": "9288701",
  },
  "beneficiario": {
    "chaveUnica": "101012", //geralmente é o cpf
    "numeroContrato": "616161",
    "integracao": {
        "cpf": "123456789123", 
        "numero_cartao": "9288701",
      },
    },
    "idAtividade":"39",
    "idAtendimento":"39",
    "idTurma":"39",
    "idCurso": "1",     
}

 

Descrição dos objetos e atributos de retorno - Sucesso

Está indicado abaixo a estrutura de retorno do método. Esse método deve obedecer as regras indicadas no objeto principal e em seus desdobramentos.

 

Objeto principal

Atributo

Critério

Tipo

Descrição

Regra de preenchimento

protocolo

M

String

Numero de protocolo gerado pelo sistema da PREVIVA.

 

mensagem

M

String

Mensagem amigável que será exibida para o usuário

 

{
  "protocolo": "String",
  "mensagem": "String",
} 

Retorno da API - Sucesso

{
  "protocolo": "123",
  "mensagem": "Sucesso!"
}  

Retorno da API - Falha

{
  "mensagem": "Não foi possível registrar a sua inscrição..."
}  
  • Sem rótulos