Histórico da Página

CONTEÚDO

Visão Geral
Exemplo de utilização
1. Dados do Contrato
2. Beneficiários da Família
3. Tabela de Código de Erro
Tela Dados de Contrato
1. Outras Ações / Ações relacionadas
Tela Dados de Contrato
1. Principais Campos e Parâmetros
Tabelas utilizadas

01. VISÃO GERAL

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

/totvsHealthPlans/v1/beneficiaryPosition/{subscriberId}/contract
/totvsHealthPlans/v1/beneficiaryPosition/{subscriberId}/familyBeneficiaries

Esses endpoints são utilizados na nova tela de posição Gestão do beneficiárioBeneficiário, desenvolvida em PO UI. (Biblioteca de componentes baseado em Angular)

Clique aqui para detalhes sobre como habilitar o serviço de APIs

02. EXEMPLO DE UTILIZAÇÃO

Dados do Contrato

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

Endpoint

Url

Verbo

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

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.situationStringSituação atual do beneficiário, sendo: Ativo, Bloqueado ou Bloqueio Futurofields.cardStringCarteirinha do BeneficiáriostructArray

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

foldersArrayPastas do fields (Abas) de acordo com o dicionário de dados (SXA)

ba1_nomsoc ba3_codemp (Tipo do Contrato Pessoa Jurídica) ba3_desemp (Tipo do Contrato Pessoa Jurídica) ba3_conemp (Tipo do Contrato Pessoa Jurídica) ba3_vercon (Tipo do Contrato Pessoa Jurídica) ba3_subcon (Tipo do Contrato Pessoa Jurídica) ba3_versub (Tipo do Contrato Pessoa Jurídica) ba3_dessub (Tipo do Contrato Pessoa Jurídica)
fields.situation	Image Added	Situação atual do beneficiário, sendo: Ativo, Bloqueado ou Bloqueio Futuro Campo: BA1_DATBLO
fields.card	Image Added	Carteirinha do Beneficiário Campo: BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO
struct	Image Added	Estrutura dos fields de acordo com o dicionário de dados (SX3)
folders	Image Added	Pastas do fields (Abas) de acordo com o dicionário de dados (SXA)

Bloco de código

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

