تخطَّ إلى المحتوى

المتاجر التجريبية

ما يحتويه المتجر التجريبي، وكيف تعيد تهيئته، وحدوده.

آخر تحديث 2 أيلول 2026قراءة 2 د
في هذه الصفحة

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

ما يحتويه المتجر التجريبي#

يُزرع كل متجر تجريبي بمصفوفة كاملة تغطي ما يحتاجه تطبيق شحن أو إشعارات أو محاسبة دون بناء بيانات يدوياً:

المجال المحتوى
الكتالوج 12 منتجاً بمتغيرات تغطي كل حالات المتغير (active، out_of_stock، hidden، discontinued) ومنتج غير مُدار مخزونياً.
المخزون موقعان (الافتراضي ومستودع)، وحركة initial لكل متغير في كل موقع، ثم حركة واحدة من كل سبب آخر.
الخصومات نوع من كل value_type: نسبة مئوية بكود (RAMADAN10)، ومبلغ ثابت تلقائي، وشحن مجاني (FREESHIP)، واشترِ X واحصل على Y (غير مفعّل).
الطلبات طلب في كل حالة: placed، approved، processing (مع شحنة pending جزئية)، shipped، delivered، delivered_failed، returned (غير مدفوع، بلا استرداد)، partially_refunded (استرداد بتفصيل الأسطر)، cancelled، completed من نقطة بيع بأسطر صافية (line_pricing: net).
المدفوعات الطلبات المسلَّمة مدفوعة عبر سجل cod_collection في دفتر المدفوعات، لا عبر مفتاح.
العملات طلب بالدولار مع لقطة سعر صرف بمقياس 8 (exchange_rate.scale: 8).

كل المبالغ أعداد صحيحة بالوحدات الصغرى؛ الليرة السورية بلا خانات والدولار بخانتين. راجع المال بالوحدات الصغرى.

إنشاء متجر تجريبي#

من صفحة المتاجر التجريبية اختر متجر تجريبي جديد وسمّه (اختياري، حتى 80 حرفاً). يُنشأ المتجر ويُزرع في الخلفية على منصّة التجّار؛ تتغيّر حالته من provisioning إلى active خلال لحظات. الحد 3 متاجر تجريبية حية لكل مؤسسة (تُحتسب الحالات provisioning وactive وresetting والطلبات المعلّقة).

إعادة التهيئة والتجديد والحذف#

تُدار المتاجر التجريبية بأوامر مرتّبة تنفّذها منصّة التجّار؛ أمر واحد مفتوح لكل متجر في الوقت نفسه:

الأمر الأثر
إعادة التهيئة (reset) يمسح كل البيانات، بما فيها ما أنشأه تطبيقك، ثم يعيد الزرع من الصفر.
تجديد (renew) يمدّد الصلاحية 90 يوماً من تاريخ الانتهاء أو من اليوم أيهما أبعد.
حذف (purge) يحذف المتجر نهائياً ويحرّر مكانه من الحصة.

يعيش المتجر التجريبي 90 يوماً ثم يصبح expired؛ رموز الأداة المربوطة به تتوقف عن العمل حتى تجدّده. لا تُطبَّق هذه الأوامر أبداً على متجر حقيقي مربوط للاختبار.

تحذير

يرفض النظام إعادة تهيئة متجر تجريبي تغطّي قيودَ إيراداته عملية تحويل مالي قائمة. ألغِ التحويل أولاً، ثم أعد التهيئة.

ثيم واحد لكل متجر تجريبي#

يشتق الخادم هوية الثيم الخارجي من المتجر التجريبي الذي ينتمي إليه رمز الأداة (sandbox-<id>)، فلا يمكن لثيمين مشاركة متجر تجريبي واحد: دفع الثيم «أ» برمز متجر الثيم «ب» يضيف إصداراً إلى «ب». أنشئ متجراً تجريبياً لكل ثيم.

أطلق أول حدث#

افتح واجهة المتجر التجريبي https://dukkan.one/stores/YOUR_SANDBOX_SLUG، أضف منتجاً إلى السلة وأتمّ الشراء بالدفع عند الاستلام. ينتج عن ذلك order.created فوراً، ثم order.status_changed عند كل انتقال تجريه من لوحة التاجر أو عبر PATCH /orders/{id}/status. أكّد التحصيل النقدي من لوحة التاجر لترى order.paid يصدر من الدفتر لا من التسليم.

المتاجر المربوطة#

يمكنك أيضاً ربط متجر حقيقي تملكه مؤسستك لاختبار تثبيت التطبيقات. المتجر المربوط لا يُزرع ولا يُعاد تهيئته ولا يقبل دفع الثيمات؛ هو للتوزيع التطويري فقط.

الحدود#

الحد القيمة
المتاجر التجريبية الحية لكل مؤسسة 3
عمر المتجر التجريبي 90 يوماً، قابل للتجديد
الأوامر المتزامنة لكل متجر 1
طلبات واجهة الثيمات لكل رمز أداة 120 في الدقيقة
رموز الأداة وصول لساعة، تحديث 30 يوماً، تدوير مع كل استخدام