ForHosting KIT · Finanças e dinheiro

Calculadora de preço e quantidade

Um preço unitário de 12,5 vezes 4 unidades dá um total de linha de 50, e 2,5 metros de tecido a 10 o metro dão 25. Use para conferir uma fatura, um orçamento ou um pedido antes de enviar. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Preço: 12,5
Quantidade: 4

Você obtém

Total: 50

Linhas de venda, faturas e pedidos de compra quase sempre se reduzem a uma só identidade: o preço unitário de um item vezes quantas unidades você compra. Doze e cinquenta cada um vezes quatro unidades dá cinquenta; nove e noventa e nove vezes três dá vinte e nove e noventa e sete. Esta calculadora de preço e quantidade aceita esses dois números finitos não negativos, multiplica-os e devolve o valor total para que um atendente, uma planilha ou um script de automação confira uma linha sem montar um motor de faturamento. Zero é permitido e gera um total de zero.

Como o preço unitário vezes a quantidade vira o total da linha

Uma loja que vende um caderno a doze e cinquenta e um cliente que leva quatro cadernos deve cinquenta, não um arredondamento improvisado. Infinity e NaN são rejeitados por não serem finitos. O produto é arredondado para duas casas decimais para que o dinheiro coincida byte a byte entre ambientes de execução.

Combine o resultado com a sua própria camada de impostos e descontos se precisar de um grande total; este ponto só multiplica os dois números que você envia. Esse é todo o trabalho de uma calculadora de preço e quantidade: uma linha, dois números, um total.

Contrato de entrada, forma da resposta e comportamento diante de erros

Se price for negativo, o tratador rejeita a solicitação porque um preço unitário não pode ser negativo; uma amostra grátis de zero é permitida e gera um total de zero. Se quantity for negativo, o tratador rejeita com uma mensagem clara de que quantity não pode ser negativo: essas falhas não são faturadas. Quantity zero é válido e devolve total de zero.

Exemplo: doze e cinco de preço unitário vezes quatro de quantity gera total de cinquenta. Mantenha as solicitações pequenas, fixe o total arredondado nos testes e você terá um valor de linha reproduzível para planilhas, complementos POS e workers de borda sem montar um motor de faturamento próprio.

Onde uma calculadora de preço e quantidade vale o investimento

Atendentes e a equipe de depósito usam uma calculadora de preço e quantidade para conferir um ticket de picking manuscrito com o preço unitário publicado antes de emitir a fatura. Equipes de catálogo informam um preço de lista e uma contagem de pack, depois fixam total para que um teaser da loja e um PDF de orçamento nunca discordem.

Equipes de produto ligam o mesmo contrato a prévias do carrinho e questionários de onboarding que precisam mostrar o total de uma linha para uma cesta de amostra sem chamar um ERP. É uma busca e um trabalho diferentes de uma comparação de preços unitários, de uma calculadora de taxa unitária e do custo de um lote de receita: essas ferramentas dividem o preço pelo tamanho da embalagem entre produtos, dividem um total por uma contagem para obter uma taxa, ou somam muitos ingredientes.

Preço vezes quantidade precifica um SKU contra uma contagem e devolve dinheiro. A validação falha não consome saldo. Impostos, frete e descontos promocionais ficam fora desta identidade de propósito: incorpore-os na sua própria camada depois de ter o preço estendido bruto.

Casos de uso

Confira uma linha de orçamento antes de enviar o PDF

Informe o preço unitário do catálogo e a quantidade do pedido, depois fixe total para que a linha do orçamento coincida com o carrinho antes de alguém assinar.

Confira um ticket de picking do depósito com o preço de lista

Informe o preço unitário publicado e a contagem do ticket de picking, depois confirme que total coincide com a linha da fatura antes de expedir.

Perguntas frequentes

A quantity pode ser uma fração, ou precisa ser um número inteiro?

quantity pode ser qualquer número finito não negativo, inclusive frações como 2.5 metros ou 1.25 litros. Não precisa ser um inteiro. Um valor não finito é rejeitado.

Isso inclui impostos, descontos ou conversão de moeda?

Não. Esta calculadora só multiplica o preço unitário pela quantidade. Aplique impostos, cupons, frete e conversão de moeda na sua própria camada depois de ter o preço estendido.

O preço ou a quantidade podem ser zero?

Sim. Uma amostra de brinde com preço zero, ou uma linha com zero unidades, dá total zero em vez de erro. Só são recusados os valores negativos e os números que não são finitos.

Como lanço uma devolução com preço negativo?

Em um documento separado. A calculadora não aceita preços nem quantidades negativas, porque um estorno precisa de um sinal próprio e explícito, e enfiar um negativo dentro de um total é como as planilhas dão errado.