{
  "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": "",
    "ba1_nomsoc": "MARIA HERNANDES",
    "ba3_codemp": "1008",
    "ba3_desemp": "EMPRESA VINICIUS TEIXEIRA",
    "ba3_conemp": "000000000001",
    "ba3_vercon": "001",
    "ba3_subcon": "000000003",
    "ba3_versub": "001",
    "ba3_dessub": "SUBCONTRATO USO GERAL",
    "situation": "Ativo",
    "card": "00011008000027010"
  },
  "struct": [
    {
      "field": "BA3_CODEMP",
      "type": "C",
      "title": "Grupo/Empr.",
      "description": "Grupo/Empresa",
      "picture": "@!",
      "size": 4,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "04"
    },
    {
      "field": "BA3_DESEMP",
      "type": "C",
      "title": "Desc. Grupo",
      "description": "Empresa",
      "picture": "@!",
      "size": 25,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "05"
    },
    {
      "field": "BA3_CONEMP",
      "type": "C",
      "title": "Contr. Empr.",
      "description": "Contrato Empresa",
      "picture": "@!",
      "size": 12,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "06"
    },
    {
      "field": "BA3_VERCON",
      "type": "C",
      "title": "Versão Cont.",
      "description": "Versao Contrato",
      "picture": "@!",
      "size": 3,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "07"
    },
    {
      "field": "BA3_SUBCON",
      "type": "C",
      "title": "Sub-Contrato",
      "description": "Sub-Contrato",
      "picture": "@!",
      "size": 9,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "08"
    },
    {
      "field": "BA3_VERSUB",
      "type": "C",
      "title": "Versão SubCo",
      "description": "Versao Sub-Contrato",
      "picture": "@!",
      "size": 3,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "09"
    },
    {
      "field": "BA3_DESSUB",
      "type": "C",
      "title": "Desc. Sub.",
      "description": "Descricao Sub-Contrato",
      "picture": "@!",
      "size": 40,
      "decimals": 0,
      "cbox": [],
      "folder

Bloco de código

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

{
  "fields": {
    "ba1_cpfusr": "23576483098",
    "ba1_drgusr": "",
    "ba1_nomusr": "HERNANDES ALVES DA SILVA",
    "ba1_datnas": "2001-06-15",
    "ba1_sexo": "1",
      "ba1_estcivorder": "Solteiro(a)"10"
    },
    "ba1_mae": "TESTE",
{
      "ba1_enderefield": "BA1_CPFUSR",
      "ba1_comendtype": "C",
      "ba1_bairrotitle": "CPF",
      "ba1_municidescription": "CPF do Usuário",
      "ba1_estadopicture": "@R 999.999.999-99",
      "ba1_paisize": ""11,
      "ba1_datblodecimals": ""0,
      "ba1_motblocbox": ""[],
      "situationfolder": "Ativo1",
      "cardorder": "0001100800002701011"
  },
  "struct": [},
    {
      "field": "BA1_BAIRRODRGUSR",
      "type": "C",
      "title": "BairroRG",
      "description": "BairroRG do Usuario",
      "picture": "@!",
      "size": 2011,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "13"
    },
    {
      "field": "BA1_COMENDNOMUSR",
      "type": "C",
      "title": "ComplementoNome Usuário",
      "description": "ComplementoNome do EnderecoUsuario",
      "picture": "@!",
      "size": 2070,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "16"
    },
    {
      "field": "BA1_ENDEREDATNAS",
      "type": "CD",
      "title": "EndereçoDt. Nascto.",
      "description": "EnderecoData dode UsuarioNascimento",
      "picture": "@!@D",
      "size": 408,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "18"
    },
    {
      "field": "BA1_PAISEXO",
      "type": "C",
      "title": "Nome PaiSexo",
      "description": "Nome do PaiSexo",
      "picture": "@!",
      "size": 30,
1,
      "decimals": 0,
      "cbox": [
        {
          "decimalsvalue": 0"1",
      "cbox": [],
      "folderdescription": "1Masculino"
        },
        {
          "fieldvalue": "BA1_ESTADO2",
          "typedescription": "C"Feminino"
        },
      "title": "Estado",  {
          "descriptionvalue": "Estado do Usuariox",
          "picturedescription": "@!Anonimizado",
       "size": 2, }
      "decimals": 0],
      "cboxfolder": []"1",
      "folderorder": "120"
    },
    {
      "field": "BA1_MUNICIESTCIV",
      "type": "C",
      "title": "MunicípioEstado Civil",
      "description": "MunicipioEstado do UsuarioCivil",
      "picture": "@!",
      "size": 301,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "123"
    },
    {
      "field": "BA1_MAE",
      "type": "C",
      "title": "Mãe",
      "description": "Nome da Mae",
      "picture": "@!",
      "size": 120,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "30"
    },
    {
      "field": "BA1_NOMUSRENDERE",
      "type": "C",
      "title": "Nome UsuárioEndereço",
      "description": "NomeEndereco do Usuario",
      "picture": "@!",
      "size": 7040,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "41"
    },
    {
      "field": "BA1_DRGUSRCOMEND",
      "type": "C",
      "title": "RGComplemento",
      "description": "RGComplemento do UsuarioEndereco",
      "picture": "@!",
      "size": 1120,
      "decimals": 0,
      "cbox": []": [],
      "folder": "1",
      "folderorder": "143"
    },
    {
      "field": "BA1_CPFUSRBAIRRO",
      "type": "C",
      "title": "CPFBairro",
      "description": "CPFBairro do UsuárioUsuario",
      "picture": "@R 999.999.999-99@!",
      "size": 1120,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "44"
    },
    {
      "field": "BA1_ESTCIVMUNICI",
      "type": "C",
      "title": "Estado CivilMunicípio",
      "description": "EstadoMunicipio do CivilUsuario",
      "picture": "@!",
      "size": 130,
      "decimals": 0,
      "cbox": 0[],
      "cboxfolder": []"1",
      "folderorder": "146"
    },
    {
      "field": "BA1_SEXOESTADO",
      "type": "C",
      "title": "SexoEstado",
      "description": "SexoEstado do Usuario",
      "picture": "@!",
      "size": 12,
      "decimals": 0,
      "cbox": [],
        {
          "value"folder": "1",
          "descriptionorder": "Masculino47"
        },
        {
          "valuefield": "2BA1_PAI",
          "descriptiontype": "FemininoC",
      "title": "Nome }Pai",
      "description":  {
  "Nome do Pai",
        "valuepicture": "x@!",
      "size": 30,
      "descriptiondecimals": "Anonimizado"0,
      "cbox": [],
 }
      ]"folder": "1",
      "folderorder": "153"
    },
    {
      "field": "BA1_DATNASNOMSOC",
      "type": "DC",
      "title": "Dt.Nome Nascto.Social",
      "description": "DataNome de NascimentoSocial",
      "picture": "@D@!",
      "size": 850,
      "decimals": 0,
      "cbox": [],
      "folder": "1",
      "order": "BZ"
    },
    {
      "field": "BA1_MOTBLODATBLO",
      "type": "CD",
      "title": "MotivoData Bloq.",
      "description": "MotivoData do Bloqueio",
      "picture": "@!@D",
      "size": 38,
      "decimals": 0,
      "cbox": [],
      "folder": "6",
      "order": "68"
    },
    {
      "field": "BA1_DATBLOMOTBLO",
      "type": "DC",
      "title": "DataMotivo Bloq.",
      "description": "DataMotivo do Bloqueio",
      "picture": "@D@!",
      "size": 83,
      "decimals": 0,
      "cbox": [],
      "folder": "6",
      "order": "69"
    }
  ],
  "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"
    }
  ]
}

