Árvore de páginas


CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Configuração Layout Cartão
    1. Outras Ações / Ações relacionadas
  4. Configuração dos Campos no Arquivo JSON
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas


01. VISÃO GERAL

Esta documentação detalha o processo de configuração do layout customizado da carteirinha no portal do beneficiário, abrangendo tanto a frente quanto o verso. Para adicionar novos campos, utilize o ponto de entrada PTBENCARD.

Passos para a Configuração:

  1. Salvar as Imagens do Cartão: Salve as imagens da frente e verso do cartão no formato PNG, tamanho 420 x 240, com a nomenclatura front-card.png e back-card.png, no diretório do servidor:

    • RootPath: \portais-saude\portal-beneficiario\card\
    • A imagem deve conter apenas os dados "fixos", como o logotipo, enquanto os campos de valores serão preenchidos dinamicamente.

  2. Criar o Arquivo de Configuração: No mesmo diretório, crie o arquivo de configuração layout-config.json, contendo as definições para os campos que aparecerão no cartão.

02. EXEMPLO DE UTILIZAÇÃO

O exemplo abaixo mostra como montar o layout customizado da carteirinha com base no arquivo layout-config.json.

layout-config.json
{
	"front": [
		{
			"css": "font-size: 9px;font-weight: bold;top: 50px; width: 200px; left: 300px;",
			"values": [
				{
					"type": "custom",
					"value": "meuCampo"
				}
			]
		},
		{
			"css": "font-size: 9px;font-weight: bold;top: 70px; width: 200px; left: 20px;",
			"values": [
				{
					"type": "field",
					"value": "planDescription"
				},
				{
					"type": "field",
					"value": "accommodationDescription"
				}
			]
		},
		{
			"css": "font-size: 9px;font-weight: bold;top: 85px; width: 200px; left: 20px;",
			"values": [
				{
					"type": "field",
					"value": "coverageArea"
				}
			]
		},
		{
			"css": "font-size: 8px;top: 117px; width: 70px; left: 330px;",
			"values": [
				{
					"type": "text",
					"value": "VÁLIDO ATÉ:"
				}
			]
		},
		{
			"css": "font-size: 10px;font-weight: bold;top: 135px; width: 400px; left: 20px; color: white",
			"values": [
				{
					"type": "field",
					"value": "subcontractCardName"
				}
			]
		}
	],
	"back": [
		{
			"css": "font-size: 9px;font-weight: bold;top: 70px; width: 200px; left: 100px;",
			"values": [
				{
					"type": "field",
					"value": "planDescription"
				},
				{
					"type": "field",
					"value": "accommodationDescription"
				}
			]
		}
	]
}

layout-config.json

Após aplicar a configuração, a carteirinha no portal será renderizada com os campos dinâmicos e fixos conforme definidos no arquivo layout-config.json. A imagem do cartão será gerada com base nas imagens da frente e verso, aplicando o estilo CSS e exibindo os valores de acordo com as informações retornadas pela API.

Segue a lista de campos padrão disponíveis para a configuração do arquivo de layout:

CampoDescriçãoCampo (Protheus)
name Nome completo do beneficiário.BTS_NOMCAR ou BTS_NOMUSR
socialNameNome social do beneficiário.

BTS_NOMSOC

healthInsurerCodeCódigo da operadora de saúde.

BA1_CODINT

companyCode Código da empresa.

BA1_CODEMP

registrationCode Código de registro do beneficiário.

BA1_MATRIC

kinshipCode Código de parentesco.

BA1_TIPREG

digit Dígito de identificação.

BA1_DIGITO

nationalHealthCard Número do cartão nacional de saúde

BTS_NRCRNA

subscriberId Identificador único do beneficiário.BA1_CODINT + BA1_CODEMP + BA1_MATRIC + BA1_TIPREG + BA1_DIGITO
birthDate Data de nascimento do beneficiário.

BA1_DATNAS

cardValidity Data de validade do cartão.

BA1_DTVLCR

effectiveDate Data de efetivação do plano de saúde.

