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

احسبوا كمية مستلزمات الحفل المطلوبة

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

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

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

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

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

ابدؤوا بعدد واقعي للضيوف وخطة مناسبة للتقديم

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

افهموا كيف يغير الهامش الاحتياطي كل كمية

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

حولوا النتيجة إلى قائمة مشتريات عملية

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

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

خططوا لحفل ميلاد

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

أعدوا عرض سعر لفعالية

طبقوا معايير ثابتة لكل ضيف عند إعداد تقدير شفاف للمستلزمات يقدَّم إلى العميل.

نظموا تجمعًا مجتمعيًا

حولوا الحضور المتوقع إلى أهداف واضحة للأطباق والأكواب والمناديل يستفيد منها المتطوعون أو فرق الشراء.

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

ماذا يحدث إذا كان عدد الضيوف صفرًا أو سالبًا؟

يعيد الطلب خطأ يفيد بأن الإدخال غير صالح، لأن عدد الضيوف يجب أن يكون عددًا صحيحًا موجبًا.

كيف يطبق الهامش الاحتياطي؟

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

هل يمكن تعيين إحدى فئات المستلزمات على صفر؟

نعم. يرجى استخدام صفر عندما لا تكون تلك الفئة مطلوبة في الفعالية.

هل تراعي النتيجة أحجام العبوات؟

لا. فهي تعيد عدد القطع؛ اقسموا كل نتيجة على حجم عبوة المورد وقربوا إلى الأعلى عند الشراء.

ما تكلفة عملية الحساب عبر API؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/final3/party-supply-quantity-calc

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

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

curl -X POST https://api.kit.forhosting.com/final3/party-supply-quantity-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"guest_count":40}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/final3/party-supply-quantity-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "guest_count": 40
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "guest_count": 40
}

مثال على الاستجابة

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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