← العودة للفهرس

أنواع التسعير

قوائم الأسعار التجارية: تجزئة، جملة، نصف جملة، VIP. كل عميل تطبيق يرى نوعاً واحداً، وكل سعر منتج يُحفظ لنوع معيّن داخل شريحة الدولة.

المجموعة: Pricing اسم القائمة: Pricing Types الرابط: /admin/pricing-types الأيقونة: عملة

الغرض ومنطق العمل

النوع ليس دولة وليس شريحة. الدولة تختار الشريحة الجغرافية، والنوع يختار أي قائمة أسعار داخل تلك الشريحة. الأنواع المزروعة مسبقاً: Retail (افتراضي)، Wholesale، Half Wholesale، VIP.

نوع واحد فقط يمكن أن يكون Default. عند تفعيل Default على نوع يُلغى عن البقية. العملاء الجدد في اللوحة يأخذون النوع الافتراضي النشط ما لم تُغيّره.

الارتباطات مع الموارد الأخرى

المورد المرتبط	الحقل	أثر الارتباط
App Customers	Price Type (App) — `pricing_type_id`	يحدد أي قائمة يراها العميل في التطبيق. الأنواع غير النشطة لا تظهر للاختيار الجديد. عند حذف النوع يُصفَّر الحقل عند العميل (nullOnDelete).
Product Prices	`pricing_type_id`	كل صف سعر = منتج + شريحة + نوع. لا تكرار لنفس الثلاثي.
Pricing Segments	لا مفتاح مباشر	الشريحة جغرافية (دولة). النوع تجاري. الاثنان معاً يحددان السعر.
Pricing Import/Export	عمود Pricing Type Code	الاستيراد يطابق `code` النشط (مثل retail). النوع غير النشط يُرفض.
Products — حقول السعر القديمة	`price_retail` وغيرها	احتياطي إن لم يوجد صف في Product Prices. التطبيق يفضّل جدول الأسعار.

أين تظهر

تطبيق الجوال: سعر المنتج حسب نوع العميل + شريحة دولته الافتراضية.
الموقع العام: لا يستخدم نوع العميل؛ يعتمد على شريحة الدولة المختارة في الرأس ثم صف سعر في تلك الشريحة.

صورة تقريبية — النموذج

Edit Pricing Type

Code *

retail

Name *

Retail

Description

Standard retail pricing…

Is default

Is active

Sort order

الحقول

الاسم الظاهر	الاسم التقني	مطلوب؟	الشرح
Code	`code`	مطلوب	فريد، يُحفظ بأحرف صغيرة. مثال: retail، wholesale. يُستخدم في الاستيراد والتطبيق.
Name	`name`	مطلوب	الاسم الظاهر في القوائم.
Description	`description`	اختياري	شرح داخلي.
Is default	`is_default`	اختياري	نوع واحد افتراضي لكل النظام. للعملاء الجدد في اللوحة.
Is active	`is_active`	افتراضي مفعّل	غير النشط لا يُختار لعملاء جدد ولا في الاستيراد.
Sort order	`sort_order`	افتراضي 0	ترتيب القائمة. يمكن السحب لإعادة الترتيب.

الجدول: Code، Name، Default، Active، Sort order. فلاتر Default و Active. Edit / Delete. صفحة القائمة في الكود بلا زر New في الرأس؛ الإنشاء عبر /admin/pricing-types/create.

خطوات العمل

لا تُنشئ أنواعاً جديدة إلا لحاجة تجارية واضحة. الأنواع الأربعة الجاهزة تغطي الحالة الشائعة.
أبقِ Retail (أو النوع المتفق عليه) Default و Active.
بعد أي نوع جديد املأ Product Prices لكل شريحة نشطة، وإلا لن يرى عملاؤه سعراً من الجدول الجديد.

أخطاء شائعة

المشكلة	السبب	الحل
لا أجد زر New	غير مضاف في رأس القائمة	افتح `/admin/pricing-types/create` أو عدّل الموجود.
عطّلت النوع وما زال عميل يراه	الحساب القديم ما زال مربوطاً به	غيّر Price Type (App) عند العميل، أو احذف النوع فيُصفَّر الربط.
خلط مع Pricing Segments	الاسمان متقاربان	النوع = تجزئة/جملة. الشريحة = سوريا Default / العراق…