Histórico da Página

...

Visão Geral
Exemplo de utilização
1. Grupos de Coberturas
2. Tabela de Códigos de Erros
Tela Coberturas do Beneficiário
1. Outras Ações / Ações relacionadas
Tela Coberturas do Beneficiário
1. Principais Campos e Parâmetros
Tabelas utilizadas

01. VISÃO GERAL

Este documento tem como objetivo demonstrar a utilização do endpoint de coberturas do beneficiário, que faz parte da api beneficiaryPosition do Produto TOTVS Saúde Planos Linha Protheus (totvsHealthPlans).

/totvsHealthPlans/v1/beneficiaryPosition/{subscriberId}/coverageGroup

Essee endpoint será utilizado na nova tela de posição do beneficiário, desenvolvida em PO UI. (Biblioteca de componentes baseado em Angular)

Clique aqui para detalhes sobre como habilitar o serviço de APIs

02. EXEMPLO DE UTILIZAÇÃO

...

Retorna uma coleção com os grupos de coberturas do beneficiário.

Endpoint

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

Image Modified

Parâmetros

SubscriberId (path)	Image Modified	Número da carteirinha do beneficiário	*required
Authorization (header)	Image Modified	Cabeçalho usado para autorização das requisições	*required
Content-Type (header)	Image Modified	'application/json' é o formato do conteúdo	*required

...

Request

Não possui body!

...

Operação realizada com sucesso (200)

items	Image Modified	Grupos de cobertura do beneficiário
items.groupCode	Image Modified	Código do grupo de cobertura Campo: BG7_CODGRU
items.coverageGroup	Image Modified	Descrição do grupo de cobertura Campo: BG7_DESCRI
items.level	Image Modified	Nível sendo:

Usuário

Usuario,

Família

Familia, Empresa e Produto
hasNext	Image Modified	Indica se ainda existem registros a serem retornados
remainingRecords	Image Modified	Quantidade de registros ainda existem para retorno

Bloco de código

language	c#
theme	Midnight
title	Exemplo de retorno - Sucesso
linenumbers	true
collapse	true

{
  "items": [
    {
      "groupCode": "004",
      "coverageGroup": "AMBULATORIAL",
      "level": "Produto"
    },
    {
      "groupCode": "007",
      "coverageGroup": "Z",
      "level": "Produto"
    }
  ],
  "hasNext": false,
  "remainingRecords": 0
}

Dados Inválidos (404)

code	Image Modified	Código identificador do erro. (Tabela de Erros)
message	Image Modified	Literal no idioma da requisição descrevendo o erro para o usuário.
detailedMessage	Image Modified	Mensagem técnica e mais detalhada do erro.

Bloco de código

language	c#
theme	Midnight
title	Exemplo de retorno - Falha
linenumbers	true
collapse	true

{
  "code": "E001",
  "message": "Beneficiário não encontrado.",
  "detailedMessage": "Não foi encontrado nenhum Beneficiário com a matricula 00011008000027012"
}

...

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

Code	message	detailedMessage
E001	Beneficiário não encontrado.	Não foi encontrado nenhum Beneficiário com a matricula {subscriberId}

03. TELA COBERTURAS DO BENEFICIÁRIO

...

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave