توثيق مولّد SKU والباركود التلقائي لأودو 19
دليل SKU والباركود التلقائيين: كيف تُبنى الرموز والإعدادات والبادئات لكل فئة والمتغيرات وملء المنتجات الموجودة والضمانات.
يشرح الإصدار 1.0.1حُدّث في 23 أكتوبر 2026
ابدأ من هنا
ببساطة: يحتاج كل منتج إلى رمز: SKU يستطيع الناس قراءته وقوله بالهاتف، وباركود تقرؤه الماسحات. كتابتهما يدويًا تعني فجوات وتكرارًا وسؤال «ما آخر رقم استخدمناه؟». تمنح هذه الوحدة كل منتج جديد الاثنين تلقائيًا لحظة حفظه.
| ما تفعله | ما تفعله الوحدة |
|---|---|
| تحفظ منتجًا جديدًا | تملأ المرجع (SKU) ببادئة الفئة والرقم التالي، والباركود بـEAN-13 صحيح. |
| تضيف متغيرات (لون، مقاس) | يحصل كل متغير على رمز بنمط SKU-RED-M وباركود خاص به. |
| لديك آلاف المنتجات بلا رموز | نقرة واحدة تملأ الناقص. ولا تُمَسّ الرموز الموجودة. |
نصيحة: لا يُستبدل شيء كتبته أنت أبدًا، ولا تنشئ الوحدة رمزًا مكررًا: إن كان الرمز مأخوذًا تأخذ التالي الحر.
كيف تبدو الرموز
| الرمز | مثال | يتكوّن من |
|---|---|---|
| SKU المنتج | FUR-0042 | بادئة الفئة FUR + الفاصل - + الرقم 0042 |
| SKU المتغير | CLO-0001-RED-M | SKU المنتج + أول 3 أحرف من كل خيار (Red وM) |
| الباركود (EAN-13) | 2000000000015 | بادئتك 200 + عدّاد 000000001 + رقم التحقق 5 |
| الباركود (مثل SKU) | FUR-0042 | الـSKU نفسه كباركود Code 128 |
ببساطة: البادئة والفاصل وعدد الأرقام ونوع الباركود كلها إعدادات. ويُحسب رقم التحقق عنك، فكل EAN-13 صحيح ويُمسح من أول مرة.
نصيحة: الأرقام من 200 إلى 299 تحجزها GS1 للاستخدام الداخلي فلا تتعارض أبدًا مع باركودات الموردين المطبوعة على بضائعهم. ويمكنك اختيار أي بادئة من 2 إلى 8 أرقام.
المتطلبات
| البند | التفاصيل |
|---|---|
| أودو | 19.0 (Community أو Enterprise) |
| التطبيقات المطلوبة | تطبيق المنتجات الأساسي فقط (product)، وهو موجود في كل قاعدة بيانات للمبيعات أو المخزون أو المشتريات أو نقاط البيع |
| الرخصة | OPL-1 (رخصة أودو الخاصة v1.0) |
التثبيت
- فُكّ ضغط الحزمة. بداخلها
taqnix_sku_barcode_generator.zip؛ فُكّه لتحصل على المجلدtaqnix_sku_barcode_generator. - انسخ المجلد إلى أحد مجلدات
addons_pathفي خادم أودو وأعد تشغيل أودو. - سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
- أزل مرشح «التطبيقات» وابحث عن SKU واضغط تثبيت.
# أو من سطر الأوامر ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_sku_barcode_generator --stop-after-init
نصيحة: التثبيت لا يغيّر شيئًا في منتجاتك الحالية. من الآن تحصل المنتجات الجديدة على رموز. استخدم الفصل 9 لملء القديمة.
الإعدادات
ببساطة: افتح الإعدادات ← رموز المنتجات. الإعدادات خاصة بكل شركة.
| الإعداد | ما يفعله |
|---|---|
| توليد SKU للمنتجات الجديدة | تشغيل أو إيقاف SKU التلقائي. |
| البادئة الافتراضية | تُستخدم للمنتجات التي لا تملك فئتها (ولا فئاتها الأم) بادئة. الافتراضي PRD. |
| الفاصل | يوضع بين البادئة والرقم وخيارات المتغير. الافتراضي -. |
| عدد الأرقام في الرقم | 4 تعطي 0001 حتى 9999؛ و6 تعطي 000001. الافتراضي 4. |
| توليد الباركود للمنتجات الجديدة | تشغيل أو إيقاف الباركود التلقائي. |
| نوع الباركود | EAN-13 ببادئتك الخاصة، أو SKU كباركود. |
| بادئة EAN-13 | من 2 إلى 8 أرقام في بداية كل باركود. الافتراضي 200. |
بادئة لكل فئة
ببساطة: يبدأ الـSKU ببادئة فئة المنتج. افتح المخزون ← الإعدادات ← فئات المنتجات (أو المبيعات أو الفوترة، حيث تحتفظ بالفئات) واملأ بادئة SKU.
| القاعدة | مثال |
|---|---|
| الفئة التي لها بادئة تستخدمها | الأثاث: FUR ← FUR-0001 وFUR-0002… |
| الفئة الفرعية بلا بادئة تستخدم بادئة أبيها وتتشارك عدّاده | الأثاث / المكتب ← FUR-0003 |
| أحرف وأرقام فقط، حتى 12، وتُحفظ بأحرف كبيرة | off تُحفظ OFF |
| لا بادئة في أي مكان أعلى الشجرة | البادئة الافتراضية: PRD-0001 |
| فئتان بالبادئة نفسها | تتشاركان عدّادًا واحدًا: لا تعارض |
ببساطة: يعرض الرقم التالي الرقم الذي سيحصل عليه المنتج القادم. ويمكنك تغييره، مثلًا لمتابعة نظام قديم: اكتب 5000 فيكون المنتج القادم FUR-5000.
المنتجات الجديدة
ببساطة: أنشئ منتجًا كالمعتاد واحفظه. إن كان المرجع أو الباركود فارغًا تملؤه الوحدة. هذا كل شيء.
| الحالة | النتيجة |
|---|---|
| كتبت مرجعًا | يُحفظ. ويُولَّد الباركود فقط (إن كان فارغًا). |
| كتبت باركودًا | يُحفظ. ويُولَّد المرجع فقط (إن كان فارغًا). |
| تكرر منتجًا | تحصل النسخة على رموز جديدة (لا ينسخها أودو). |
| أُنشئ المنتج باستيراد أو من الموقع أو من تطبيق آخر | الأمر نفسه: تُملأ الرموز الفارغة وتبقى الموجودة. |
| الرقم الذي سيأتي مستخدم عند منتج آخر | تأخذ الوحدة التالي الحر. |
| الباركود مستخدم عند منتج أو تغليف آخر | تأخذ الوحدة التالي الحر. |
ببساطة: يعرض عنوان المنتج الرمز بين قوسين، [FUR-0001] Ergonomic Standing Desk، في الطلبات والتسليمات والفواتير.
المتغيرات
ببساطة: للمنتجات ذات الخيارات (لون، مقاس…) متغير لكل تركيبة. يحصل كل متغير على SKU وباركود خاصين به، لأن هذا ما تمسحه وتشحنه.
| الخيار | في الـSKU |
|---|---|
| Red | RED |
| Blue | BLU |
| M | M |
| Large | LAR |
ببساطة: الـSKU الخاص بالمنتج (هنا
CLO-0001) هو الأساس، ويضيف كل خيار أول 3 أحرف منه. وإن حصل متغيران على الرمز نفسه يحصل الثاني على -2.نصيحة: المنتج ذو المتغيرات لا يعرض مرجعًا في نموذجه: الرموز على المتغيرات. افتح زر المتغيرات أو قائمة متغيرات المنتج.
ببساطة: إن أضفت لونًا جديدًا لاحقًا تحصل المتغيرات الجديدة على رموزها تلقائيًا؛ وتحتفظ الموجودة برموزها.
المنتجات الموجودة بالفعل
ببساطة: المنتجات التي أُنشئت قبل تثبيت الوحدة، أو والوضع التلقائي مُوقَف، بلا رموز. املأها دفعة واحدة.
- في قائمة المنتجات حدّد المنتجات التي تريدها (أو لا شيء).
- افتح الإجراءات ← توليد الرموز الناقصة.
- اختر النطاق: المنتجات المحددة أو فئة (مع فئاتها الفرعية) أو كل المنتجات.
- راجع الأعداد تحت ماذا سيحدث وضع علامة على SKU و/أو الباركود واضغط توليد.
ببساطة: لمنتج واحد استخدم زر توليد الرموز في نموذجه. وهو ظاهر فقط ما دام المرجع أو الباركود فارغًا.
القواعد والضمانات
| الضمان | كيف |
|---|---|
| لا يستبدل شيئًا | تُملأ حقول المرجع والباركود الفارغة فقط. |
| لا SKU مكرر | يُتخطى الرقم إن كان لأي منتج (حتى المؤرشف) هذا الـSKU. |
| لا باركود مكرر | يُتخطى إن كان لأي منتج أو تغليف. |
| EAN-13 صحيح | 13 رقمًا، رقم التحقق محسوب، وأساس من 12 رقمًا من بادئتك وعدّاد. |
| العدّادات لا ترجع للخلف | هي تسلسلات في قاعدة البيانات، آمنة عندما يحفظ عدة مستخدمين في اللحظة نفسها. |
| لا تُعاد الأرقام | المنتج المحذوف أو الملغى يترك فجوة. هذا طبيعي ويُبقي الرموز فريدة. |
| عدة شركات | الإعدادات لكل شركة؛ عدّادات SKU مشتركة بحسب البادئة، وعدّادات الباركود لكل شركة. |
مهم: تغيير بادئة فئة لا يعيد تسمية الـSKU الموجودة. تحتفظ المنتجات القديمة برمزها القديم؛ وتستخدم الجديدة البادئة الجديدة.
للمطورين
ببساطة: تجاوز هذا الفصل إن كنت تستخدم الوحدة فقط.
| البند | التفاصيل |
|---|---|
product.product._tx_assign_codes(force=False) | تملأ الرموز الناقصة للمنتجات. force يتجاهل المفاتيح التلقائية. تعيد (عدد SKU المنشأة، عدد الباركودات المنشأة). |
_tx_make_sku(company) / _tx_make_barcode(company) | تعيدان الرمز الحر التالي. تجاوزهما لتغيير الصيغة. |
السياق tx_skip_codes | اجعله True لإنشاء منتجات دون توليد رموز (مثلًا في ترحيل). |
السياق install_mode | البيانات التي تحمّلها الوحدات لا تُمنح رموزًا أبدًا. |
taqnix.sku.tools | ean13_check_digit() وis_valid_ean13(). |
# أنشئ منتجات بلا رموز ثم املأها لاحقًا
products = env['product.product'].with_context(tx_skip_codes=True).create(vals_list)
products._tx_assign_codes(force=True)
# صيغتك الخاصة: PREFIX/YEAR/NUMBER
class ProductProduct(models.Model):
_inherit = 'product.product'
def _tx_make_sku(self, company):
sku = super()._tx_make_sku(company)
return sku.replace('-', '/', 1)استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| منتج جديد بلا رمز | المفتاح التلقائي مُوقَف في الإعدادات ← رموز المنتجات، أو أُنشئ المنتج بـtx_skip_codes. استخدم زر توليد الرموز. |
| لا تعرض قائمة المنتجات مرجعًا لمنتج ذي متغيرات | هكذا يعمل أودو: الرموز على المتغيرات. |
| «يجب أن تكون بادئة EAN-13 من 2 إلى 8 أرقام» | استخدم أرقامًا فقط، بين 2 و8 منها. |
| «يمكن أن تحتوي بادئة SKU على أحرف وأرقام فقط» | أزل المسافات والشرطات والرموز من بادئة الفئة. |
| الأرقام تقفز | يُتخطى الرقم عندما يستخدم منتج ذلك الـSKU، والمنتج المحذوف يترك فجوة. كلاهما طبيعي. |
| أريد أن يبدأ SKU من 1 من جديد | افتح الفئة وعيّن الرقم التالي إلى 1، لكن فقط إن لم يكن لأي منتج SKU كهذا: تتخطى الوحدة المستخدم. |
التحديث والإزالة
استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_sku_barcode_generator. للإزالة ألغِ تثبيتها من التطبيقات. تبقى الرموز التي مُنحت بالفعل على منتجاتك كقيم عادية للمرجع والباركود. وتُزال البادئات والعدّادات والإعدادات.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.