Custo total do lote da receita

Validação falha —em especial porções zero ou negativas— devolve invalid_input e não é cobrada.

Como o custo do lote é montado a partir de quantidade e custo unitário

O total de um lote de receita não é um valor solto digitado de memória; é a soma de cada linha de ingrediente do preparo completo. Rótulos name opcionais não afetam o cálculo; só tornam legível a lista de linhas ao exibir resultados ao lado da lista de compras ou de um cardápio. Listas vazias e mais de duzentas linhas são rejeitadas para que importações descontroladas não esgotem o orçamento do worker. A string formula de cada sucesso reafirma o contrato em três passos: custo de linha igual a quantidade vezes custo unitário, custo total igual à soma das linhas, e custo por porção igual ao total sobre as porções. Em cada linha você informa uma quantidade finita não negativa na unidade em que compra ou mede —quilogramas de farinha, litros de leite, unidades de ovos, garrafas de óleo— e um unit_cost finito não negativo, o preço de uma dessas unidades em uma única moeda. A capacidade multiplica quantity por unit_cost para obter o line_cost da linha e soma todos os line_cost para obter total_cost do lote inteiro. O custo por porção é total_cost dividido por servings, de modo que a mesma lista de compras vira custo de bandeja de catering e custo por prato sem digitar preços de novo.

Contrato de entrada, regra de porções e formato da resposta

Exemplo: farinha duas unidades a um ponto vinte e cinco, ovos seis a zero ponto trinta e cinco, leite um a um ponto um, manteiga zero ponto vinte e cinco a oito, para quatro porções, gera custos de linha dois ponto cinco, dois ponto um, um ponto um e dois, total de lote sete ponto sete e custo por porção um ponto nove dois cinco. Campos ausentes, valores não finitos e quantidades ou custos unitários fora do limite absoluto falham sem cobrar a conta. Envie um corpo JSON com dois campos obrigatórios. ingredients é um array não vazio de objetos; cada objeto deve incluir quantity e unit_cost como números finitos não negativos e pode incluir um name opcional. servings é um número finito estritamente maior que zero: zero e valores negativos falham com invalid_input porque um lote sem pratos não define custo por porção. Aliases aceitos incluem items, list e lines para o array, e portions, people, yield e serves para a contagem de porções, para que planilhas e construtores de formulário mantenham seus nomes de coluna. Em sucesso a resposta devolve ingredient_count e um array ingredients normalizado com index, name, quantity, unit_cost e line_cost por linha; servings arredondado para JSON estável; total_cost; cost_per_serving; uma string formula; um message curto para banners de interface; e um array steps que percorre cada multiplicação e a divisão final. Mantenha uma única moeda em todos os unit_cost; a calculadora não converte moedas nem sistemas de unidades: só multiplica e divide os números que você envia.

Onde uma API de custo total do lote da receita agrega valor

Marcas de meal-prep e cozinhas escolares acompanham o custo do lote e o custo por porção ao escalar uma receita base de quatro para quarenta pratos, trocando só quantidades e reutilizando a mesma tabela de unit_cost. Apps de orçamento de compras podem chamar a API após escanear códigos de barras que resolvem preços unitários e guardar total_cost e cost_per_serving ao lado do número de convidados.