Planos de venda — composição de produtos¶
Captura do Telvora ERP em ambiente autorizado. Valores de tabelas e formulários foram ocultados para privacidade.
Módulo: Catálogo
Menu: Catálogo → Planos
Público: Comercial / Operador
Status: Publicado
Atualizado: 2026-09-08
Refs técnicas:01-ARQUITETURA/22-catalogo-produto-plano-fiscal.md·24-produto-scm-cadastro.md·UpsertSalesPlan
O que faz¶
Monta o plano comercial com um ou mais produtos de qualquer tipo (SCM, SVA, serviço, equipamento, taxa, etc.). A composição aparece em grade (produto, tipo, quantidade, valor unitário, subtotal). O Preço base é a soma dos subtotais e não é editável.
Quem pode usar¶
Permissões de catálogo / planos (catalog.sales_plan.* conforme perfil).
Pré-requisitos¶
- Produtos ativos cadastrados.
- Para velocidade no contrato, inclua ao menos um item SCM (ou INTERNET legado) com download/upload.
Passo a passo¶
- Abra Catálogo → Planos → Novo (ou edite um plano).
- Na grade Composição, digite ID/SKU/nome para buscar o produto (autocomplete) ou use a lupa para a consulta filtrável.
- Informe quantidade e valor unitário — o subtotal e o Preço base atualizam sozinhos.
- Use + Item para mais linhas.
- Salve.
Regras importantes¶
- Não há restrição a produtos SCM na composição.
- O Preço base = soma de (quantidade × valor unitário) de todos os produtos; o campo fica bloqueado.
- O flag Controla estoque do produto é definido no cadastro do produto e não muda depois de salvo.
Erros / avisos comuns¶
| Situação | O que fazer |
|---|---|
| Lista de produtos vazia | Cadastre produtos ativos |
| Falta velocidade no contrato | Inclua um produto SCM no plano |
| Valor unitário obrigatório | Preencha o valor em todas as linhas da composição |