CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Configuração Layout Cartão
- Outras Ações / Ações relacionadas
- Outras Ações / Ações relacionadas
- Configuração dos Campos no Arquivo JSON
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- 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:
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.
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.
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:
| Campo | Descrição | Campo (Protheus) |
|---|---|---|
| name | Nome completo do beneficiário. | BTS_NOMCAR ou BTS_NOMUSR |
| socialName | Nome social do beneficiário. | BTS_NOMSOC |
| healthInsurerCode | Có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 |
| holderRegistrationCode | Có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 |
| dependentCompanyCode | Có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ção | Descrição |
|---|---|
| Salvar Imagens | Salve as imagens front-card.png e back-card.png no diretório. |
| Criar Arquivo layout-config.json | Defina o layout do cartão no arquivo layout-config.json. |
04. CONFIGURAÇÃO DOS CAMPOS NO ARQUIVO JSON
Principais Campos e Parâmetros
| Campo | Descrição |
|---|---|
| front | Contém a lista de configurações para a frente do cartão. |
| back | Contém a lista de configurações para o verso do cartão. |
| css | Define o estilo CSS para cada campo. |
| values | Define os valores a serem exibidos, podendo ser: field, text, ou custom. |
| type: field | Refere-se a um campo retornado pela API. |
| type: text | Exibe um texto fixo no layout. |
| type: custom | Permite adicionar campos customizados, definidos pelo ponto de entrada PTBENCARD. |
| value | Define 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


