Módulo Propostas Comerciais

O que é o módulo Propostas Comerciais

O módulo Propostas Comerciais é independente e dedicado ao ciclo de negociação com o cliente antes da venda: elaboração do documento, envio, acompanhamento do status, revisões e, quando aprovada, conversão em venda.

Não confunda com o orçamento dentro do módulo Vendas — aquele é um tipo de pedido rápido, sem recursos comerciais. A Proposta Comercial tem validade, link público de visualização, modelos reutilizáveis, controle de status e PDF profissional pronto para imprimir ou enviar por e-mail.

Como acessar

No menu lateral, acesse Operações → Vendas → Propostas Comerciais. Rota: /propostas.

No menu lateral, entre em Propostas. As rotas principais são:

• /propostas — listagem.
• /propostas/cadastrar — nova proposta.
• /propostas/[id]/editar — edição.
• /propostas/visualizar/[id] — visualização interna.
• /proposta/compartilhada/[hash] — visualização pública (para o cliente).

Listagem

A listagem traz número, data, cliente, vendedor, total, status, validade, próximo contato e marcadores. Os filtros disponíveis são status, cliente, vendedor, intervalo de datas e busca por termo.

Status e cores

Indicadores visuais

• Anexos — ícone de clipe quando há arquivos vinculados.
• Expirada — ícone de relógio se a validade já passou.
• Compartilhada — marca quando existe um link público gerado.

Menu de contexto

No menu de três pontos de cada linha da listagem você encontra:

• Visualizar — abre a proposta em modo leitura.
• Editar — abre o formulário.
• Duplicar — cria uma cópia para reaproveitar como base de uma nova proposta.
• Criar modelo — salva como template reutilizável.
• Gerar venda — converte em pedido de venda (status muda para Convertida).
• Compartilhar — gera o link público e envia por e-mail ou WhatsApp.
• Imprimir e Salvar PDF.
• Alterar status — troca rápida do status.
• Editar marcadores.
• Ocorrências — histórico de alterações.
• Excluir — não aparece em propostas já convertidas ou em modelos.

Formulário

O formulário é organizado em abas para manter foco na parte comercial.

Dados gerais

Número da proposta (gerado automaticamente), data, cliente, vendedor, natureza da operação, lista de preços e depósito. O número do próximo documento é consultado via endpoint dedicado para evitar colisões.

Itens

Tabela editável com produtos e serviços. Cada linha tem quantidade, preço de lista, percentual de desconto, preço unitário e total.

Parcelas

Parcelamento gerado automaticamente a partir da condição de pagamento ou preenchido manualmente (número, dias e valor de cada parcela).

Endereço de entrega

Opcional, usado quando o destino é diferente do endereço do cliente.

Transportador e frete

Forma de envio, frete por conta, prazo e demais condições logísticas.

Condições comerciais

Três modos:

• Nenhuma — sem detalhamento adicional.
• Parcelas — exibe o parcelamento na apresentação.
• Texto livre — condições escritas à mão.

Textos e apresentação

Introdução, observações, assinatura (por padrão "Atenciosamente, Departamento de vendas", editável), marcadores para categorização e anexos.

Templates

A aba de templates identifica se a proposta é um modelo reutilizável e o nome que ela assume no cadastro de modelos.

Envio e link público

Link compartilhado

Ao clicar em Compartilhar, o sistema gera um hash permanente e disponibiliza a URL pública /proposta/compartilhada/[hash]. O cliente acessa sem precisar de login, vê o conteúdo completo e, quando a validade expira, o documento continua acessível mas aparece marcado como expirado.

Envio por e-mail

No mesmo painel, você envia o link para um ou mais destinatários, com cópia, assunto e mensagem personalizáveis. O sistema registra o envio e altera o status para Enviada.

WhatsApp e cópia de link

O painel também permite copiar o link para colar onde for preciso (WhatsApp, mensageiros, CRM).

Validade

Cada proposta tem um campo validade em dias. O cálculo é feito automaticamente: quando data da proposta + validade ultrapassa hoje, a proposta passa a ser exibida como expirada, sem que você precise mudar o status manualmente. Esse cálculo convive com o status salvo — ações como aprovar, rejeitar ou converter prevalecem sobre a expiração.

Conversão em venda