BA1_DATINC

cardCopy Identificador da cópia do cartão.

BA1_VIACAR

holderName Nome do titular do plano.BTS_NOMCAR ou BTS_NOMUSR
holderHealthInsurerCode Código da operadora de saúde do titular.

BA1_CODINT

holderCompanyCode Código da empresa do titular.

BA1_CODEMP

holderRegistrationCodeCódigo de registro do titular.

BA1_MATRIC

holderKinshipCode Código de parentesco do titular.

BA1_TIPREG

holderDigit Dígito de identificação do titular.

BA1_DIGITO

holderSubscriberId Identificador único do titular.BA1_CODINT + BA1_CODEMP + BA1_MATRIC + BA1_TIPREG + BA1_DIGITO
dependentName Nome do dependente.BTS_NOMCAR ou BTS_NOMUSR
dependentHealthInsurerCode Código da operadora de saúde do dependente.

BA1_CODINT

dependentCompanyCodeCódigo da empresa do dependente.

BA1_CODEMP

dependentRegistrationCode Código de registro do dependente.

BA1_MATRIC

dependentKinshipCode Código de parentesco do dependente.

BA1_TIPREG

dependentDigit Dígito de identificação do dependente.

BA1_DIGITO

dependentSubscriberId Identificador único do dependente.BA1_CODINT + BA1_CODEMP + BA1_MATRIC + BA1_TIPREG + BA1_DIGITO
planCode Código do plano.

BI3_CODIGO

planDescription Descrição do plano de saúde.

BI3_NREDUZ

accommodationDescription Descrição da acomodação do plano.

BI4_CODEDI

coverageArea Área de cobertura do plano de saúde.

BI3_ABRANG

planRegulation Tipo de regulamentação do plano.

BI3_APOSRG

planCodeANS Código do plano na ANS.

BI3_SUSEP ou BI3_SCPA

planSegmentation Segmentação do plano.

BI6_DESCRI

subcontractCardName Nome do cartão de subcontrato.

BQC_NOMCAR

healthInsurerCodeANS Código da operadora de saúde na ANS.

BA0_SUSEP

healthInsurerName Nome da operadora de saúde.

BA0_NOMINT

Exemplo de Imagem do Cartão no Portal

Aqui está um exemplo visual de como a carteirinha pode aparecer no portal do beneficiário, com base na configuração fornecida. Este é apenas um modelo ilustrativo, pois o layout final pode variar dependendo dos dados específicos retornados pela API.

03. CONFIGURAÇÃO LAYOUT CARTÃO

Outras Ações / Ações relacionadas

AçãoDescrição
Salvar ImagensSalve as imagens front-card.png e back-card.png no diretório.
Criar Arquivo layout-config.jsonDefina o layout do cartão no arquivo layout-config.json.

04. CONFIGURAÇÃO DOS CAMPOS NO ARQUIVO JSON

Principais Campos e Parâmetros

CampoDescrição
frontContém a lista de configurações para a frente do cartão.
backContém a lista de configurações para o verso do cartão.
cssDefine o estilo CSS para cada campo.
valuesDefine os valores a serem exibidos, podendo ser: field, text, ou custom.
type: fieldRefere-se a um campo retornado pela API.
type: textExibe um texto fixo no layout.
type: customPermite adicionar campos customizados, definidos pelo ponto de entrada PTBENCARD.
valueDefine o valor a ser exibido no campo, conforme o tipo (campo da API ou texto fixo).

05. TABELAS UTILIZADAS

  • BA0 - Operadoras de Saúde
  • BA1 - Beneficiários
  • BA3 - Famílias de Usuários
  • BDE - Exportação de Identificação
  • BED - Cobranças e Emissão de Carteirinhas
  • BI3 - Produtos de Saúde
  • BI4 - Tipos de Acomodação para Internação
  • BI6 - Segmentação de Saúde
  • BPX - Motivos para Emissão de Carteira
  • BQC - Subcontratos
  • BTS - Cadastro de Vidas