ForHosting KIT · أدوات المطورين

التكلفة الإجمالية للوصفة

تجمع حاسبة التكلفة الإجمالية للوصفة مقدار ما يضيفه كل مكوّن إلى تكلفة الطبق. أدخلوا الكمية المستخدمة فعليًا وسعر الوحدة المطابق لها، فتضرب الأداة القيمتين ثم تجمع تكلفة الوصفة كاملة.

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

تفيد هذه العملية عندما لا يوضح سعر العبوة تكلفة الجزء المستهلك منها. الحساب حتمي وشفاف، ويناسب ميزانيات المنازل وتقديرات خدمات الطعام وسجلات المخابز وتخطيط قوائم الطعام والحساب الآلي عبر API.

أعدّوا الكميات والأسعار بوحدات متطابقة

أدخلوا لكل مكوّن الكمية المستخدمة في الوصفة وسعر وحدة واحدة. يجب أن تعبّر القيمتان عن الوحدة نفسها. إذا كانت الوصفة تستخدم 0.5 كيلوغرام من الدقيق، فينبغي إدخال السعر لكل كيلوغرام؛ وإذا كانت تستخدم أربع بيضات، فينبغي إدخال السعر لكل بيضة. حوّلوا سعر العبوة قبل الإدخال عند الحاجة. فعلى سبيل المثال، العبوة التي تحتوي على 2 كيلوغرام وتكلف 6 يكون سعر الكيلوغرام فيها 3. أسماء المكونات اختيارية، لكنها تسهّل مراجعة البنود وحفظها في سجل التكاليف. يمكن أن تكون الكميات والأسعار صفرًا للماء أو المواد المتبرع بها أو المخزون الذي تقررون عدم احتساب تكلفة له. تُرفض القيم السالبة وأي قيمة ليست عددًا منتهيًا. استخدموا عملة واحدة في جميع البنود؛ فالحاسبة تنفذ العمليات الحسابية ولا تحوّل العملات أو تستنتج الوحدات من أسماء المكونات.

تعرّفوا إلى طريقة حساب إجمالي الوصفة

تُحسب تكلفة كل بند بضرب الكمية في سعر الوحدة، ثم تُجمع تكاليف البنود كلها للحصول على إجمالي الوصفة. لنفترض أن عجينًا يستخدم 1.5 كيلوغرام من الدقيق بسعر 1.20 للكيلوغرام، وأربع بيضات بسعر 0.35 للبيضة، و0.25 كيلوغرام من الزبدة بسعر 6.40 للكيلوغرام. تكون تكاليف البنود 1.80 و1.40 و1.60، فتبلغ تكلفة الوصفة كاملة 4.80 بالعملة المختارة. تتضمن النتيجة الكمية المنسقة وسعر الوحدة والتكلفة المحسوبة لكل مكوّن، ثم الإجمالي وصيغة واضحة. يسهّل هذا التفصيل تحديد المكوّن المرتفع التكلفة أو التحقق من النتيجة بشكل مستقل. يحافظ التقريب المتسق على ثبات نتائج JSON بين البيئات مع دقة مناسبة للحساب المعتاد. لا توجد اتصالات شبكية أو قاعدة أسعار أو عشوائية أو تبعية للوقت؛ لذلك تعطي المدخلات الصحيحة المتطابقة النتيجة نفسها دائمًا.

استخدموا النتيجة في الميزانية وقرارات الإنتاج

يمثل الإجمالي تكلفة المكونات المستهلكة في الوصفة كاملة، وليس المبلغ المدفوع عند الشراء ولا سعر بيع مقترحًا. قد يكون ثمن العبوة أكبر من تكلفة الجزء المستخدم لأن المتبقي يصلح لدفعة أخرى. كذلك لا تشمل النتيجة تلقائيًا العمالة أو الطاقة أو التغليف أو التوصيل أو الهدر أو الضرائب أو النفقات العامة أو الربح. أضيفوا هذه البنود ضمن آلية تسعير أشمل عندما تكون مهمة. في الإنتاج المتكرر، احفظوا أسعار الوحدات الموحدة وحدّثوها عند تغير أسعار الموردين، ثم شغّلوا الوصفة نفسها مرة أخرى. ويمكن مقارنة التركيبات البديلة بتغيير كمية أو سعر واحد مع تثبيت بقية البنود. تناسب حاسبة المتصفح التقدير السريع، بينما تبلغ تكلفة API مقدار $0.002 لكل طلب وتدعم حسابًا قابلًا للتكرار داخل أنظمة المخزون والطلبات وقوائم الطعام. سجلوا دائمًا العملة ونظام الوحدات مع النتيجة.

حالات الاستخدام

حساب تكلفة دفعة مخبوزات

اضربوا كميات الدقيق والزبدة والسكر وسائر المكونات المستخدمة في أسعار وحداتها قبل تحديد ميزانية الدفعة.

مقارنة بدائل الوصفة

غيّروا كمية مكوّن واحد أو سعره لدى المورد، ثم قارنوا الإجمالي الجديد بالتركيبة الأصلية.

أتمتة تكاليف قائمة الطعام

أرسلوا بنود المكونات المنظمة عبر API واحفظوا إجماليًا حتميًا ضمن سير عمل المطبخ أو خدمات الطعام.

الأسئلة الشائعة

ما تكلفة عملية حساب واحدة؟

سعر API هو $0.002 لكل طلب. ويمكن أيضًا استخدام الحاسبة مجانًا في المتصفح.

كيف تُحسب تكلفة كل مكوّن؟

تُضرب الكمية في سعر الوحدة، ثم تُجمع جميع البنود لإنتاج التكلفة الإجمالية للوصفة.

هل يجب أن تتطابق وحدتا الكمية والسعر؟

نعم. تتطلب الكمية بالكيلوغرام سعرًا لكل كيلوغرام، بينما تتطلب القطع المعدودة سعرًا لكل قطعة.

هل يمكن إدخال قيم سالبة أو نصوص؟

لا. يجب أن تكون الكميات والأسعار أعدادًا منتهية تساوي صفرًا أو تزيد عليه؛ وتؤدي القيم الأخرى إلى خطأ إدخال.

هل يشمل الإجمالي العمالة والنفقات والربح؟

لا. فهو يجمع استخدام المكونات المحدد فقط. أضيفوا العمالة والتغليف والهدر والضرائب والنفقات والهامش كلًا على حدة.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/cook/recipe-cost

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

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)

مثال على الطلب

{
  "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": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "cook.recipe_cost",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

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

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←