ForHosting KIT · المنزل والطبخ والهوايات

متتبع ميزانية التسوق

بميزانية قدرها 100 وحليب وخبز وبيض وتفاح بمجموع 10.53، يبقى لك 89.47. بعد كل صنف ترى الرصيد المتبقي، فتعرف أي صنف سيجعلك تتجاوز الميزانية قبل الوصول إلى الصندوق. مجاني في متصفحك.

  • مجاني
  • يعمل في متصفحك
  • دون تسجيل
  • بياناتك لا تغادر جهازك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا
إذا أدخلت
الميزانية
100
تحصل على
عدد العناصر
4
إجمالي المنفق
10.53
المتبقي
89.47
المبلغ الزائد
0

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

كيف يُحسب الرصيد المتبقي وحالة تجاوز الميزانية

ابدؤوا بميزانية تسوق غير سالبة بوحدة العملة التي تستخدمونها أصلًا لأسعار الرف—لا تحوّل الحاسبة العملات ولا تطبّق أسعار صرف. خذوا لكل سطر في السلة سعرًا منتهيًا غير سالب؛ والأسماء الاختيارية تُعلّم السطر للعرض. إجمالي المنفق هو مجموع كل الأسعار في القائمة.

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

يُسمح بميزانية صفر: أي إنفاق موجب يُبلّغ عنه تجاوزًا، بما يوافق قواعد المظروف حيث نفدت الحصة أصلًا. تُقبل عينات مجانية بسعر صفر ولا تغيّر المجموع. تُرفض الميزانيات والأسعار السالبة لأنها لا تصف حصة تسوق فعلية ولا سعر رف في هذا المنتج.

أين يثبت متتبع ميزانية التسوق قيمته

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

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

مظروف البقالة الأسبوعي

أدخلوا ميزانية الطعام الأسبوعية وأسعار الممر أثناء التسوق؛ راقبوا الرصيد المتبقي وتوقفوا عندما تتجاوز السلة الحد.

سلة منزلية مشتركة

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

كيف تعمل حاسبة متتبع ميزانية التسوق؟

أرسلوا ميزانية غير سالبة وقائمة أسعار غير فارغة.

هل يمكن أن تكون أسعار الأصناف صفرًا؟

نعم. تُسمح عينات مجانية أو أسطر ترويجية بالسعر 0.

هل أحتاج أسماء على كل سطر في السلة؟

لا. الأسماء اختيارية. تُعامل الأعداد المجردة كأسعار، وتحصل الأسطر بلا اسم على تسميات مستقرة مثل Item 1 للعرض.

ماذا يحدث إذا تجاوزت الميزانية؟

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

كيف أعرف أي صنف جعلني أتجاوز الميزانية؟

انظر إلى الرصيد المعروض بعد كل سطر. تُطرح الأسعار بالترتيب، لذا فإن أول سطر ينخفض فيه الرصيد إلى ما دون الصفر هو الصنف الذي تجاوز بالسلة الحد.

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

POSThttps://api.kit.forhosting.com/life/shopping-budget

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

curl -X POST https://api.kit.forhosting.com/life/shopping-budget \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"budget":100,"items":[{"name":"Milk 1 L","price":1.49},{"name":"Bread","price":2.25},{"name":"Eggs (12)","price":3.8},{"name":"Apples 1 kg","price":2.99}]}'
{
  "budget": 100,
  "items": [
    {
      "name": "Milk 1 L",
      "price": 1.49
    },
    {
      "name": "Bread",
      "price": 2.25
    },
    {
      "name": "Eggs (12)",
      "price": 3.8
    },
    {
      "name": "Apples 1 kg",
      "price": 2.99
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.shopping_budget",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

لكل طلب$0.002

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

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

نفس الحساب الخالص يغذي أداة المتصفح المجانية ومسار API المدفوع، فلا تختلف قائمة الهاتف ومحقق سلة الخلفية على المجموع. يُرفض التحقق الفاشل—ميزانية ناقصة أو قوائم فارغة أو أسعار سالبة—بوصفه invalid_input ولا يُحاسب عليه.

كيف يُحسب الرصيد المتبقي وحالة تجاوز الميزانية

يُثبَّت التقريب إلى اثنتي عشرة منزلة عشرية لحقول المال حتى تبقى نتائج المتصفح وAPI مستقرة عبر بيئات التشغيل دون ضوضاء الفاصلة العائمة في جمع بسيط.

عقد الإدخال وشكل الاستجابة وسلوك الأخطاء

قد يكون كل سطر عددًا مجردًا يُعامل سعرًا، أو كائنًا بحقل price إلزامي وname اختياري. تُرفض القوائم الأطول من خمسمئة سطر لإبقاء عمل pure-parse محدودًا. أرسلوا بهيئة POST جسم JSON بحقلين إلزاميين: budget وهو عدد منتهٍ أكبر من أو يساوي صفرًا، وitems وهو مصفوفة غير فارغة من أسطر السلة. يقبل price أيضًا أسماء بديلة شائعة مثل cost أو amount؛ ويقبل حقل القائمة cart وprices وlines وlist. يقبل budget الأسماء البديلة limit وmax وtotal_budget وallowance لإعادة استخدام مفردات أدوات المال الأخرى. عند النجاح يعيد الجسم الميزانية وعدد الأصناف وكل سطر باسم مستقر وسعر مقرب ورصيد جارٍ بعد ذلك السطر، إضافة إلى total_spent وremaining وover_budget وover_amount وwithin_budget وpercent_used وسلسلة صيغة ورسالة مقروءة وخطوات مرتبة لأوراق العمل. مثال: ميزانية مئة مع حليب one point four nine وخبز two point two five وبيض three point eight وتفاح two point nine nine تعطي إجماليًا ten point five three ومتبقيًا eighty-nine point four seven مع over_budget false. إذا اقترنت الميزانية نفسها بأسطر مجموعها يتجاوز المئة، يكون over_budget true ويبيّن over_amount مقدار تجاوز الحد—وما زالت استجابة نجاح لا خطأ، لأن تجاوز الميزانية هو السؤال الذي يجيب عنه المتتبع. الميزانية الناقصة أو items الفارغة أو الأعداد غير المنتهية أو الأسعار السالبة تفشل بـ invalid_input مع تسمية الحقل ولا تُحاسب.

أين يثبت متتبع ميزانية التسوق قيمته

تكلف مقررات التمويل الشخصي تمارين سلة مقابل ميزانية؛ وواجهة API برصيد جارٍ مرتب بعد كل سطر تسمح بتقييم أي إضافة تجاوزت الحد أولًا. يمكن لسكربتات الأتمتة التي تبني خطط وجبات أسبوعية إرسال مجاميع أسطر المكونات وإيقاف إعادة التزويد عندما يصبح over_budget true. ولأن التنفيذ pure parse من المستوى A، تكلف كل استدعاء ناجح السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة.

أتمتة خطة الوجبات

ترسل السكربتات أسعار المكونات المخططة مقابل سقف ثابت وتوقف إعادة التزويد عندما يصبح over_budget true.

ماذا يحدث إذا تجاوزت الميزانية؟

يظل الاستدعاء ناجحًا. remaining سالب وover_budget true وover_amount يبيّن مقدار تجاوز الحد. تجاوز الميزانية لا يُعامل كـ invalid_input.

كم تكلفة متتبع ميزانية التسوق؟

أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ والإدخال غير الصالح لا يُحاسب.

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