Histórico da Página
...
Retorna os dados de contrato do beneficiário (Tabela BA1).
Endpoint
Url
Verbo
| https://<url>:porta>/rest/totvsHealthPlans/v1/beneficiaryPosition/{subscriberId}/ |
| contract |
Parâmetros
| SubscriberId (path) |
| Número da carteirinha do beneficiário | *required | |
| Authorization (header) |
| Cabeçalho usado para autorização das requisições | *required | |
Content- |
Type (header) |
| 'application/json' é o formato do conteúdo | *required |
...
Request
Sem BodyNão possui body!
...
Operação realizada com sucesso (200)
fields |
| Dados do beneficiário de acordo com a tabela BA1 | ||
| fields.{campo do SX3} |
Os campos retornados da tabela BA1:
| ||
| fields.situation |
Situação atual do beneficiário, sendo: Ativo, Bloqueado ou Bloqueio Futuro Campo: BA1_DATBLO | ||
| fields.card |
Carteirinha do Beneficiário Campo: BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO | ||
| struct |
Estrutura dos fields de acordo com o dicionário de dados (SX3) | ||
| folders |
| Pastas do fields (Abas) de acordo com o dicionário de dados (SXA) |
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"fields": {
"ba1_cpfusr": "23576483098",
"ba1_drgusr": "",
"ba1_nomusr": "HERNANDES ALVES DA SILVA",
"ba1_datnas": "2001-06-15",
"ba1_sexo": "1",
"ba1_estciv": "Solteiro(a)",
"ba1_mae": "TESTE",
"ba1_endere": "",
"ba1_comend": "",
"ba1_bairro": "",
"ba1_munici": "",
"ba1_estado": "",
"ba1_pai": "",
"ba1_datblo": "",
"ba1_motblo": "",
"situation": "Ativo",
"card": "00011008000027010"
},
"struct": [
{
"field": "BA1_BAIRRO",
"type": "C",
"title": "Bairro",
"description": "Bairro do Usuario",
"picture": "@!",
"size": 20,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_COMEND",
"type": "C",
"title": "Complemento",
"description": "Complemento do Endereco",
"picture": "@!",
"size": 20,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_ENDERE",
"type": "C",
"title": "Endereço",
"description": "Endereco do Usuario",
"picture": "@!",
"size": 40,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_PAI",
"type": "C",
"title": "Nome Pai",
"description": "Nome do Pai",
"picture": "@!",
"size": 30,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_ESTADO",
"type": "C",
"title": "Estado",
"description": "Estado do Usuario",
"picture": "@!",
"size": 2,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_MUNICI",
"type": "C",
"title": "Município",
"description": "Municipio do Usuario",
"picture": "@!",
"size": 30,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_MAE",
"type": "C",
"title": "Mãe",
"description": "Nome da Mae",
"picture": "@!",
"size": 120,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_NOMUSR",
"type": "C",
"title": "Nome Usuário",
"description": "Nome do Usuario",
"picture": "@!",
"size": 70,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_DRGUSR",
"type": "C",
"title": "RG",
"description": "RG do Usuario",
"picture": "@!",
"size": 11,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_CPFUSR",
"type": "C",
"title": "CPF",
"description": "CPF do Usuário",
"picture": "@R 999.999.999-99",
"size": 11,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_ESTCIV",
"type": "C",
"title": "Estado Civil",
"description": "Estado Civil",
"picture": "@!",
"size": 1,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_SEXO",
"type": "C",
"title": "Sexo",
"description": "Sexo",
"picture": "@!",
"size": 1,
"decimals": 0,
"cbox": [
{
"value": "1",
"description": "Masculino"
},
{
"value": "2",
"description": "Feminino"
},
{
"value": "x",
"description": "Anonimizado"
}
],
"folder": "1"
},
{
"field": "BA1_DATNAS",
"type": "D",
"title": "Dt. Nascto.",
"description": "Data de Nascimento",
"picture": "@D",
"size": 8,
"decimals": 0,
"cbox": [],
"folder": "1"
},
{
"field": "BA1_MOTBLO",
"type": "C",
"title": "Motivo Bloq.",
"description": "Motivo do Bloqueio",
"picture": "@!",
"size": 3,
"decimals": 0,
"cbox": [],
"folder": "6"
},
{
"field": "BA1_DATBLO",
"type": "D",
"title": "Data Bloq.",
"description": "Data do Bloqueio",
"picture": "@D",
"size": 8,
"decimals": 0,
"cbox": [],
"folder": "6"
}
],
"folders": [
{
"id": "1",
"title": "Dados Pessoais"
},
{
"id": "3",
"title": "Relativos ao Plano"
},
{
"id": "4",
"title": "Cobranca"
},
{
"id": "5",
"title": "Ans"
},
{
"id": "6",
"title": "Outros"
},
{
"id": "7",
"title": "Regras de parcelamento"
}
]
} |
...
Dados Inválidos (404)
code |
| Código identificador do erro. (Tabela de Erro) |
message |
| Literal no idioma da requisição descrevendo o erro para o usuário. |
detailedMessage |
| Mensagem técnica e mais detalhada do erro. |
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"code": "E001",
"message": "Beneficiário não encontrado.",
"detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000026010"
} |
...
Retorna todos os beneficiários pertencente a família.
Endpoint
Url
Verbo
| https://<url>:porta>/rest/totvsHealthPlans/v1/beneficiaryPosition/{subscriberId}/familyBeneficiaries |
Parâmetros
| SubscriberId (path) |
| Número da carteirinha do beneficiário | *required | |
| Authorization (header) |
| Cabeçalho usado para autorização das requisições | *required | |
Content- |
Type (header) |
| 'application/json' é o formato do conteúdo | *required |
...
Request
Sem BodyNão possui body!
...
Operação realizada com sucesso (200)
beneficiaries |
Beneficiários da Família | |
| 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.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 |
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"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 |
| Código identificador do erro. (Tabela de Erro) |
message |
| Literal no idioma da requisição descrevendo o erro para o usuário. |
detailedMessage |
| Mensagem técnica e mais detalhada do erro. |
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"code": "E001",
"message": "Beneficiário não encontrado.",
"detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000026010"
} |
...