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

احسب معدل إرجاع المنتجات من المبيعات والمرتجعات

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

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

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

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

اختاروا أعداداً متطابقة النطاق للمبيعات والمرتجعات

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

افهموا طريقة حساب النسبة المئوية

الصيغة مباشرة: تُقسم الوحدات المرتجعة على الوحدات المبيعة، ثم يُضرب الناتج في مئة. إذا باع متجر 1,250 وحدة وسجل 37 مرتجعاً، يكون الحساب 37 مقسوماً على 1,250 ومضروباً في 100، فتكون النتيجة 2.96 بالمئة. تُقرب النتيجة إلى ست منازل عشرية كحد أقصى كي تظل حسابات API والمتصفح ثابتة مع دقة كافية للكتالوجات الكبيرة وحالات الإرجاع قليلة العدد. يعبر المعدل عن علاقة، وليس تشخيصاً. فقد تشير النسبة المرتفعة إلى مشكلات في المقاسات أو أضرار أو أوصاف غير دقيقة أو توقعات العملاء أو سياسة مرنة أو فرق زمني بين الشراء والإرجاع. قارنوا المعدلات فقط عندما تكون قواعد العد متسقة. فالتقرير المبني على الوحدات المشحونة لا يقارن مباشرة بتقرير مبني على الوحدات المطلوبة. يعيد الناتج عرض العددين المدخلين إلى جانب النسبة، مما يسهل تدقيق قيمة لوحة المعلومات وتأكيد المقام المستخدم. احتفظوا بهذه الأعداد مع المعدل متى كانت قابلية إعادة النتيجة مهمة.

استخدموا معدل الإرجاع في التحليل الدوري

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

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

قارنوا أداء المنتجات

احسبوا معدل كل رمز SKU للفترة نفسها وبقواعد العد نفسها لتحديد المنتجات التي تستدعي مراجعة أدق.

راقبوا تغييرات تجهيز الطلبات

تابعوا النسب أسبوعياً أو شهرياً بعد تغييرات التغليف أو شركة الشحن أو المستودع أو مراقبة الجودة.

أنشئوا تقارير التجارة

أضيفوا معدل إرجاع قابلاً للتكرار إلى لوحات المعلومات مع حفظ أعداد المبيعات والمرتجعات المستخدمة.

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

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

تقسم الوحدات المرتجعة على الوحدات المبيعة، ثم تضرب النتيجة في 100.

ماذا يحدث إذا كانت الوحدات المبيعة صفراً؟

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

هل يمكن أن يكون عدد الوحدات المرتجعة صفراً؟

نعم. عندما تكون المبيعات موجبة، ينتج عن عدم وجود مرتجعات معدل قدره 0 بالمئة.

هل يمكن أن تتجاوز النتيجة 100 بالمئة؟

نعم. قد يحدث ذلك عندما تشمل الفترة مرتجعات لمنتجات بيعت في فترة سابقة.

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

تكلف كل مطالبة API مبلغ $0.002. ويمكنكم أيضاً تشغيل الحاسبة في المتصفح.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/ecom/return-rate-calculate

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

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

curl -X POST https://api.kit.forhosting.com/ecom/return-rate-calculate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"units_sold":1250,"units_returned":37}'

const res = await fetch("https://api.kit.forhosting.com/ecom/return-rate-calculate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "units_sold": 1250,
    "units_returned": 37
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/return-rate-calculate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "units_sold": 1250,
    "units_returned": 37
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/return-rate-calculate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"units_sold":1250,"units_returned":37}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"units_sold":1250,"units_returned":37}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/return-rate-calculate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "units_sold": 1250,
  "units_returned": 37
}

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

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