Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

02. EXEMPLO DE UTILIZAÇÃO

Dados do Contrato

Retorna os dados de contrato do beneficiário (Tabela BA1).

...

Bloco de código
languagec#
themeMidnight
titleExemplo de retorno - Falha
linenumberstrue
collapsetrue
{
  "code": "E001",
  "message": "Beneficiário não encontrado.",
  "detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000026010"
}

Beneficiários da Família

Retorna todos os beneficiários pertencente a família.

Endpoint

Url

Verbo

https://<url>:porta>/rest/totvsHealthPlans/v1/beneficiaryPosition/{subscriberId}/familyBeneficiariesGET

Parâmetros

SubscriberId (path)StringNúmero da carteirinha do beneficiário*required
Authorization (header)StringCabeçalho usado para autorização das requisições*required

Content-Type (header)

String'application/json' é o formato do conteúdo*required


...

Request

Sem Body

...

Operação realizada com sucesso (200)

beneficiaries

ArrayBeneficiários da Família
beneficiaries.cardStringCarteirinha do Beneficiário
beneficiaries.nameStringNome do Beneficiário
beneficiaries.kinshipStringGrau de Parentesco do Beneficiário
beneficiaries.situationStringSituação atual do Beneficiário, sendo: Ativo, Bloqueado ou Bloqueio Futuro
Bloco de código
languagec#
themeMidnight
titleExemplo de retorno - Sucesso
linenumberstrue
collapsetrue
{
  "beneficiaries": [
    {
      "card": "00011008000027010",
      "name": "HERNANDES ALVES DA SILVA",
      "kinship": "BENEFICIARIO TITULAR",
      "situation": "Ativo"
    },
    {
      "card": "00011008000027028",
      "name": "FABIANA SOPHIA MELO",
      "kinship": "CONJUGE/ COMPANHEIRO",
      "situation": "Ativo"
    }
  ]
}


...

Dados Inválidos (404) 

code

StringCódigo identificador do erro. (Tabela de Erro)*required

message

StringLiteral no idioma da requisição descrevendo o erro para o usuário.*required

detailedMessage

StringMensagem técnica e mais detalhada do erro.*required
Bloco de código
languagec#
themeMidnight
titleExemplo de retorno - Falha
linenumberstrue
collapsetrue
{
  "code": "E001",
  "message": "Beneficiário não encontrado.",
  "detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000026010"
}

...

Código de erros informado no Json de retorno com falha (404):

CodemessagedetailedMessage
E001

Beneficiário não encontrado.

Não foi encontrado nenhum beneficiário com a matricula {subscriberId}

03. TELA DADOS DE CONTRATO

...