Voltar para documentação
Manual

Guia de Variáveis para Modelos de Documentos

Este documento descreve o funcionamento do sistema de variáveis Merge Tags utilizado nos modelos de documentos do Giter. O sistema permite a inserção dinâmica de dados (como nome do residente, CPF, datas, etc.)...

Guia de Merge Tags para Modelos de Documentos

Este documento descreve o funcionamento do sistema de Merge Tags utilizado nos modelos de documentos do Giter. O sistema permite a inserção dinâmica de dados (como nome do residente, CPF, datas, etc.) em campos de texto rico (RichEditor).

1. Como Utilizar na Interface (Filament)

Ao editar um modelo de documento no painel administrativo:

  1. No campo Editor de documento, clique no botão "Merge Tags" na barra de ferramentas ou digite {{ para abrir o menu de autocompletar.
  2. Selecione a tag desejada da lista.
  3. O editor inserirá a tag no formato {{ Rótulo da Tag }} (ex: {{ Residente: Nome }}).
  4. Ao gerar o PDF, o sistema substituirá automaticamente essas tags pelos dados reais.

2. Tags Disponíveis

As tags estão organizadas por categorias:

Organização (Tenant)

  • {{ Organização: Nome }}
  • {{ Organização: CNPJ }}
  • {{ Organização: Endereço }}
  • {{ Organização: Número }}
  • {{ Organização: Bairro }}
  • {{ Organização: CEP }}
  • {{ Organização: Cidade }}
  • {{ Organização: Estado }}
  • {{ Organização: Representante }}

Unidade (Unit)

  • {{ Unidade: Nome }}
  • {{ Unidade: CNPJ }}
  • {{ Unidade: Endereço }}
  • {{ Unidade: Número }}
  • {{ Unidade: Bairro }}
  • {{ Unidade: CEP }}
  • {{ Unidade: Cidade }}
  • {{ Unidade: Estado }}
  • {{ Unidade: Representante }}
  • {{ Unidade: Responsável Técnico }}

Funcionário (User)

  • {{ Funcionário: Nome }} (user_name)
  • {{ Funcionário: E-mail }} (user_email)
  • {{ Funcionário: Telefone }} (user_phone)
  • {{ Funcionário: Data Nasc. }} (user_birthday)
  • {{ Funcionário: CNPJ }} (user_cnpj)
  • {{ Funcionário: Endereço }} (user_address)
  • {{ Funcionário: Número }} (user_number)
  • {{ Funcionário: Bairro }} (user_neighborhood)
  • {{ Funcionário: CEP }} (user_cep)
  • {{ Funcionário: Cidade }} (user_city)
  • {{ Funcionário: Estado }} (user_state)
  • {{ Funcionário: CPF }} (user_cpf)
  • {{ Funcionário: Reg. Conselho }} (user_council_registry)

Contrato de Trabalho (UserContract)

  • {{ Contrato: Unidade }} (user_contract_unit): Nome da unidade do contrato.
  • {{ Contrato: Cargo }} (user_contract_occupation): Cargo/ocupação formal do colaborador.
  • {{ Contrato: Tipo de Colaborador }} (user_contract_user_type): Regime (CLT, PJ, Estágio, Cooperado, etc.).
  • {{ Contrato: Salário }} (user_contract_wage): Remuneração formatada em reais (ex: R$ 3.500,00).
  • {{ Contrato: Salário Extenso }} (user_contract_wage_full): Remuneração descrita por extenso (ex: três mil e quinhentos reais).
  • {{ Contrato: Valor Hora }} (user_contract_hourly_rate): Valor da hora de trabalho formatada em reais.
  • {{ Contrato: Valor Hora Extenso }} (user_contract_hourly_rate_full): Valor da hora de trabalho por extenso.
  • {{ Contrato: Turno }} (user_contract_work_shift): Nome amigável do turno (ex: Diurno 12x36).
  • {{ Contrato: Horário do Turno }} (user_contract_shift_schedule): Horário de início e fim da jornada (ex: 07:00 às 19:00).
  • {{ Contrato: Data Início }} (user_contract_start_date): Data de início do contrato (dd/mm/aaaa).
  • {{ Contrato: Data Fim }} (user_contract_end_date): Data de distrato/término ou "Em vigor".
  • {{ Contrato: Status }} (user_contract_status): Situação do contrato (Ativo, Encerrado ou Suspenso).
  • {{ Contrato: Horas Semanais }} (user_contract_weekly_hours): Carga horária semanal pactuada (ex: 44).
  • {{ Contrato: Observações }} (user_contract_notes): Texto livre de anotações ou aditivos.

Residente (Resident)

  • {{ Residente: Nome }}
  • {{ Residente: Endereço }}
  • {{ Residente: Número }}
  • {{ Residente: Bairro }}
  • {{ Residente: CEP }}
  • {{ Residente: Cidade }}
  • {{ Residente: Estado }}
  • {{ Residente: Nacionalidade }}
  • {{ Residente: Estado Civil }}
  • {{ Residente: CPF }}
  • {{ Residente: Data Nasc. }}
  • {{ Residente: Responsável }}
  • {{ Residente: Idade }}
  • {{ Residente: Data Entrada }}
  • {{ Residente: Hora Entrada }}
  • {{ Residente: Data Saída }}
  • {{ Residente: Hora Saída }}

Geral e Filtros

  • {{ Data Inicial (Filtro) }}: Data inicial selecionada no modal de geração.
  • {{ Data Final (Filtro) }}: Data final selecionada no modal de geração.
  • {{ Data Atual (d/m/Y) }}: Data de hoje no formato dd/mm/aaaa.
  • {{ Data Atual Extenso }}: Data de hoje por extenso (ex: 12 de abril de 2026).

3. Retrocompatibilidade

O sistema continua suportando as tags antigas no formato ##NOME_DA_TAG## (ex: ##RESIDENTE_NOME##). No entanto, novas implementações devem preferir o formato de Merge Tags {{ ... }}, pois estas são nativamente integradas ao editor do Filament e evitam erros de digitação.

Ver todos os manuais