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

حاسبة ادخار تقريب قيمة المشتريات

توضح هذه الحاسبة مقدار ما يمكنكم ادخاره عند تقريب كل عملية شراء إلى الدولار الصحيح التالي.

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

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

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

كيف يتحول تقريب المشتريات إلى مدخرات

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

إدخال قائمة مشتريات دقيقة ومفيدة

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

فهم الإجمالي ومقارنة خطط الادخار

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

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

تقدير عادة ادخار شهرية

عالجوا مشتريات شهر ممثل لمعرفة المبلغ الذي قد تخصصه قاعدة التقريب إلى الدولار التالي.

مراجعة سجل التقريب المصرفي

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

إضافة التقريب إلى إعداد الميزانية

عالجوا مبالغ المعاملات المصدرة ومرروا النتيجة المفصلة والثابتة إلى تقرير أو لوحة معلومات.

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

كيف يُحتسب مبلغ تقريب كل عملية؟

تُرفع قيمة الشراء إلى الدولار الصحيح التالي، ويصبح الفرق مدخرات. أما الشراء بقيمة صحيحة فيساهم بصفر.

ماذا يحدث إذا انتهت قيمة الشراء بلاحقة .00؟

تبقى القيمة كما هي وتضيف صفراً إلى إجمالي المدخرات، ولا ترتفع دولاراً إضافياً.

هل يمكن إدخال المبالغ المستردة أو المعاملات السالبة؟

لا. تُرفض القيم السالبة لأن المؤسسات تعالج رد الأموال وعكس التقريب بطرق مختلفة.

لماذا تقتصر المبالغ على منزلتين عشريتين؟

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

هل يشمل الإجمالي الفائدة أو مساهمة المصرف؟

لا. لا يتضمن سوى فروق التقريب الناتجة عن المشتريات المقدمة.

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

تبلغ كلفة كل طلب API مقدار $0.002، ويمكن أن يضم عدة مبالغ ضمن الحد المنشور.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/fin/round-up-savings-calc

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

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

curl -X POST https://api.kit.forhosting.com/fin/round-up-savings-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchases":[3.45,12,8.99,0.01]}'

const res = await fetch("https://api.kit.forhosting.com/fin/round-up-savings-calc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "purchases": [
      3.45,
      12,
      8.99,
      0.01
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/round-up-savings-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "purchases": [
        3.45,
        12,
        8.99,
        0.01
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/round-up-savings-calc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"purchases":[3.45,12,8.99,0.01]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"purchases":[3.45,12,8.99,0.01]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/round-up-savings-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "purchases": [
    3.45,
    12,
    8.99,
    0.01
  ]
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_items 10000

الأخطاء

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

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