...

Mensagens de Erros

code

String

Image Added

Código identificador do erro. (Tabela de

Erro

Erros)

*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

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

{
  "code": "E001",
  "message": "Beneficiário não encontrado.",
  "detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000026010"
}

Beneficiários da Família

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.socialName

Image Added

Nome social do Beneficiário

Campo: BA1_NOMSOC

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

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

{
  "beneficiaries": [
    {
      "card": "00011008000027010",
      "name": "HERNANDES ALVES DA SILVA",
      "socialName": "MARIA HERNANDES",
      "kinship": "BENEFICIARIO TITULAR",
      "situation": "Ativo"
    },
    {
      "card": "00011008000027028",
      "name": "FABIANA SOPHIA MELO",
      "socialName": "",
      "kinship": "CONJUGE/ COMPANHEIRO",
      "situation": "Ativo"
    }
  ]
}

...

Mensagens de Erros

code

String

Image Added

Código identificador do erro. (Tabela de

Erro

Erros)

*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

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

{
  "code": "E001",
  "message": "Beneficiário não encontrado.",
  "detailedMessage": "Não foi encontrado nenhum beneficiário com a matricula 00011008000026010"
}

Tabela de Código de

...

Erros

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

Code	message	detailedMessage	Status Code
E001	Beneficiário não encontrado.	Não foi encontrado nenhum beneficiário com a matricula {subscriberId}	404

03. TELA DADOS DE CONTRATO

Outras Ações / Ações relacionadas

Ação	Descrição
Não se aplica.	Não se aplica.

04. TELA DADOS DE CONTRATO

Principais Campos e Parâmetros

Campo	Descrição
BA1_CODINT, BA1_CODEMP, BA1_MATRIC, BA1_TIPREG, BA1_DIGITO	Carteirinha do Beneficiário

05. TABELAS UTILIZADAS

BA1 - Beneficiários
BRP - Graus de Parentesco
BA3 - Famílias

Árvore de páginas

Versões comparadas

Versão antiga 9

Nova versão Atual

Chave

CONTEÚDO

01. VISÃO GERAL

02. EXEMPLO DE UTILIZAÇÃO

Dados do Contrato

Endpoint

Parâmetros

Request

Operação realizada com sucesso (200)

Mensagens de Erros

Beneficiários da Família

Endpoint

Parâmetros

Request

Operação realizada com sucesso (200)

Mensagens de Erros

Tabela de Código de

Erros

03. TELA DADOS DE CONTRATO

04. TELA DADOS DE CONTRATO

05. TABELAS UTILIZADAS