ForHosting KIT · المال والتمويل

حاسبة القوة الشرائية

مع تضخم بنسبة 3 بالمئة، فإن 1,000 تبقى مدخرة 10 سنوات لا تشتري إلا ما تشتريه اليوم 744.09، أي خسارة حقيقية قدرها 255.91. أدخل المبلغ ومعدل التضخم السنوي وعدد السنوات لترى قيمة مالك الحقيقية. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

الكمية: 1,000
معدل التضخم: 3
السنوات: 10

تحصل على

عامل التضخم: 1.34391638
القوة الشرائية: 744.09
خسارة القوة الشرائية: 255.91
نسبة القوة الشرائية: 0.744094

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

معنى القوة الشرائية المتبقية وكيف تعمل الصيغة

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

مثال محلول: ألف بمعدل ثلاثة في المئة على عشر سنوات له العامل 1.34391638 وقوة شرائية متبقية 744.09 بعد تقريب half-up إلى منزلتين، فخسارة القوة الشرائية 255.91 والنسبة المحتفظ بها نحو 0.744094. عندما يكون المعدل صفراً يكون العامل واحداً ولا يتغيّر المبلغ. عندما تكون years صفراً تعيد الهوية نفسها المبلغ الأصلي، وهو الجواب الصادق لأفق لم يبدأ.

معدل سالب يصوّر الانكماش: تهبط الأسعار فيشتري الرصيد النقدي أكثر، وتعطي الصيغة قوة شرائية فوق المبلغ الاسمي.

أين تبرّر حاسبة القوة الشرائية موضعها

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

المعلّمون الذين يشرحون الفرق بين الأرصدة الاسمية والقوة الشرائية الحقيقية يستطيعون بذر أمثلة صفية تُظهر التآكل عند ثلاثة في المئة مقابل خمسة، وإظهار الفشل القاسي عندما يكتب أحدهم عدداً سالباً من السنوات. التحقق الفاشل لا يستهلك رصيداً.

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

شروح احتياطي النقد والادخار

أظهروا للقرّاء ماذا سيشتري رصيد يوم ضيق بعد عدة سنوات بمعدل تضخم معلن، مع الخسارة والنسبة المحتفظ بها إلى جانب القيمة المعدّلة.

بطاقات تقاعد ووسادة سيولة

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

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

كيف تُحسب القوة الشرائية المتبقية؟

النتيجة هي القيمة المعدّلة بالتضخم بعد التركيب السنوي، مقرّبة half-up إلى منزلتين.

ماذا يحدث إن كان عدد السنوات سالباً؟

لا يُقبل أفق سالب؛ أدخلوا صفراً أو أكثر من years. التحقق الفاشل لا يُفوتر.

هل يجوز أن يكون معدل التضخم سالباً؟

نعم. معدل سالب يصوّر الانكماش ويزيد القوة الشرائية الحقيقية، ما دام المعدل أكبر من −100% حتى يبقى 1 + rate/100 موجباً.

هل تستعلم مؤشراً رسمياً لأسعار المستهلك؟

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

هل يمكن حساب القوة الشرائية لجزء من السنة؟

نعم. يقبل عدد السنوات الكسور، فيمكنك النظر في مدة بضعة أشهر. أما مدة صفر سنة فتعيد المبلغ الأصلي كما هو، لأنه لم يمرّ وقت تتغير فيه الأسعار.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/fin/buying-power

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

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

curl -X POST https://api.kit.forhosting.com/fin/buying-power \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":1000,"inflation_rate":3,"years":10}'

