ForHosting KIT · Ferramentas para dev

Custo total da receita

A calculadora de custo total da receita soma quanto cada ingrediente acrescenta ao prato.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Informe a quantidade realmente usada e o preço de uma unidade correspondente; a ferramenta multiplica esses valores e soma a receita inteira. Isso ajuda quando o preço da embalagem não mostra o custo da porção consumida. O cálculo é determinístico, transparente e adequado a orçamentos domésticos, estimativas de buffet, fichas de padaria, planejamento de cardápios ou custeio automatizado pela API.

Prepare quantidades e preços com unidades compatíveis

Para cada ingrediente, informe a quantidade usada na receita e o preço de uma unidade. Os dois valores precisam representar a mesma unidade. Se a receita usa 0.5 quilograma de farinha, utilize o preço por quilograma; se usa quatro ovos, utilize o preço por ovo. Converta o preço da embalagem antes de preencher quando necessário. Por exemplo, um pacote de 2 quilogramas que custa 6 corresponde a 3 por quilograma. Os nomes dos ingredientes são opcionais, mas facilitam a conferência e o arquivamento das linhas. Quantidades e preços podem ser zero, algo útil para água, doações ou itens do estoque aos quais você decidiu não atribuir custo. Valores negativos e dados que não sejam números finitos são recusados. Mantenha a mesma moeda em todas as linhas: a calculadora faz a aritmética, mas não converte moedas nem deduz unidades pelos nomes.

Entenda como o total da receita é calculado

O custo de cada linha é a quantidade multiplicada pelo preço unitário, e o total da receita é a soma de todas as linhas. Considere uma massa com 1.5 quilograma de farinha a 1.20 por quilograma, quatro ovos a 0.35 cada e 0.25 quilograma de manteiga a 6.40 por quilograma. As linhas custam 1.80, 1.40 e 1.60; portanto, a receita completa custa 4.80 na moeda escolhida. A resposta apresenta quantidade normalizada, preço unitário e custo calculado para cada ingrediente, seguidos do total e de uma fórmula simples. Esse detalhamento ajuda a encontrar um ingrediente caro ou conferir o resultado de forma independente. O arredondamento consistente mantém o JSON estável entre ambientes e preserva precisão suficiente para o custeio comum. Não existem rede, base de preços, aleatoriedade ou dependência de horário: entradas válidas idênticas sempre geram saídas idênticas.

Use o resultado em orçamentos e decisões de produção

O total representa os ingredientes consumidos pela receita inteira, não o valor pago no caixa nem um preço de venda recomendado. Uma embalagem pode custar mais do que a porção utilizada porque parte dela fica para outro lote. O resultado também não inclui automaticamente mão de obra, energia, embalagem, entrega, perdas, impostos, despesas indiretas ou lucro. Acrescente esses itens ao seu processo de precificação quando forem relevantes. Em produções recorrentes, guarde os preços unitários normalizados, atualize-os quando o fornecedor alterar valores e execute a mesma receita novamente. Você também pode comparar fórmulas mudando uma quantidade ou um preço e mantendo as demais linhas. A calculadora no navegador atende estimativas rápidas; a API custa US$ 0,002 por solicitação e oferece custeio reproduzível em estoques, pedidos e cardápios. Registre sempre a moeda e as unidades junto ao resultado.

Casos de uso

Calcular um lote de padaria

Multiplique farinha, manteiga, açúcar e outros ingredientes usados pelos preços unitários antes de definir o orçamento do lote.

Comparar variações da receita

Altere uma quantidade ou o preço unitário do fornecedor e compare o novo total com a formulação original.

Automatizar custos de cardápio

Envie linhas estruturadas pela API e armazene um total determinístico no fluxo de cozinha ou buffet.

Perguntas frequentes

Quanto custa um cálculo?

O preço da API é US$ 0,002 por solicitação. A calculadora também pode ser usada gratuitamente no navegador.

Como o custo de cada ingrediente é calculado?

A quantidade é multiplicada pelo preço unitário, e todas as linhas são somadas para produzir o total da receita.

As unidades da quantidade e do preço devem coincidir?

Sim. Uma quantidade em quilogramas exige preço por quilograma; itens contados individualmente exigem preço por item.

Posso informar valores negativos ou texto?

Não. Quantidades e preços precisam ser números finitos iguais ou maiores que zero; outros valores retornam erro de entrada.

O total inclui mão de obra, despesas ou lucro?

Não. Ele soma apenas os ingredientes informados. Acrescente separadamente mão de obra, embalagem, perdas, impostos, despesas e margem.

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/cook/recipe-cost

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/cook/recipe-cost \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ingredients":[{"name":"Flour","quantity":1.5,"unit_price":1.2},{"name":"Eggs","quantity":4,"unit_price":0.35},{"name":"Butter","quantity":0.25,"unit_price":6.4}]}'

const res = await fetch("https://api.kit.forhosting.com/cook/recipe-cost", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "ingredients": [
      {
        "name": "Flour",
        "quantity": 1.5,
        "unit_price": 1.2
      },
      {
        "name": "Eggs",
        "quantity": 4,
        "unit_price": 0.35
      },
      {
        "name": "Butter",
        "quantity": 0.25,
        "unit_price": 6.4
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/cook/recipe-cost",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "ingredients": [
        {
            "name": "Flour",
            "quantity": 1.5,
            "unit_price": 1.2
        },
        {
            "name": "Eggs",
            "quantity": 4,
            "unit_price": 0.35
        },
        {
            "name": "Butter",
            "quantity": 0.25,
            "unit_price": 6.4
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/cook/recipe-cost", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"ingredients":[{"name":"Flour","quantity":1.5,"unit_price":1.2},{"name":"Eggs","quantity":4,"unit_price":0.35},{"name":"Butter","quantity":0.25,"unit_price":6.4}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"ingredients":[{"name":"Flour","quantity":1.5,"unit_price":1.2},{"name":"Eggs","quantity":4,"unit_price":0.35},{"name":"Butter","quantity":0.25,"unit_price":6.4}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/cook/recipe-cost", 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

{
  "ingredients": [
    {
      "name": "Flour",
      "quantity": 1.5,
      "unit_price": 1.2
    },
    {
      "name": "Eggs",
      "quantity": 4,
      "unit_price": 0.35
    },
    {
      "name": "Butter",
      "quantity": 0.25,
      "unit_price": 6.4
    }
  ]
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "cook.recipe_cost",
  "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.

Limites

`min_ingredients`	1
`max_ingredients`	200
`max_value`	1000000000000

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.

Ver a documentação completa do KIT →