Este tutorial mostra o passo a passo para você personalizar um template de proposta ou documento no sistema da SolarMarket. O objetivo é permitir que sua empresa envie materiais com a identidade visual adequada e com campos dinâmicos (como nome do cliente, valor do projeto, etc.), facilitando a geração de documentos profissionais.
🎥 Veja a explicação no vídeo, ou em texto, mais abaixo do vídeo:
O que você precisa saber antes de configurar um modelo de documento no SolarMarket
📄 Na plataforma do SolarMarket, você pode cadastrar qualquer tipo de documento, como:
-
Propostas comerciais
-
Contratos
-
Ordens de serviço (OS)
-
Termos personalizados
Esses documentos podem ser automatizados com informações do projeto, cliente, produtos e outros dados.
🛠️ Para automatizar um documento, você precisa inserir “chaves” (também chamadas de “variáveis”) no lugar das informações que deseja que o sistema preencha automaticamente.
🔹 Por exemplo:
Se você quiser que o nome do cliente apareça automaticamente no documento, escreva no Word:[cliente_nome]
O sistema vai substituir isso por "João da Silva", por exemplo, no momento da geração.
🧩 O que são chaves e onde encontrá-las?
Chaves (ou "variáveis") são códigos usados para preencher automaticamente as informações em um documento dentro da plataforma SolarMarket Business.
Quando você gera uma proposta, contrato ou outro documento, as chaves são substituídas por dados reais do cliente, projeto ou proposta. Isso evita retrabalho e garante que todas as informações estejam corretas e atualizadas.
A plataforma oferece chaves nativas, que você pode consultar diretamente no sistema
🔑 Chaves nativas da plataforma
👉 Caminho: Configurações → Proposta Comercial → Variáveis Disponíveis → Tabela de variáveis
📌 Importante: Copie exatamente o código da coluna Chave e cole no seu modelo de documento para que ele funcione corretamente na automação.
🔗Se precisar, veja o tutorial Quais são e como utilizar as chaves nativas da plataforma?
🔑 Chaves de variáveis customizadas
São criadas por você quando precisa automatizar uma informação que não tem chave nativa.
👉 Caminho: Configurações → Proposta Comercial → Variáveis Disponíveis → Variáveis Customizadas (role um pouco a tela)
-
Exemplo:
[vc_gasto_atual_anual]
(“vc” significa variável customizada)
🔗 Veja também: Como criar uma variável customizada para o seu template de proposta doc?
🔑 Chaves de campos customizados
Usadas para retornar no documento informações de campos personalizados que você criou no sistema.
👉 Caminho: Configurações → Opções customizáveis → Campos customizados
-
Exemplo:
[cap_conta_contrato]
(“cap” significa campo personalizado)
🔗 Veja também: Como criar e configurar campos customizados?
🔑 Chaves de custos customizados
São geradas ao criar novos custos personalizados no orçamento automatizado.
👉 Caminho: Configurações → Precificação → Custos
-
Importante: essas chaves não funcionam diretamente no documento. Para usá-las, crie uma variável customizada e cole a chave no campo "Expressão".
-
Exemplo:
[cc_homologacao]
(“cc” significa custo customizado)
🔗 Veja também: Como criar e editar custos?
🔑 Chaves de variáveis de apoio
Usadas para criar fórmulas dentro dos custos customizados.
👉 Caminho: Configurações → Precificação → Custos → Variáveis de apoio
-
Assim como os custos customizados, essas chaves não podem ser aplicadas diretamente nos documentos. Caso queira usá-las, crie uma variável customizada com a expressão desejada.
-
Exemplo:
[va_porcentagem_comissao_vendedor]
(“va” significa variável de apoio)
🔗 Veja também: Como criar variáveis de apoio e para o que utilizá-las?
🔑 Chaves de formulários criados
Essas chaves aparecem quando você cria formulários personalizados para documentos.
👉 Caminho: Configurações → Documentos → Modelos de documentos
⚠️ Importante:
-
Elas não podem ser usadas em modelos de proposta comercial.
-
Só funcionam para documentos criados na aba Documentos das Configurações.
-
Exemplo:
[doc_conta_contrato]
(“doc” significa que vem de formulário de documento)
🔗 Veja também: O que são formulários e como configurá-los?
⚠️ Formato do arquivo
Todo modelo de documento deve estar no formato .DOCX (Word).
-
Crie o documento diretamente no Microsoft Word ou outro editor compatível com arquivos
.docx
. -
Se o seu arquivo estiver em outro formato, como PDF, você pode convertê-lo facilmente:
-
Pesquise no Google: “converter pdf em word”
-
Escolha o site da sua preferência e faça a conversão gratuita.
-
Como começar a configuração do documento/template
-
Abra o documento no Word (.docx)
-
Substitua as informações que você quer automatizar por chaves, como:
-
[cliente_nome]
-
[preco]
-
[potencia_sistema]
-
-
Salve o documento com as chaves incluídas
-
Siga o processo de cadastro na plataforma (via Configurações → Propostas → Modelos de Propostas, se por um template de proposta comercial, ou via Configurações → Documentos → Modelos de documentos, se for qualquer outro documento, como contrato, por exemplo.)
Veja nas figuras abaixo um exemplo de inserção das chaves.
Deseja-se que as informações de potência, geração e área sejam automatizadas no documento
Após copiar as chaves da plataforma que retornam essas informações, cole-os no local correto, como ilustrado abaixo.
🔗 Artigos relacionados
Como funcionam as chaves de financiamento?
Como funcionam as chaves de componentes do kit?
Como funcionam as chaves para múltiplas unidades consumidoras?
Como configurar um template de proposta ou documento?
Como criar uma variável customizada para o seu template de proposta?