باقات التاجر وحدودها: الميزات وما يحدث عند بلوغ الحد
مرجع لميزات باقة التاجر وحدودها (API والويب هوك والمتاجر والاستيراد والطرود وأماكن الاستلام)، ومعنى الباقة القديمة، وقاعدة الترقية فقط، وشكل رسالة المنع.
آخر تحديث 22 أكتوبر 2026 · آخر تحقق 22 أكتوبر 2026
الغرض#
تحدد باقة التاجر الميزات التي يستطيع تاجر المنصة المستقل استخدامها والكميات المسموحة منها: عدد الطرود في الاشتراك، وطلبات الـ API، وروابط الويب هوك، والمتاجر المربوطة، وأماكن الاستلام، والمناديب. يعدّد هذا المرجع كل ميزة وكل حدّ، وشكل الرسالة عند منع أي إجراء، وقواعد الترقية.
على من تنطبق الباقات؟#
- تاجر المنصة المستقل. ينشئ السوبر أدمن الباقات ويعدّلها من «باقات التجار»، ولا يستطيع التاجر تغييرها.
- لا تنطبق الميزات وحد الطرود وحدود الـ API والويب هوك والمتاجر على التاجر التابع لشركة توصيل (اشتراكه هو اشتراك شركته)، ولا على الحساب الذي تستخدمه المنصة لشحن الأفراد (الضيوف)، ولا على أحد عندما لا توجد باقة تجار مفعّلة في النظام. أما فحص أماكن الاستلام فلا يستثني أحداً: يُطبَّق على أي تاجر ما دامت هناك باقة تجار مفعّلة في النظام.
- بدون اشتراك فعّال لا يستطيع التاجر إنشاء طرود ولا استخدام ميزات الباقة، لكن صفحتا المحفظة والباقات تبقيان مفتوحتين.
تحقق من باقتك واستهلاكك#
افتح صفحة الباقة
اختر «الباقة والاشتراك» من قسم «المالية» في القائمة الجانبية.
اقرأ اشتراكك واستهلاكك
تعرض «اشتراكك الحالي» الباقة وتاريخ البداية والانتهاء والمدة (شهرية أو سنوية). وتعرض «استهلاكك من الباقة» المستخدَم والحد الأقصى لـ«الطرود خلال الاشتراك» ولـ«طلبات الـ API اليوم» و«روابط الويب هوك» و«المتاجر المربوطة» عندما تكون الميزة مفعّلة. والرمز ∞ يعني بلا حد.
رقِّ باقتك عند الحاجة
في بطاقة الباقة اضغط «ادفع من الرصيد» (يُخصم سعرها بالدولار من رصيد الشحن بعد التأكيد)، أو «ادفع عبر …» إذا فُعّلت بوابة للباقات. وعند الدفع بالبوابة يُضاف سعر الباقة إلى المحفظة ثم تُفعَّل الباقة.
- اختر مكان استلام الطرد
- اختر شركة التوصيل
- اكتب اسم المستلم ورقمه
- حدّد مبلغ التحصيل عند الاستلام
- رقم فاتورتك لتتعرّف على الطرد لاحقاً
الميزات التي تفعّلها الباقة#
تفعّل كل باقة هذه الميزات أو تعطّلها. وتظهر في بطاقة الباقة بعلامة صح، أو بسطر مشطوب إذا كانت معطّلة، باسم مختصر (دون الجزء الذي بين قوسين) تُضاف إليه حدود الـ API والويب هوك والمتاجر.
| الميزة (المعرّف) | الاسم (في نموذج السوبر أدمن والرسائل) | عند تعطيلها |
|---|---|---|
api |
«الـ API (مفاتيح API للربط مع أي نظام)» | لا يمكن توليد مفاتيح API، وكل استدعاء لـ /api/v1 يرد بـ 403 plan_feature. |
webhooks |
«الويب هوك (تحديثات الطرود لنظامك)» | يُرفض إضافة رابط، ويردّ POST /api/v1/webhooks بـ 403 plan_feature (أما بقية نقاط النهاية الخاصة بالويب هوك في الـ API فلا تفحص هذه الميزة)، وتتوقف الأحداث عن الإرسال. |
stores |
«ربط المتاجر (سلة، ووكومرس، شوبيفاي)» | يُرفض ربط متجر أو توليد مفتاح متجر. |
import |
«استيراد الطرود من Excel» | تحوّلك صفحة الاستيراد إلى صفحة الباقة مع تنبيه. |
own_carrier |
«ربط حسابك الخاص مع شركات الشحن» | يُرفض حفظ بيانات حسابك الخاص لدى شركة الشحن. |
warehouses |
«خدمة المستودعات» | لا تتوفر خدمة المستودعات إلا إذا فعّلها السوبر أدمن لك يدوياً؛ ويجب أن تكون الخدمة نفسها مفعّلة في النظام. |
reports_export |
«تصدير التقارير (CSV)» | يُرفض تصدير تقارير الطرود وكشف الحساب مع تنبيه. |
live_tracking |
«تتبّع المناديب المباشر على الخريطة (لمناديب شركتك الخاصة)» | تعرض صفحة الخريطة رسالة المنع. |
الحدود#
في الطرود تعني القيمة 0 بلا حد (الحقل إلزامي). وفي api_per_minute وapi_per_day وwebhooks_max وstores_max تعني القيمة الفارغة أو 0 بلا حد من الباقة.
| الإعداد | المعنى | القيمة الافتراضية في نموذج باقة جديدة | عند تجاوزه |
|---|---|---|---|
الطرود (parcel_count) |
الطرود المنشأة من تاريخ بداية الاشتراك إلى تاريخ انتهائه، دون المحذوفة | لا يوجد | يُرفض إنشاء الطرود من كل المصادر (اللوحة والاستيراد والـ API والمتاجر) |
api_per_minute |
طلبات الـ API في الدقيقة | 60 | 429 rate_limited |
api_per_day |
طلبات الـ API في اليوم، ويُصفَّر عند منتصف الليل | 5000 | 429 rate_limited |
webhooks_max |
روابط الويب هوك (الحد الأقصى للنظام 10) | 3 | يُرفض إضافة رابط (وفي الـ API: 422 limit_reached) |
stores_max |
المتاجر المربوطة، وإعادة ربط المتجر نفسه لا تُحتسب | 1 | يُرفض الربط |
| أماكن الاستلام | العدد المسموح من أماكن الاستلام، ولا يقل عن 1 (القيمة 0 أو الفارغة تُعدّ 1)، وأماكن المستودعات لا تُحتسب | 1 | يُرفض إضافة مكان |
| المناديب | مناديب شركتك الخاصة للتوصيل، والصفر لا يسمح بأي مندوب | يُحدَّد لكل باقة | يُرفض إضافة مندوب |
إضافةً إلى حدود الباقة، للـ API حدود ثابتة لكل مسار تُطبَّق فوقها: 120 طلباً في الدقيقة لمجموعة /api/v1 كلها، و60 لـ POST /parcels، و30 لـ GET /statement، و20 لـ POST /webhooks، و10 لاختبار الويب هوك. لذلك لا يمكن استخدام حد باقة أعلى منها كاملاً، والرد 429 الذي لا يحمل الرمز rate_limited جاء من هذه الحدود الثابتة لا من الباقة (راجع دليل حدود الطلبات).
الباقات القديمة#
الباقة التي أُنشئت قبل إضافة الميزات تبقى ميزاتها غير مضبوطة: كل الميزات مفعّلة، ولا توجد حدود لطلبات الـ API ولا للويب هوك ولا للمتاجر، ولا يُطبَّق عدد الطرود، إلى أن يفتحها السوبر أدمن ويضبط الميزات ويحفظ (ويحذّر نموذج التعديل من ذلك). وبعد الحفظ تصبح أي ميزة غير محددة معطّلة. أما الحدّان المحفوظان في الباقة نفسها لأماكن الاستلام والمناديب فيبقيان مطبّقين كما في أي باقة.
قواعد الترقية فقط#
الباقة المحفوظة بالنوع الشهري مدتها 30 يوماً وبالنوع السنوي 365 يوماً؛ أما الباقة التي أُنشئت قبل ظهور خيار النوع فتحتفظ بعدد أيامها الأصلي (يظهر في بطاقة الباقة) إلى أن يحفظها السوبر أدمن من جديد. وما دام الاشتراك فعّالاً لا يمكنك تجديده مبكراً ولا النزول إلى باقة أدنى.
- المسموح: مستوى أعلى، أو الانتقال من شهري إلى سنوي بالمستوى نفسه؛ ولا يُسمح بالانتقال من سنوي إلى شهري حتى لو كان المستوى أعلى.
- المرفوض: الباقة نفسها، أو مستوى أدنى، أو الانتقال من سنوي إلى شهري، أو باقة أخرى بالمستوى والمدة نفسيهما.
- تبدأ الترقية اليوم وينتهي الاشتراك القديم أمس. يُخصم سعر الباقة الجديدة كاملاً ولا تُحتسب الأيام غير المستهلكة من القديمة. وإذا كان سعر الباقة صفراً فلا يُخصم شيء.
- إذا لم يكن لديك اشتراك فعّال فيمكنك اختيار أي باقة.
شكل الرسالة عند المنع#
في الـ API تصل الرسالة بالعربية افتراضياً، وبالإنجليزية فقط إذا أرسل العميل ترويسة Accept-Language تبدأ بـ en. أما رمز الخطأ (plan_feature وrate_limited وvalidation_failed وlimit_reached وapi_not_allowed) فهو نفسه في اللغتين.
| الحالة | الرسالة | أين تظهر |
|---|---|---|
| حد الطرود | “وصلت لحد باقتك: 100 طرد خلال مدة الاشتراك (لحد 2026-11-30)، واستعملت 100. رقّي باقتك أو جدّد الاشتراك لتكمّل.” | قائمة الأخطاء في نموذج «طرد جديد»، وسطر نتيجة في الاستيراد، و422 validation_failed في الـ API |
| الميزة غير مضمّنة | “ميزة «تصدير التقارير (CSV)» مو ضمن باقتك الحالية — رقّي باقتك من صفحة الاشتراك.” | تنبيه بعنوان «الباقة»، أو 403 plan_feature في الـ API |
| لا اشتراك فعّال | “ما عندك اشتراك فعّال بباقة تجار — اشترك لتستعمل «…».” وللطرود: “اشتراك التاجر بباقة التجار منتهي أو غير موجود — جدّد الاشتراك لإنشاء طرود.” | الأماكن نفسها |
| حد طلبات الـ API | “وصلت لحد باقتك: 60 طلب بالدقيقة. استنى 30 ثانية أو رقّي باقتك.” | 429 مع retry_after وترويسة Retry-After |
| حدود أخرى | “وصلت لحد باقتك: 3 روابط ويب هوك. رقّي باقتك لتضيف أكتر.” و“باقتك تسمح بـ 2 مكان استلام فقط، وعندك 2. رقّي الباقة لإضافة أماكن أكثر.” | النموذج الذي يضيف العنصر |
| أماكن الاستلام بلا اشتراك | “لا يوجد اشتراك فعّال بباقة تجار — اشترك أولاً لتتمكن من إضافة أماكن استلام.” | النموذج الذي يضيف المكان، لكل تاجر |
أخطاء شائعة#
- محاولة تمديد الباقة الحالية: تُرفض حتى تنتهي. رقِّ باقتك بدلاً من ذلك.
- ميزة مفعّلة لكن الاستدعاء مرفوض: راجع أشرطة الاستهلاك وحدّ طلبات الـ API في الدقيقة وفي اليوم والحدود الثابتة لمسارات الـ API وحدّ روابط الويب هوك وحدّ المتاجر.
- فشل استدعاءات الـ API بلا اشتراك: عند تفعيل الباقات يعني غياب الاشتراك الفعّال أن كل استدعاء لـ
/api/v1يرد بـ 403plan_feature. وتاجر الشركة يتلقى 403api_not_allowed.
الحدود والصلاحيات#
- السوبر أدمن وحده يعدّل الباقات. وتُنفَّذ الفحوص على الخادم للوحة والـ API والاستيراد والمتاجر المربوطة.
- لا تعرض بطاقات الباقات إلا الباقات المفعّلة.
- تستمر أحداث الويب هوك بالإرسال بعد انتهاء الباقة، لكنها تتوقف إذا كانت الباقة الفعّالة بلا ميزة
webhooks. - بعض هذه الرسائل بلا ترجمة إنجليزية، وصياغة رسالة حد الـ API بالإنجليزية غير سليمة إذ تظهر «order Per minute».