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).
Esse endpoint é 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
Retorna os beneficiários da pesquisa informado.
| https://<url>:porta>/rest/totvsHealthPlans/v1/beneficiaryPosition/search | GET |
| Authorization (header) | String | Cabeçalho usado para autorização das requisições | *required |
Content-Type (header) | String | 'application/json' é o formato do conteúdo | *required |
| key (query) | String | Chave de pesquisa dos beneficiários, sendo:
| *required |
| page (query) | Integer | Paginação da Coleção | |
| pageSize (query) | Integer | Quantidade de Itens por Página | |
| order (query) | String | Ordenação da Coleção | |
| fields (query) | String | Filtrando campos de registros | |
| filter (query) | String | Indica o filtro querystring recebido (pode se utilizar um filtro oData) |
Não possui body!
beneficiaries | Array | Beneficiários encontrados na pesquisa |
| beneficiaries.card | String | Carteirinha do beneficiário Campo: BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO |
| beneficiaries.name | String | Nome do beneficiário Campo: BA1_NOMUSR |
| beneficiaries.type | String | Tipo do beneficiário, sendo: T (Titular), D (Dependente) e A (Agregado) Campo: BA1_TIPUSU |
| beneficiaries.kinship | Array | Grau de parentesco do beneficiário Campo: BRP_DESCRI (Relacionamento pelo BA1_GRAUPA) |
| beneficiaries.situation | Array | Situação atual do beneficiário, sendo: Ativo, Bloqueado ou Bloqueio Futuro |
| hasNext | Boolean | Indica se ainda existem registros a serem retornados |
| remainingRecords | Integer | Quantidade de registros ainda existem para retorno |
{
"beneficiaries": [
{
"card": "00010094000004017",
"name": "MARIANA SANTOS DA SILVA",
"type": "T",
"kinship": "BENEFICIARIO TITULAR",
"situation": "Ativo"
},
{
"card": "00011008000026021",
"name": "JAQUELINE MARIANE ROSA SILVEIRA",
"type": "D",
"kinship": "FILHO",
"situation": "Ativo"
},
{
"card": "00011012000001019",
"name": "MARIANA LARISSA MARIAH RAMOS",
"type": "T",
"kinship": "BENEFICIARIO TITULAR",
"situation": "Ativo"
}
],
"hasNext": false,
"remainingRecords": 0
} |
code | String | Código identificador do erro. (Tabela de Erro) |
message | String | Literal no idioma da requisição descrevendo o erro para o usuário. |
detailedMessage | String | Mensagem técnica e mais detalhada do erro. |
{
"code": "E001",
"message": "Beneficiário não encontrado.",
"detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000026010"
} |
Outras Ações / Ações relacionadas
| Ação | Descrição |
|---|---|
| Inclua a ação | Inclua a descrição relacionada |
| Inclua a ação | Inclua a descrição relacionada |
| Inclua a ação | Inclua a descrição relacionada |
Principais Campos e Parâmetros
| Campo | Descrição |
|---|---|
| Inclua o campo | Inclua a descrição relacionada |
| Inclua o campo | Inclua a descrição relacionada |
| Inclua o campo | Inclua a descrição relacionada |