A ação Gerar venda cria um pedido de venda vinculado à proposta e marca o status como Convertida. A proposta guarda a referência ao pedido e a data de conversão, permitindo rastrear, em relatórios, de qual proposta cada venda nasceu. Endereço de entrega e demais dados são migrados para o pedido automaticamente.

Mesmo após convertida, a proposta fica preservada no histórico — ela não pode ser excluída e o vínculo com a venda permanece.

Modelos reutilizáveis

Quando você tem um tipo de proposta recorrente (por exemplo, "Pacote básico" ou "Contrato de manutenção"), pode transformar uma proposta em modelo. O menu Modelos lista todos os templates, e ao criar uma nova proposta você pode partir de um modelo pronto.

Impressão e PDF

A proposta tem um layout próprio de impressão com capa, introdução, itens, totais, condições comerciais, observações, assinatura e anexos. O PDF é gerado a partir do HTML renderizado, usando WeasyPrint (preferencial) ou xhtml2pdf como fallback, e retorna pronto para download ou envio.

Configurações do módulo

O endpoint de configurações completas retorna, de forma consolidada, os dados usados no formulário:

• Formas de envio.
• Formas de frete.
• Depósitos disponíveis.
• Naturezas fiscais.
• Listas de preços.
• Flags visuais (exibir preço de lista e percentual de desconto).

Essas informações vêm dos módulos originais (Logística, Estoque, Fiscal, Produtos) via serviços compartilhados — não existe duplicação de dados.

Integrações com outros módulos

Vendas

A conversão de uma proposta em venda cria um pedido no módulo Vendas com todos os itens, parcelas e endereços. A venda vira um documento independente e segue o ciclo normal (aprovação, estoque, financeiro, fiscal).

Clientes

A busca de clientes no formulário usa o cadastro principal do ERP.

Produtos

Itens, preços, pesos e listas de preços vêm do cadastro de produtos. O cálculo de frete por peso considera o peso total dos itens.

Representantes e vendedores

O vendedor responsável é selecionado entre os usuários com perfil de vendedor. Serve de base para relatórios e comissões quando a proposta vira venda.

Logística e Fiscal

Formas de envio, formas de frete e naturezas de operação são consumidas diretamente desses módulos. Alterações feitas lá aparecem no formulário de propostas em tempo real.

CRM

O campo Próximo contato alimenta lembretes e acompanhamento comercial, útil para equipes que usam o módulo de CRM.

Relatórios

Em Vendas > Relatórios há o relatório Propostas Comerciais, que lista as propostas do período com status, conversão em venda e vendedor. Útil para medir a taxa de aprovação, tempo médio até a conversão e desempenho por vendedor.

Permissões

• Listar propostas.
• Visualizar proposta.
• Criar proposta.
• Editar proposta.
• Excluir proposta.
• Alterar status.
• Criar modelo.
• Clonar proposta.
• Gerar link compartilhado.
• Enviar por e-mail.
• Visualizar próximo número.

Perguntas frequentes

Qual a diferença entre Proposta Comercial e Orçamento do módulo Vendas?

A Proposta Comercial tem recursos de negociação — validade, link público, modelos, status complexo, design próprio para PDF. O orçamento dentro do módulo Vendas é apenas um pedido com tipo orçamento, sem essas funcionalidades. Para propostas formais ao cliente, use o módulo Propostas.

A proposta expirada pode voltar a ser válida?

Sim. Basta editar e ajustar a data da proposta ou o prazo de validade. Como a expiração é calculada, o status volta a ser o que estava gravado (enviada, em revisão etc.).

Posso excluir uma proposta já convertida em venda?

Não. Propostas convertidas são preservadas para manter a rastreabilidade com o pedido gerado. Você pode cancelar o pedido no módulo Vendas, mas a proposta continua no histórico.

O link público expira?

O link em si não expira — ele continua funcionando. O que expira é a validade comercial. O cliente ainda consegue abrir, mas vê o selo de expirada.

Como reutilizar propostas parecidas?

Duas opções: Duplicar uma proposta existente para criar uma nova a partir dela, ou Criar modelo e, na próxima, iniciar a partir dele. Modelos ficam na lista própria e podem ser nomeados.

Como enviar a mesma proposta para vários contatos?

Use o painel de compartilhamento — ele aceita destinatários principais, em cópia, assunto e mensagem personalizados em um único envio.