Como o total é arredondado?

O produto é arredondado para duas casas decimais, com as metades para cima. Assim o total da linha tem formato de valor em dinheiro e sai idêntico toda vez que você calcula.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/fin/price-quantity

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/fin/price-quantity \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"price":12.5,"quantity":4}'

const res = await fetch("https://api.kit.forhosting.com/fin/price-quantity", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "price": 12.5,
    "quantity": 4
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/price-quantity",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "price": 12.5,
    "quantity": 4
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/price-quantity", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"price":12.5,"quantity":4}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"price":12.5,"quantity":4}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/price-quantity", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "price": 12.5,
  "quantity": 4
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.price_quantity",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

Um preço ou uma quantidade negativos, ou um valor que não seja um número finito, falham com invalid_input e não são faturados.

Como o preço unitário vezes a quantidade vira o total da linha

O preço estendido de uma linha é o produto de um preço unitário e uma quantidade: total é igual a price vezes quantity. A mesma identidade cobre quantidades fracionárias: dois metros e meio de tecido a dez o metro dão vinte e cinco, e um litro e um quarto de solvente a oito o litro dão dez. quantity é um número finito não negativo, não necessariamente inteiro, porque muitos SKU se vendem por peso, comprimento ou tempo. price é um número finito não negativo em uma só moeda; esta calculadora não converte moedas, não aplica imposto nem aplica desconto. Zero é uma entrada legítima: uma amostra de cortesia com price zero, ou uma linha com quantity zero, ambas geram um total de zero em vez de um erro. Um price negativo ou um quantity negativo não é uma nota de crédito neste contrato: é invalid_input, porque um crédito pertence ao próprio documento com uma convenção de sinal explícita, e multiplicar em silêncio um menos no total do carrinho é como as planilhas se estragam.

Contrato de entrada, forma da resposta e comportamento diante de erros

Envie por POST um corpo JSON com dois números finitos obrigatórios. price é o preço unitário em uma só moeda; os alias unit_price, unit_cost e cost apontam para o mesmo campo para que uma exportação de catálogo conserve os nomes das colunas. quantity é quantas unidades você está comprando; aceitam-se os alias qty, count, units e q. Cada campo numérico pode chegar como número JSON ou como cadeia numérica. Campos ausentes, cadeias vazias e valores não finitos como NaN ou Infinity falham com invalid_input nomeando o campo. Em caso de sucesso, o corpo ecoa price e quantity, depois informa total como o produto arredondado a duas casas decimais, e uma cadeia formula que reafirma a identidade total igual a price vezes quantity. Combine o JSON com a sua própria regra de impostos, cupons ou faturas de várias linhas, porque este ponto multiplica os dois números que você envia; não consulta um SKU, não converte moedas nem reparte uma cesta.

Onde uma calculadora de preço e quantidade vale o investimento

Como a implementação é parse de nível A puro, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Mantenha price e quantity não negativos e finitos, fixe o total arredondado nos testes e você terá um valor de linha reproduzível para teasers, tickets de picking e workers de borda sem montar um livro-razão de faturamento próprio.

Casos de integração

Alimente um teaser de carrinho ou um plugin POS com as mesmas cifras

Envie price e quantity a partir de um registro SKU e mostre total no teaser; o widget gratuito e o caminho API arredondam do mesmo jeito.

Perguntas técnicas

Como o total é calculado a partir do preço unitário e da quantidade?

Envie números finitos não negativos price (preço unitário) e quantity (contagem, peso, comprimento ou tempo). A API devolve total = price × quantity, arredondado a duas casas decimais, mais as entradas ecoadas e uma cadeia formula.

O que acontece se price ou quantity forem negativos?

A tarefa falha com invalid_input. Um preço unitário negativo ou uma quantidade negativa não são permitidos neste contrato e não são faturados. Zero é válido e gera um total de zero.

Quanto custa a calculadora de preço e quantidade?

A ferramenta do navegador é grátis. As solicitações API usam saldo pré-pago a US$ 0,002 por chamada bem-sucedida; a entrada inválida não é faturada.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Como o preço unitário vezes a quantidade vira o total da linha

Contrato de entrada, forma da resposta e comportamento diante de erros

Onde uma calculadora de preço e quantidade vale o investimento

Casos de uso

Confira uma linha de orçamento antes de enviar o PDF

Confira um ticket de picking do depósito com o preço de lista

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Erros

Notas técnicas

Como o preço unitário vezes a quantidade vira o total da linha

Contrato de entrada, forma da resposta e comportamento diante de erros

Onde uma calculadora de preço e quantidade vale o investimento

Casos de integração

Alimente um teaser de carrinho ou um plugin POS com as mesmas cifras

Perguntas técnicas

obrigado