Histórico da Página

...

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

/totvsHealthPlans/v1/beneficiaryPosition/{subscriberId}/search

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

...

https://<url>:porta>/rest/totvsHealthPlans/v1/beneficiaryPosition/search

Parâmetros

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
key (query)	Image Modified	Chave de pesquisa dos beneficiários, sendo: Nome (BA1_NOMUSR) Carteirinha (BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO) CPF (BA1_CPFUSR) Nome Social (BA1_NOMSOC)	*required
page (query)	Image Modified	Paginação da Coleção
pageSize (query)	Image Modified	Quantidade de Itens por Página
order (query)	Image Modified	Ordenação da Coleção
fields (query)	Image Modified	Filtro de campos dos registros
filter (query)	Image Modified	Indica o filtro querystring recebido (pode se utilizar um filtro oData)

...

Request

Não possui body!

...

Operação realizada com sucesso (200)

beneficiaries		Beneficiários encontrados na pesquisa
beneficiaries.card		Carteirinha do beneficiário Campo: BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO
beneficiaries.name		Nome do beneficiário Campo: BA1_NOMUSR
beneficiaries.socialName	Image Added	Nome social do beneficiário Campo: BA1_NOMSOC
beneficiaries.type		Tipo do beneficiário, sendo: T (Titular), D (Dependente) e A (Agregado) Campo: BA1_TIPUSU
beneficiaries.kinship		Grau de parentesco do beneficiário Campo: BRP_DESCRI (Relacionamento pelo BA1_GRAUPA)
beneficiaries.situation		Situação atual do beneficiário, sendo: Ativo, Bloqueado ou Bloqueio Futuro Campo: BA1_DATBLO
hasNext		Indica se ainda existem registros a serem retornados
remainingRecords		Quantidade de registros ainda existem para retorno

Bloco de código

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

{
  "beneficiaries": [
    {
      "card": "00010094000004017",
      "name": "MARIANA SANTOS DA SILVA",
      "socialname": "",
      "type": "T",
      "kinship": "BENEFICIARIO TITULAR",
      "situation": "Ativo"
    },
    {
      "card": "00011008000026021",
      "name": "JAQUELINE MARIANE ROSA SILVEIRA",
      "socialname": "",
      "type": "D",
      "kinship": "FILHO",
      "situation": "Ativo"
    },
    {
      "card": "00011008000027010",
      "name": "HERNANDES ALVES DA SILVA",
      "socialname": "MARIA HERNANDES",
      "type": "T",
      "kinship": "BENEFICIARIO TITULAR",
      "situation": "Ativo"
    },
    {
      "card": "00011008000029020",
      "name": "MARIA DO CARMO",
      "socialname": "",
      "type": "D",
      "kinship": "CONJUGE/ COMPANHEIRO",
      "situation": "Ativo"
    },
    {
      "card": "00011012000001019",
      "name": "MARIANA LARISSA MARIAH RAMOS",
      "socialname": "",
      "type": "T",
      "kinship": "BENEFICIARIO TITULAR",
      "situation": "Ativo"
    }
  ],
  "hasNext": false,
  "remainingRecords": 0
}

...

Mensagens de Erros

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

...

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

Code	message	detailedMessage	Status Code
E001	Nenhuma chave de busca informada.	Obrigatório informar no query param a chave (key) de busca do beneficiário.	400

03. TELA PESQUISA DE BENEFICIÁRIOS

...

Campo	Descrição
BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO	Carteirinha de pesquisa do beneficiário
BA1_NOMUSR	Nome de pesquisa do beneficiário
BA1_CPFUSR	CPF de pesquisa do beneficiário
BA1_NOMSOC	Nome social do beneficiário

05. TABELAS UTILIZADAS

BA1 - Beneficiários
BRP - Graus de Parentesco

Árvore de páginas

Versões comparadas

Versão antiga 10

Nova versão Atual

Chave