Modelos de configuração - o cálculo da estrutura, do custo e do preço do produto configurável
Como montar o modelo que o card de engenharia usa para calcular um produto configurável - entradas do formulário, variáveis derivadas, tabelas de consulta coladas do Excel, regras de itens e quantidades, cadeia de custo e preço, versões com vigência, teste do cálculo e importação por JSON.
Quando usar
Quando a empresa orça produto sob medida com uma planilha de cálculo (peças, peso, custo e preço) e quer que esse cálculo rode dentro do Hap, no card de engenharia, sem copiar e colar.
Antes de começar
- Gerenciar o CRM (é quem cria, altera, publica e importa modelos)
- Produtos do ERP cadastrados com o código que as regras de itens vão usar
- Um funil do tipo Engenharia para usar o modelo nos cards (veja Funil de Engenharia)
Para que serve
O modelo de configuração é o cálculo do produto configurável, montado por tela, sem programar. Ele faz o que a planilha de orçamento fazia: recebe as medidas que a engenharia digita, consulta tabelas (catálogo de peças, preço dos insumos, parâmetros por modelo), monta a lista de peças com quantidade e peso, soma o custo e chega ao preço de venda.
O mesmo motor serve a qualquer produto: estrutura metálica, mola, móvel sob medida. Cada produto é um modelo. O card de engenharia escolhe o modelo e calcula (veja o artigo Funil de Engenharia).
Onde fica e quem mexe
Configurações > PLM > Modelos de configuração. Qualquer usuário vê e usa o modelo no card; criar, alterar, publicar e importar é de quem gerencia o CRM.
Na lista, cada cartão mostra o nome, o selo da versão em vigor (ou rascunho, se nunca foi publicado; inativo, se foi desligado), a chave, quantas tabelas ele tem e quantos cards o usam.
| Botão | O que faz |
|---|---|
| Novo modelo | Cria um modelo em branco e abre o editor |
| Importar JSON | Traz um modelo pronto (definição e tabelas) de um arquivo. Se já existe modelo com a mesma chave, atualiza esse |
| Publicar ao importar | Ligado, a importação já publica uma versão; desligado, entra só como rascunho |
| Atualizar | Recarrega a lista |
O cabeçalho do modelo
Clique no cartão para abrir o editor.
| Campo | O que faz |
|---|---|
| Nome do modelo | O nome que aparece no card de engenharia |
| Ativo | Desligado, o modelo some da escolha no card (quem já usa continua com o cálculo salvo) |
| Chave (importação) | Identificador estável. A importação por JSON atualiza o modelo com a mesma chave |
| Produto do item pelo | Como o código das regras acha o produto do ERP: Código do produto, Referência, Código de barras ou Id interno |
| Descrição | Para que serve o modelo |
O selo ao lado do nome diz a versão publicada (ou nunca publicado) e não salvo quando há alteração pendente. Salvar rascunho grava o que está na tela; o card só enxerga depois de publicar.
Como o cálculo anda
O motor calcula sempre na mesma ordem, e cada passo enxerga os anteriores:
- 1
Entradas - o que a engenharia preenche no card.
- 2
Derivadas - contas intermediárias e constantes.
- 3
Tabelas - consultadas pelas regras e expressões.
- 4
Itens e quantidades - a lista de peças.
- 5
Custo e preço - a cadeia de custo, o preço por item e as saídas em destaque.
Aba Entradas
Cada entrada vira um campo do formulário do card. Nova entrada acrescenta; as setas mudam a ordem; a lixeira exclui.
| Campo | O que preencher |
|---|---|
| Chave | O nome curto usado nas expressões (ex.: largura). Sem espaço e sem acento |
| Rótulo | O texto que a engenharia vê no card |
| Tipo | Número, Texto, Lista, Sim/Não ou Tabela (linhas) |
| Grupo | O bloco em que o campo aparece no card |
| Unidade | Aparece junto do rótulo (mm, m, kg) |
| Padrão | O valor que o campo traz preenchido |
| Obrigatória | Sem ela o card não calcula |
| Ajuda | Texto que aparece embaixo do campo |
Uma Lista pode ter Opções fixas (uma por linha) ou vir de uma tabela: escolha a tabela em Opções da tabela, a Coluna que dá as opções e, se quiser, um Filtro (ex.: só as linhas ativas). Uma entrada do tipo Tabela (linhas) vira uma grade no card (uma linha por módulo, por exemplo), com colunas digitadas ou calculadas.
Aba Derivadas
Variáveis calculadas em ordem: cada uma enxerga as entradas e as derivadas de cima. Servem para as contas intermediárias (área, número de módulos, faixa de medida) e para as constantes do modelo (fator de preço, taxa, salário da mão de obra). Ligue Oculta no card para o que a engenharia não precisa ver.
Aba Tabelas
As tabelas de consulta do modelo: catálogo de peças, preço dos insumos, parâmetros por modelo, taxas. Elas vêm do Excel:
- 1
Clique em Nova tabela (colar do Excel).
- 2
Dê o Nome da tabela e as Colunas-chave (separadas por vírgula; são as colunas mais buscadas, guardadas com índice).
- 3
No Excel, copie as células com a primeira linha como cabeçalho e cole no campo.
- 4
Clique em Gravar tabela.
Na tabela aberta, Substituir colando do Excel troca o conteúdo inteiro, Importar JSON traz as linhas de um arquivo e Excluir apaga a tabela do rascunho (as versões publicadas guardam a cópia delas).
Aba Itens e quantidades
As regras que montam a lista de peças. Há dois tipos:
- Para cada linha da tabela - um item para cada linha da tabela escolhida que passa no Filtro da linha (ex.: as peças do modelo escolhido, na faixa de medida certa).
- Item fixo - um item só, sempre ou quando a Condição for verdadeira.
| Campo | O que faz |
|---|---|
| Condição (vazia = sempre) | A regra só roda quando a expressão é verdadeira |
| Filtro da linha | Quais linhas da tabela viram item (linha.coluna lê a linha) |
| Produto (código) | O código do produto do ERP, conforme Produto do item pelo |
| Descrição | O texto da linha na Estrutura |
| Quantidade do projeto | Quantas peças o projeto pede |
| Adicional | Peças a mais por regra técnica |
| Sobressalente | Reserva, calculada sobre a quantidade do projeto |
| Peso unitário (kg) e Comprimento (mm) | Para o peso total e para o lote de compra |
| Custo unitário | O custo de uma peça; pode usar os atributos do item |
| Agrupar mesmo produto | Linhas com o mesmo produto e a mesma descrição viram uma só |
| Manter quantidade zero | Mostra a peça mesmo quando a conta dá zero |
Em Atributos do item (em ordem) ficam valores extras de cada peça (grupo, tipo de material, custo do aço), que as expressões de custo leem como item.nome-do-atributo.
Aba Custo e preço
A Cadeia de custo e preço é uma lista de linhas calculadas em ordem; cada linha enxerga as anteriores, as derivadas e os itens. Bloco agrupa as linhas na aba Custo e preço do card (Peso, Matéria-prima, Fabricação, Preço, Resultado), Destaque põe a linha em negrito e Oculta esconde.
Preço de venda por item (opcional) calcula o preço unitário de cada peça, que vai para a proposta linha a linha. Sem ele, o valor de venda é rateado entre as peças pelo custo.
As Saídas são os números em destaque no topo do card. O Papel liga a saída ao resumo: Valor de venda, Custo total, Peso total e Margem.
Escrevendo as expressões
As expressões usam a mesma lógica de uma fórmula de planilha, em português:
- O ponto e vírgula separa os argumentos; a vírgula é só decimal.
- Comparação com = e <>, além de <, >, <= e >=; e, ou, nao para juntar condições; & junta textos.
- Funções: se, min, max, arred, arredcima, arredbaixo, abs, int, resto, soma, cont, media, primeiro, tabela, existe, concat, escolher, seerro, vazio, texto e numero.
- tabela(nome; coluna; coluna1; valor1) traz a primeira linha da tabela em que coluna1 = valor1.
- soma(itens; item.peso; item.grupo = "perfil") soma só as peças que passam na condição. O mesmo vale para cont, media e primeiro, sobre os itens ou sobre as linhas de uma tabela.
Exemplos: se(angulo <= 9; "baixo"; "alto") e arredcima(comprimento / 6000).
Versões e vigência
O card só usa modelo publicado. A versão publicada é um retrato que não muda mais: a definição e uma cópia das tabelas. Assim, um orçamento feito hoje continua com os mesmos números mesmo depois que alguém mudar o preço do aço no modelo.
- 1
Salve o rascunho.
- 2
Em Vigente a partir de, escolha a data e, em Observação, diga o que mudou (ex.: preço do aço de novembro).
- 3
Clique em Publicar versão.
A versão anterior passa a valer até a véspera da nova. Na lista Versões publicadas você vê a vigência, a data, quantos cards usam cada versão e baixa o JSON de qualquer uma. Exportar rascunho (JSON) baixa o que está em edição.
Testar antes de publicar
A aba Testar roda o motor sem gravar nada.
- Em Definição, escolha o Rascunho (o que está salvo), a Versão em vigor ou uma versão antiga.
- Preencha as entradas e clique em Calcular, ou informe o número de um negócio em Usar as entradas do negócio nº e clique em Calcular com as entradas do negócio.
- Confira os itens, os avisos e a cadeia de custo. Limpar zera o teste.
Importar um modelo pronto
Modelos montados fora da tela (por exemplo, convertidos de uma planilha pela equipe de implantação) entram por Importar JSON, na lista. O arquivo traz a definição e as tabelas. Com Publicar ao importar ligado, a importação já publica uma versão; a mensagem diz quantas tabelas e linhas entraram.
Problemas comuns
- "O modelo não aparece no card de engenharia: ele ainda não foi publicado. Abra Versões e vigência e clique em Publicar versão. O card só usa modelo com versão em vigor."
- "Publicar versão recusa com erro: o modelo tem expressão com erro (o aviso diz a posição). Corrija a expressão, clique em Salvar rascunho e publique de novo."
- "Mudei o rascunho e o card continua com o resultado antigo: o card usa a versão publicada. Publique a versão nova e, no card, clique em Usar a versão N."
- "Um item sai sem produto no card: o código que a regra de itens monta não existe no ERP, ou a linha da tabela não tem código. Confira o campo Produto do item pelo e o código na tabela."
- "A tabela colada ficou com colunas trocadas: a primeira linha colada precisa ser o cabeçalho, com o nome de cada coluna. Colar substitui a tabela inteira."
- "Expressão com vírgula não funciona: no modelo, o ponto e vírgula separa os argumentos e a vírgula é só decimal. Ex.: arred(peso * 1,05; 2)."