const res = await fetch("https://api.kit.forhosting.com/fin/buying-power", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "amount": 1000,
    "inflation_rate": 3,
    "years": 10
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/buying-power",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "amount": 1000,
    "inflation_rate": 3,
    "years": 10
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/buying-power", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"amount":1000,"inflation_rate":3,"years":10}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"amount":1000,"inflation_rate":3,"years":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/buying-power", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "amount": 1000,
  "inflation_rate": 3,
  "years": 10
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.buying_power",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

تعيد حاسبة القوة الشرائية هذه تلك القيمة المعدّلة من ثلاث مدخلات—amount وinflation_rate وyears—وترفض أفقاً سالباً بدل اختراع ماضٍ لم تُطلب الصيغة لإعادة بنائه.

معنى القوة الشرائية المتبقية وكيف تعمل الصيغة

الهوية المعيارية للتركيب السنوي التي تلتقط ذلك التآكل هي buying_power يساوي amount مقسوماً على (واحد زائد معدل التضخم السنوي عشرياً) مرفوعاً إلى عدد years. وبالمثل احسب عامل تضخم (واحد زائد r) مرفوعاً إلى years ثم اقسم amount على ذلك العامل.

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

إن كانت years سالبة يفشل المعالج برسالة أن years يجب ألا تكون سالبة—الحارس المطلوب، لأن أفقاً سالباً ليس مسألة قوة متبقية حسنة الطرح لهذه الصفحة. إن كان amount سالباً تُرفض الطلبية بدل إعادة رقم نقدي سالب. اقرنوا النتيجة بسلسلة CPI الخاصة بكم إن احتجتم مستويات مؤشر رسمية؛ وابدأوا من هنا عندما يكون سؤال المنتج قيمة شفافة معدّلة بالتضخم بثلاث مدخلات لصفحة أو ورقة عمل أو دفعة سيناريوهات. أرسلوا بـ POST جسماً JSON فيه ثلاثة أعداد منتهية إلزامية: amount (وحدات نقدية للمبلغ الذي تريدون قيمته الحقيقية، أكبر من أو يساوي صفراً؛ أسماء بديلة principal وvalue وsum وmoney)، وinflation_rate (التضخم السنوي نسبة مئوية مثل ثلاثة للثلاثة في المئة؛ أسماء بديلة rate وrate_percent وannual_inflation وinflation)، وyears (أفق التركيب، أكبر من أو يساوي صفراً؛ أسماء بديلة n وperiod وhorizon). قد يصل كل حقل عدداً JSON أو سلسلة رقمية. الحقول الناقصة والسلاسل الفارغة والقيم غير المنتهية تفشل بـ invalid_input مع تسمية الحقل ولا تُفوتر. إن كان inflation_rate أصغر من أو يساوي سالب مئة في المئة فإن واحداً زائد r ليس موجباً والأسّ ليس عاملاً حقيقياً نافعاً، فذلك أيضاً invalid_input. عند النجاح يعيد الجسم amount وinflation_rate وyears؛ ويبلّغ inflation_factor مقرباً إلى ثماني منازل؛ ويعيد buying_power وpurchasing_power_loss مالاً مقرباً half-up إلى منزلتين؛ ويعيد purchasing_power_ratio مقرباً إلى ست منازل؛ ويتضمن سلسلة صيغة قصيرة تعيد صياغة الهوية.

أين تبرّر حاسبة القوة الشرائية موضعها

ولأن التنفيذ parse خالص من tier A فإن كل استدعاء ناجح يكلف السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة. أبقوا amount غير سالب والمعدل فوق سالب مئة في المئة وyears عند صفر أو أكثر، وثبّتوا حقول المال المقرّبة في الاختبارات، فتحصلون على قوة شرائية معدّلة بالتضخم قابلة لإعادة الإنتاج للـ widgets وتضمينات CMS والعاملين على الحافة دون إقامة مورّد بيانات اقتصادية خاص بكم.

حالات التكامل

أجور تاريخية وأسعار عتيقة

حوّلوا راتباً سابقاً أو غرامة أو سعر بطاقة إلى رقم معدّل بالتضخم من amount والمعدل السنوي وyears للمقالات وأوراق الصف.

أسئلة تقنية

كم تكلفة حاسبة القوة الشرائية؟

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

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

شغّل الأداة مجانًا

مثال محلول

معنى القوة الشرائية المتبقية وكيف تعمل الصيغة

أين تبرّر حاسبة القوة الشرائية موضعها

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

شروح احتياطي النقد والادخار

بطاقات تقاعد ووسادة سيولة

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

معنى القوة الشرائية المتبقية وكيف تعمل الصيغة

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

أين تبرّر حاسبة القوة الشرائية موضعها

حالات التكامل

أجور تاريخية وأسعار عتيقة

أسئلة تقنية

شكرًا