Cadastro de Orçamento
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Orçamentos > "Novo Orçamento" ou ícone Editar na lista Última atualização: 20/04/2026
Para que serve
Cria e edita orçamentos de venda. Permite montar uma proposta comercial com itens, dados de transporte e condições comerciais. Orçamentos aprovados podem ser convertidos em pedidos de venda com um clique.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
- Para criar, clique em "Novo Orçamento" na Lista de Orçamentos.
- Preencha os dados na aba "Dados Gerais": filial, cliente, datas e condições comerciais.
- Vá para a aba "Itens" e adicione produtos clicando em "Adicionar Item".
- Configure transporte na aba "Transporte" se necessário.
- Adicione observações na aba "Observações".
- Clique em "Cadastrar Orçamento". O sistema redireciona para a tela de edição com o ID gerado.
- Na edição, clique em "Salvar Alterações". A tela permanece aberta.
- Quando o orçamento estiver com situação "Aprovado", o botão "Converter em Pedido" aparece no cabeçalho.
Abas e seções
Cabeçalho fixo (sticky)
Sempre visível durante a edição. Exibe número do orçamento, situação, nome do cliente, total e botões de ação.
| Elemento | Descrição |
|---|---|
| N. | Número sequencial do orçamento |
| Tag situação | Cor conforme situação atual |
| Nome do cliente | Exibido quando cliente está selecionado |
| Total | Valor total calculado em BRL |
| Converter em Pedido | Aparece somente quando situação = Aprovado |
| Cancelar / Salvar | Ações principais |
Aba: Dados Gerais
Seção: Identificação
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Filial | Sim | Filial emissora | Seletor com filiais cadastradas |
| Situação | Não | Rascunho, Enviado, Aprovado, Reprovado, Expirado ou Convertido | Default: Rascunho |
| Data Emissão | Sim | Data no formato DD/MM/AAAA | Default: hoje |
| Data Validade | Não | Data no formato DD/MM/AAAA | Data limite para aceite do orçamento |
| UF Destinatário | Não | Sigla do estado | Usada no cálculo de ICMS |
| Consumidor Final | Não | Liga/desliga | Default: desligado |
| Contribuinte ICMS | Não | Liga/desliga | Default: desligado |
Seção: Cliente
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Não Identificado | Não | Liga/desliga | Default: desligado. Quando ligado, exibe campos de nome e CPF/CNPJ avulsos |
| Cliente | Não | Selecionar cliente cadastrado | Seletor com busca |
| Nome (avulso) | Não | Nome do cliente não cadastrado | Aparece somente quando "Não Identificado" está ligado |
| CPF/CNPJ (avulso) | Não | Documento do cliente avulso | Aparece somente quando "Não Identificado" está ligado |
Seção: Condições Comerciais
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Canal de Venda | Não | Canal de venda ativo | Seletor |
| Região de Venda | Não | Região de venda ativa | Seletor |
| Tabela de Preço | Não | Tabela de preço | Usada para sugerir preços nos itens |
| Vendedor | Não | Funcionário | Seletor |
| Condição de Pagamento | Não | Condição de pagamento ativa | Seletor |
| % Comissão | Não | Percentual (0–100) com passo 0,01 | Sobreescreve a comissão do canal/vendedor |
Aba: Itens
Tabela editável dos itens do orçamento. Cada linha é um item. Exibe contagem e subtotal acima da tabela.
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Produto | Sim | Produto do cadastro | Seletor com busca por código ou nome |
| Descrição | Não | Texto livre | Preenchido automaticamente ao selecionar o produto; editável |
| Qtd | Sim | Quantidade (mínimo 0,001) | Decimal com vírgula |
| Vlr Unit | Sim | Preço unitário | Decimal com vírgula |
| % Desc | Não | Percentual de desconto (0–100) | Decimal com vírgula |
| Vlr Total | — | Calculado automaticamente | Qtd × Vlr Unit × (1 - % Desc / 100) |
| CFOP | Não | Código fiscal da operação | 4 dígitos |
| NCM | Não | Código NCM | 8 dígitos |
| Ações | — | Lixeira | Remove o item; mínimo 1 item |
Aba: Financeiro
Exibe os totais calculados (somente leitura na edição; estimados no novo).
| Campo | Descrição |
|---|---|
| Subtotal | Soma dos itens sem desconto |
| Descontos | Total de descontos nos itens |
| ICMS | Valor de ICMS |
| IPI | Valor de IPI |
| PIS | Valor de PIS |
| COFINS | Valor de COFINS |
| Total NF | Total líquido da nota |
Aba: Transporte
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Modalidade Frete | Não | CIF, FOB, Terceiros, Próprio Remetente, Próprio Destinatário ou Sem Frete | |
| Transportadora | Não | Transportadora cadastrada | Seletor |
| Placa Veículo | Não | Placa do veículo | |
| UF Veículo | Não | UF da placa | Seletor |
| Valor Frete | Não | Valor em R$ | Decimal com vírgula |
| Peso Bruto (kg) | Não | Peso em kg | |
| Peso Líquido (kg) | Não | Peso em kg | |
| Volumes | Não | Quantidade de volumes | Inteiro |
| Espécie | Não | Tipo de embalagem | Ex.: "Caixas" |
Aba: Observações
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Observações | Não | Texto livre | Observações gerais do orçamento |
| Observações Fiscais | Não | Texto livre | Aparece no campo de dados adicionais da NF-e |
Validações e regras
- Ao tentar salvar sem itens, o sistema exibe erro e abre a aba "Itens" automaticamente.
- O botão "Converter em Pedido" só aparece quando a situação é "Aprovado".
- A conversão é irreversível: cria um pedido de venda e muda a situação do orçamento para "Convertido".
- Ao salvar em criação, navega para
/comercial/orcamentos/:id/editar(replace: true). - Ao salvar em edição, o registro é recarregado da API sem fechar a tela.
- A navegação de volta pede confirmação se houver alterações não salvas.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Selecione a filial" | Filial não selecionada | Escolha a filial emissora |
| "Informe a data" | Data Emissão vazia | Preencha a data de emissão |
| "Adicione ao menos um item ao orcamento" | Nenhum item com produto selecionado | Adicione ao menos um produto na aba Itens |
| "Erro ao carregar orcamento" | ID inválido ou erro na API | Volte para a lista e tente novamente |
| "Erro ao salvar orcamento" | Erro de validação ou conflito no backend | ⚠️ CONFIRMAR mensagem exata do backend |
| "Orcamento convertido em pedido de venda com sucesso" | Conversão bem-sucedida | O sistema navega para o pedido gerado |
| "Erro ao converter orcamento em pedido" | Pedido não pode ser gerado | ⚠️ CONFIRMAR mensagem exata do backend |
Integrações e dependências
- Serviço:
orcamentosService(orcamentos.service) - Carrega filiais, clientes, canais de venda, regiões de venda, tabelas de preço, funcionários, condições de pagamento, transportadoras e produtos ao abrir a tela
- Orçamentos aprovados geram Pedidos de Venda
Dúvidas frequentes
Posso editar um orçamento convertido? Não. Orçamentos convertidos são somente leitura.
O total da aba Financeiro é calculado em tempo real? Na criação, o subtotal é calculado localmente pelos itens. Na edição, os totais fiscais (ICMS, IPI, PIS, COFINS) vêm do servidor após salvar.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |