Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Retorna os dados de contrato do beneficiário (Tabela BA1).

Endpoint

Url

Verbo

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

Image Added

Parâmetros

SubscriberId (path)
String

Image Added

Número da carteirinha do beneficiário*required
Authorization (header)
String

Image Added

Cabeçalho usado para autorização das requisições*required

Content-

Type 

Type (header)

String

Image Added

'application/json' é o formato do conteúdo*required


...

Request

Sem BodyNão possui body!

...

Operação realizada com sucesso (200)

fields

Object

Image Added

Dados do beneficiário de acordo com a tabela BA1
fields.{campo do SX3}
String

Image Added

Os campos retornados da tabela BA1:

  • ba1_cpfusr
  • ba1_drgusr
  • ba1_nomusr
  • ba1_datnas
  • ba1_sexo
  • ba1_estciv
  • ba1_mae
  • ba1_endere
  • ba1_comend
  • ba1_bairro
  • ba1_munici
  • ba1_estado
  • ba1_pai
  • ba1_datblo
  • ba1_motblo

fields.situation
String

Image Added

Situação atual do beneficiário, sendo: Ativo, Bloqueado ou Bloqueio Futuro

Campo: BA1_DATBLO


fields.card
String

Image Added

Carteirinha do Beneficiário

Campo: BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO


struct
Array

Image Added

Estrutura dos fields de acordo com o dicionário de dados (SX3)


folders
Array

Image Added

Pastas do fields (Abas) de acordo com o dicionário de dados (SXA)
Bloco de código
languagec#
themeMidnight
titleExemplo de retorno - Sucesso
linenumberstrue
collapsetrue
{
  "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

String

Image Added

Código identificador do erro. (Tabela de Erro)
*required

message

message

Image Added

String
Literal no idioma da requisição descrevendo o erro para o usuário.
*required

detailedMessage

String

Image Added

Mensagem técnica e mais detalhada do erro.
*required
Bloco de código
languagec#
themeMidnight
titleExemplo de retorno - Falha
linenumberstrue
collapsetrue
{
  "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
GET

Image Added

Parâmetros

SubscriberId (path)
String

Image Added

Número da carteirinha do beneficiário*required
Authorization (header)
String

Image Added

Cabeçalho usado para autorização das requisições*required

Content-

Type 

Type (header)

String

Image Added

'application/json' é o formato do conteúdo*required


...

Request

Sem BodyNão possui body!

...

Operação realizada com sucesso (200)

beneficiaries

Array

Image Added

Beneficiários da Família

beneficiaries.card
String

Image Added

Carteirinha do Beneficiário

Campo: BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO

beneficiaries.name
String

Image Added

Nome do Beneficiário

Campo: BA1_NOMUSR

beneficiaries.kinship
String

Image Added

Grau de Parentesco do Beneficiário

Campo: BRP_DESCRI (Relacionamento pelo BA1_GRAUPA) 

beneficiaries.situation
String

Image Added

Situação atual do Beneficiário, sendo: Ativo, Bloqueado ou Bloqueio Futuro

Campo: BA1_DATBLO

Bloco de código
languagec#
themeMidnight
titleExemplo de retorno - Sucesso
linenumberstrue
collapsetrue
{
  "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

String

Image Added

Código identificador do erro. (Tabela de Erro)
*required

message

String

Image Added

Literal no idioma da requisição descrevendo o erro para o usuário.
*required

detailedMessage

String

Image Added

Mensagem técnica e mais detalhada do erro.
*required
Bloco de código
languagec#
themeMidnight
titleExemplo de retorno - Falha
linenumberstrue
collapsetrue
{
  "code": "E001",
  "message": "Beneficiário não encontrado.",
  "detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000026010"
}

...