Preço de venda com markup

Varejistas, atacadistas e equipes de produto definem o preço de lista com uma regra simples de custo mais markup: pegam o custo unitário e aplicam o percentual de markup escolhido. Validação com falha não é cobrada; itens de API bem-sucedidos usam o preço base publicado US$ 0,002.

Entradas: custo unitário, percentual de markup e decimais opcionais

Markup_percent é o acréscimo expresso como percentual desse custo: quarenta significa markup de quarenta por cento, de modo que o preço de venda é o custo unitário vezes um mais quarenta sobre cem. O custo unitário deve ser estritamente positivo; zero ou negativo é rejeitado porque um preço de lista custo-mais fica indefinido para bases de custo não positivas. Todas as verificações rodam antes de qualquer multiplicação, assim pedidos inválidos nunca geram uma linha de preço pela metade e nunca consomem saldo pré-pago após a rejeição do motor. Envie um corpo JSON com dois números obrigatórios e um controle de escala opcional. unit_cost é o valor de aquisição ou produção de uma unidade em uma única moeda que você já acompanha; os aliases cost, cost_price, cogs e wholesale são aceitos quando o cliente nomeia o campo de outra forma. Os aliases markup, markup_pct e mu mapeiam para markup_percent para clientes com jargão varejista. O percentual de markup deve ser não negativo; markup negativo (desconto planejado abaixo do custo) está fora do escopo e falha com invalid_input para que bots de precificação nunca publiquem um markdown silencioso como se fosse markup. Custos ou markups extremamente grandes são limitados para manter a aritmética do Worker isolate limitada. decimals opcional é um inteiro de zero a oito que controla como os campos monetários são arredondados na resposta; quando omitido, o padrão é dois para que o resultado se pareça com moeda comum em uma cotação.

Como preço de venda, lucro e margem são calculados

O lucro por unidade é o preço de venda menos o custo unitário, o mesmo valor em dinheiro do campo markup_amount devolvido para cartões de preço. Os campos monetários unit_cost, markup_amount, selling_price e profit são arredondados no estilo half-up para os decimais pedidos, de modo que goldens e demos de SDK fixem de forma limpa entre runtimes. Entradas idênticas sempre produzem o mesmo JSON porque o caminho é aritmética pura, sem rede, sem semente aleatória e sem relógio de parede.

Uso da API, fluxos de precificação e limites práticos

Use a calculadora gratuita de preço de venda a partir do markup no navegador para oficinas de preços de gôndola, negociações com fornecedores e exercícios de aula sem instalar uma planilha. Mantenha custos unitários em faixas comerciais comuns; valores extremos são rejeitados para manter a matemática do isolate limitada. A promessa do produto é precificação de lista de um único SKU com custo mais markup e proteções explícitas de custo positivo e markup não negativo—não cestas multiproduto, empilhamento promocional, pareamento dinâmico de concorrentes ou suítes completas de conversão markup versus margem, que pertencem a ferramentas especializadas com outra intenção SEO e outras consultas de busca primárias. Use a API pré-paga quando um importador de catálogo, conector ERP, motor de regras de ecommerce ou chatbot de preços precisar de um contrato KIT estável a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após a rejeição. Combine este endpoint com conversores de moeda apenas se você já souber os valores em uma moeda—esta capacidade não converte FX, não aplica imposto sobre vendas, não empilha frete nem converte entre markup e margem como objetivo principal do produto. Autores de SDK podem mapear unit_cost, markup_percent, selling_price e profit diretamente em tabelas de preços e geradores de cotação.