Docs

Guias do produto, rotinas operacionais e integrações da Plataforma

Guia prático3 min de leitura

Layouts de proposta

Crie e edite o HTML da proposta comercial com placeholders.

O documento que o cliente recebe é a proposta (código ORC-…). Em CRM → Configurações → Layouts de proposta você define o visual em HTML reutilizável pela equipe.

Começar por um modelo

Há modelos Pulse (Simples, Comercial com grade, Executivo, Catálogo visual, Serviços, Minimalista). Use Ver prévia com dados de exemplo e Usar este modelo para copiar para a organização. Também dá para criar um layout em branco.

A edição abre em aba própria: HTML à esquerda, lista de campos abaixo e prévia à direita. Clique em um campo da lista para inserir no cursor.

Como funcionam os placeholders

No HTML você escreve tokens entre chaves duplas. Na geração da proposta (prévia, e-mail, PDF, assinatura) o Pulse substitui pelos dados reais.

Campos simples

{{cliente.nome}}
{{proposta.codigo}}
{{proposta.total}}
{{emitente.nome}}

O idioma da conta define o que a lista de campos insere. Em português o preferido é proposta.*; layouts antigos com orcamento.* continuam válidos (mesmo significado). Em inglês: customer.name, quote.code, etc.

Listas (itens e parcelas)

Para repetir uma linha por item ou por parcela do plano de pagamento:

{{#each itens}}
  <tr>
    <td>{{descricao}}</td>
    <td>{{quantidade}}</td>
    <td>{{unitario}}</td>
    <td>{{total}}</td>
  </tr>
{{/each}}

{{#each parcelas}}
  <div>{{sequencia}}. {{valor}} · vencimento {{vencimento}} {{referencia}}</div>
{{/each}}

Dentro do {{#each …}} use só os campos do item (sem prefixo itens. / parcelas.).

Condicionais

{{#if proposta.observacoes}}
  <p>{{proposta.observacoes}}</p>
{{/if}}

{{#if emitente.logo_url}}
  <img src="{{emitente.logo_url}}" alt="" />
{{/if}}

Grupos de campos

Grupo Exemplos (pt-BR)
Organização (sessão) org.nome, org.documento
Emitente (Imprimir como) emitente.nome, emitente.logo_url, emitente.documento
Cliente cliente.nome, cliente.endereco, cliente.email
Proposta proposta.codigo, proposta.titulo, proposta.validade, proposta.total
Itens {{#each itens}} + descricao, quantidade, unitario, total, imagem_url
Plano de pagamento {{#each parcelas}} + sequencia, vencimento, valor, referencia

Plano de pagamento na proposta

As parcelas vêm do plano de pagamento da própria proposta. Se a proposta nasceu de uma oportunidade e ainda não tem plano próprio, o Pulse usa o plano da oportunidade.

Na prévia do editor (sem proposta selecionada) aparecem dados de exemplo — por isso a seção de pagamento pode parecer preenchida no modelo e vazia na proposta real até existir plano.

Snapshot e “Imprimir como”

Ao gerar uma proposta, o HTML do layout é copiado para o documento. Alterar o layout depois não muda propostas já emitidas. O cabeçalho do emitente vem do Imprimir como (emitente.*); a organização da sessão permanece em org.*.

Relacionado