Uma variável é um campo dinâmico no formato {{chave}} que você escreve dentro de um bloco. Quando o documento é gerado (ex.: um contrato a partir de um negócio ganho no CRM), o Blodoc troca o {{chave}} pelo valor real — nome, CNPJ, CEP, etc.
Para contratos e propostas gerados pelo CRM, as variáveis já existem por convenção — você não precisa criar fonte de dados. Basta inserir a chave certa no bloco.
{{cliente_cep}} (CEP do cliente/prospect) ou {{tn_cep}} (CEP da sua empresa).cliente_cep — o efeito é o mesmo.Use estas chaves diretamente — elas são preenchidas automaticamente na geração. tn_ = a sua empresa (a tenant) · cliente_ = o prospect/lead do negócio.
{{sm_*}} (ex.: {{sm_cnpj}}) continua funcionando — documentos já criados não quebram. Em documentos novos, prefira {{tn_*}}. Ambos trazem os dados da própria tenant.| Chave | O que preenche |
|---|---|
{{tn_razao_social}} | Razão social da sua empresa |
{{tn_cnpj}} | CNPJ da sua empresa (formatado) |
{{tn_endereco}} · {{tn_cidade}} · {{tn_uf}} · {{tn_cep}} | Endereço, cidade, UF e CEP da sua empresa |
{{cliente_razao_social}} | Razão social do prospect/lead |
{{cliente_cnpj}} · {{cnpj}} | CNPJ do cliente (formatado / cru) |
{{cliente_endereco}} · {{cliente_cidade}} · {{cliente_uf}} · {{cliente_cep}} | Endereço, cidade, UF e CEP do cliente |
{{cliente_representante}} | Nome do representante/contato |
{{contrato_numero}} · {{proposta_numero}} · {{numero}} | Números do contrato / proposta / negócio |
{{data_contrato}} · {{cidade_foro}} | Data por extenso e foro (cidade/UF) |
{{dia_vencimento}} · {{indice_reajuste}} · {{sla_disponibilidade}} | Padrões comerciais (editáveis no gerador) |
A tela de Fontes de dados serve para catalogar variáveis que vêm de outros módulos da plataforma ou de sistemas externos — para usar em documentos que não são o contrato/proposta padrão do CRM. Três origens:
Variáveis de uma entidade que já existe no seu banco. Você escolhe o Módulo (Contracts, ESG, Qualidade, MOLGEST, Admin, Blodoc, ECM, Forms) e a Entidade; os campos aparecem automaticamente. O Filtro padrão é a chave usada para localizar o registro (ex.: cnpj, id, codigo).
Obs.: o módulo CRM não aparece aqui porque as variáveis de contrato/proposta do CRM já são a convenção tn_/cliente_ acima — para o seu caso do CEP, use aquela seção.
Puxa dados de um sistema externo (SAP, Salesforce, Omie, ERP próprio…) por um conector do HUB. Você escolhe a Integração e o Endpoint, descreve o uso e lista os Campos esperados na resposta — um por linha, no formato chave: Rótulo. Ex.:
nome: Nome do clientecnpj: CNPJcidade: Cidade
O Filtro padrão é o campo de busca (ex.: cnpj).
Para catalogar um módulo/entidade livre (ex.: EXTERNO, LEGADO) quando a origem não se encaixa nas duas anteriores.
{{chave}}. Lembre: o valor real depende de o documento ser gerado num contexto que conheça essa fonte.
tn_/cliente_ — ex.: {{cliente_cep}}. Não precisa de fonte de dados.