...
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 |
|
| Authorization (header) |
| Cabeçalho usado para autorização das requisições | *required |
Content-Type (header) |
| 'application/json' é o formato do conteúdo | *required |
| key (query) |
| Chave de pesquisa dos beneficiários, sendo:
| *required |
| page (query) |
| Paginação da Coleção | |
| pageSize (query) |
| Quantidade de Itens por Página | |
| order (query) |
| Ordenação da Coleção | |
| fields (query) |
| Filtro de campos dos registros | |
| filter (query) |
| Indica o filtro querystring recebido (pode se utilizar um filtro oData) |
...
Não possui body!
...
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 |
| 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 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"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
} |
...
...
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 |
...
| 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 |
