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

حاسبة مؤشر أسعار المستهلك من سلة ثابتة

تقيّم حاسبة مؤشر أسعار المستهلك هذه السلة نفسها من السلع والخدمات مرتين: مرة بأسعار سنة الأساس ومرة بالأسعار الحالية.

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

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

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

أنشئوا سلة ثابتة بالفعل

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

افهموا صيغة المؤشر ونتيجته

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

فسّروا المقارنات بحذر

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

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

تتبع سلة منزلية

قارنوا تكلفة مجموعة محددة باستمرار من الغذاء والنقل والسكن والخدمات بفترة أساس مختارة.

مراقبة أسعار المشتريات

قيّموا كميات مدخلات ثابتة بأسعار العقد والأسعار الحالية لتلخيص حركة تكاليف الشراء العامة.

تعليم طرائق الأرقام القياسية

وضّحوا كيف تعمل الكميات أوزانًا وكيف تفصل السلة الثابتة بين تغير السعر وتغير الكمية.

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

ما الصيغة التي تستخدمها الحاسبة؟

تقسم تكلفة السلة الثابتة بالأسعار الحالية على تكلفتها بأسعار سنة الأساس، ثم تضرب الناتج في مئة.

ماذا يعني أن يكون المؤشر 100؟

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

هل يمكن تغيير الكميات بين الفترات؟

لا. تطبق الطريقة الكمية الثابتة نفسها على مجموعتي الأسعار كي تقيس الأسعار لا تغير المشتريات.

هل يجوز أن يكون سعر أحد البنود صفرًا؟

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

هل يساوي هذا مؤشر الأسعار الوطني الرسمي؟

ليس بالضرورة. قد تتضمن المؤشرات الرسمية أيضًا أخذ العينات وتعديل الجودة والإحلال وإجراءات إحصائية أخرى.

ما تكلفة الاستخدام؟

سعر طلب API هو $0.002. وتنفذ نسخة المتصفح الحساب الحتمي نفسه محليًا.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/econ/cpi-from-basket

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

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

curl -X POST https://api.kit.forhosting.com/econ/cpi-from-basket \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"basket":[{"name":"Bread","quantity":10,"base_price":2,"current_price":2.5},{"name":"Milk","quantity":5,"base_price":3,"current_price":3.3},{"name":"Bus fares","quantity":20,"base_price":1.5,"current_price":1.8}]}'

const res = await fetch("https://api.kit.forhosting.com/econ/cpi-from-basket", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "basket": [
      {
        "name": "Bread",
        "quantity": 10,
        "base_price": 2,
        "current_price": 2.5
      },
      {
        "name": "Milk",
        "quantity": 5,
        "base_price": 3,
        "current_price": 3.3
      },
      {
        "name": "Bus fares",
        "quantity": 20,
        "base_price": 1.5,
        "current_price": 1.8
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/econ/cpi-from-basket",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "basket": [
        {
            "name": "Bread",
            "quantity": 10,
            "base_price": 2,
            "current_price": 2.5
        },
        {
            "name": "Milk",
            "quantity": 5,
            "base_price": 3,
            "current_price": 3.3
        },
        {
            "name": "Bus fares",
            "quantity": 20,
            "base_price": 1.5,
            "current_price": 1.8
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/econ/cpi-from-basket", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"basket":[{"name":"Bread","quantity":10,"base_price":2,"current_price":2.5},{"name":"Milk","quantity":5,"base_price":3,"current_price":3.3},{"name":"Bus fares","quantity":20,"base_price":1.5,"current_price":1.8}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"basket":[{"name":"Bread","quantity":10,"base_price":2,"current_price":2.5},{"name":"Milk","quantity":5,"base_price":3,"current_price":3.3},{"name":"Bus fares","quantity":20,"base_price":1.5,"current_price":1.8}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/econ/cpi-from-basket", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "basket": [
    {
      "name": "Bread",
      "quantity": 10,
      "base_price": 2,
      "current_price": 2.5
    },
    {
      "name": "Milk",
      "quantity": 5,
      "base_price": 3,
      "current_price": 3.3
    },
    {
      "name": "Bus fares",
      "quantity": 20,
      "base_price": 1.5,
      "current_price": 1.8
    }
  ]
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "econ.cpi_from_basket",
  "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 الكامل ←