وحدة · LNK الترقيم والمراجع

LNK الترقيم والمراجع: أرقام فواتيرك وإشعارات الدائن وإيصالات التسليم، ورقم أمر شراء العميل

لعميلك المحترف رقم أمر شراء، ولا يدفع قسم المحاسبة لديه فاتورة لا تحمله. واليوم يكتبه في رسالة وتنسخه أنت يدويًا. تمنحه LNK الترقيم والمراجع حقلًا في خطوة الدفع، ويرافق الرقم الطلب حتى الفاتورة. وترقّم الوحدة أيضًا مستنداتك بصيغتك: F2026-00042 لفاتورة، وAV2026-00007 لإشعار دائن.

  • الإصدار 1.1.1 · PrestaShop من 1.7.6 إلى 8.x
  • الإصدار 1.9.1 · PrestaShop 9
  • PrestaShop من 1.7.6 إلى 9.x
  • PHP من 7.1 إلى 8.4
  • يحتوي على تعديل للنواة

لقطات الشاشة

سلسلة لكل مستند (الطلبات والفواتير وإشعارات الدائن وإيصالات التسليم): مفتاح ونمط وإعادة تصفير، ورقم البداية تحت «متقدّم»
سلسلة لكل مستند (الطلبات والفواتير وإشعارات الدائن وإيصالات التسليم): مفتاح ونمط وإعادة تصفير، ورقم البداية تحت «متقدّم»

لقطات الشاشة

النقاط الرئيسية

  • سلاسل ترقيم لكل متجر: الطلب، والفاتورة، وإشعار الدائن، وإيصال التسليم.
  • نمط بالوسوم ({YYYY} و{YY} و{MM} و{SHOP} و{NNNNN})، وإعادة تصفير سنوية أو شهرية.
  • معاينة الرقم التالي، وسجل للأرقام المُعطاة مع البحث فيها.
  • لا يتغير الرقم المُعطى أبدًا؛ عدّاد بلا تكرار، حتى في الثانية نفسها.
  • إشعار دائن يذكر الفاتورة الأصلية.
  • حقل «مرجع طلبك» في أعلى خطوة الدفع.
  • إدخال يُحفظ أثناء الكتابة، ويُنسخ إلى الطلب.
  • إلزامي لمجموعات العملاء المختارة، ويتحقق منه الخادم.
  • على الفاتورة وإيصال التسليم بصيغة PDF.
  • عمود ومرشّح في قائمة الطلبات.
  • قابل للتعديل من صفحة الطلب.
  • المتغير {lnk_poref} لرسائل الطلب الإلكترونية.
  • 0.5 كيلوبايت من CSS و1.3 كيلوبايت من JavaScript، في صفحة الطلب وحدها.
  • تعدد المتاجر: إعدادات لكل متجر.
  • الفرنسية والإنجليزية والعربية (من اليمين إلى اليسار).
  • PrestaShop من 1.7.6 إلى 9، مع تجاوزين (override) مُعلنين (رقما إشعار الدائن وإيصال التسليم بصيغة PDF).

أرقام فواتيرك وإشعارات الدائن وإيصالات التسليم

سلسلة لكل مستند ولكل متجر: مرجع الطلب، والفاتورة، وإشعار الدائن، وإيصال التسليم. تكتب النمط بالوسوم: {YYYY} للسنة، و{MM} للشهر، و{SHOP} للمتجر، و{NNNNN} للعدّاد. ويعود العدّاد إلى البداية كل سنة أو كل شهر أو لا يعود أبدًا، وتعرض المعاينة الرقم التالي أثناء الكتابة. ويبدأ فوق آخر رقم أعطاه PrestaShop مباشرة، كي لا يعود أي رقم مطبوع.

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

حقل في خطوة الدفع

يظهر «مرجع طلبك» في أعلى خطوة الدفع. يُحفظ ما يكتبه العميل أولًا بأول، ويُنسخ إلى الطلب عند تقديمه. الحروف والأرقام بكل أنظمة الكتابة، والعلامات المعتادة في الأرقام (. , _ / # : + -)، ضمن الطول الذي تختاره.

إلزامي لعملائك المحترفين

حدِّد المجموعات التي يكون المرجع إلزاميًا لها: لا يستطيع هؤلاء العملاء الدفع من دونه. ينتظر زر الدفع الإدخال، ويعيد الخادم إلى خطوة الدفع أي دفع بدأ دون مرجع. ولا يرى العملاء الآخرون إلا حقلًا اختياريًا.

على الفاتورة وإيصال التسليم وفي قائمة الطلبات

يُطبع المرجع على الفاتورة وإيصال التسليم بصيغة PDF. وله عموده في قائمة الطلبات في لوحة الإدارة، مع مرشّح: اكتب الرقم الذي يعطيك إياه العميل بالهاتف، فيظهر الطلب. ويظهر في تفاصيل طلب العميل، وتصحّحه من صفحة الطلب. ويمكن لرسائل الطلب الإلكترونية عرضه بالمتغير {lnk_poref}.

خفيفة وسريعة

أرقام مقيسة على الوحدة المسلَّمة، مضغوطة (zlib، المستوى 9): 0.5 كيلوبايت من CSS و1.3 كيلوبايت من JavaScript، تُحمَّل في صفحة الطلب وحدها. ولا تحمّل أي صفحة أخرى من المتجر شيئًا.

متوافقة مع PrestaShop 1.7.6 و8 و9

نسختان من الوحدة، واحدة لكل جيل: 1.1 لـ PrestaShop من 1.7.6 إلى 8.x، و1.9 لـ PrestaShop 9، مع صفحة إعدادات أصلية في كل لوحة إدارة، تحت «الطلبات». تم التحقق على منصة الاختبار على 1.7.6 و8.1 و9.0 و9.2 مع قالب Classic. تجاوزان (override) مُعلنان (رقما إشعار الدائن وإيصال التسليم بصيغة PDF)، ولا تعديل لأي قالب بريد، ولا اتصال خارجي.

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

أين يكتب العميل مرجعه؟

في أعلى خطوة الدفع من مسار الطلب، قبل اختيار وسيلة الدفع. يُحفظ ما يكتبه أولًا بأول، ويرى العميل «تم الحفظ.» تحت الحقل.

هل يمكن جعل المرجع إلزاميًا للعملاء المحترفين وحدهم؟

نعم. حدِّد مجموعات العملاء المعنية في الإعدادات. لا يستطيع هؤلاء العملاء الدفع دون مرجع، ويرى الآخرون حقلًا اختياريًا. والمجموعة المعتبرة هي المجموعة الافتراضية للعميل.

هل يستطيع عميل تجاوز المرجع الإلزامي؟

ليس عبر مسار الطلب. ينتظر زر الدفع المرجع، وإذا بدأ دفع من دونه، يعيد الخادم العميل إلى خطوة الدفع مع رسالة، قبل إنشاء الطلب. وحدٌّ واحد فقط: الدفع المؤكَّد خارج مسار الطلب، عبر اتصال من خادم إلى خادم من مزوّد الدفع (دون سلة الزائر)، لا يُتحقَّق منه. يُنشأ الطلب حينها دون مرجع، ويمكنك إضافته من صفحة الطلب.

هل يظهر المرجع على الفاتورة؟

نعم، على الفاتورة وإيصال التسليم بصيغة PDF، تحت تفاصيل الطلب، مع تسمية الحقل بلغة الطلب. ويزيله مفتاح في الإعدادات من المستندين.

كيف أجد طلبًا انطلاقًا من رقم العميل؟

في قائمة الطلبات في لوحة الإدارة، لعمود «مرجع العميل» مرشّحه: اكتب الرقم كله أو جزءًا منه. ويشمل البحث كل الطلبات، لا الصفحة المعروضة وحدها.

هل يمكن تصحيح مرجع بعد الطلب؟

نعم، من صفحة الطلب في لوحة الإدارة، بواسطة موظف يملك صلاحية تعديل الطلبات. والحقل الفارغ يزيل المرجع.

هل يمكن أن يظهر المرجع في الرسائل الإلكترونية؟

نعم. تتلقى رسائل الطلب (التأكيد، وتغيّر الحالة) المتغير {lnk_poref}. ولا تعدّل الوحدة أي قالب بريد: أضف المتغير حيث تشاء في قوالبك. ويكون فارغًا حين لا يكون للطلب مرجع.

ما المحارف المقبولة؟

الحروف والأرقام بكل أنظمة الكتابة، والمسافات و. , _ / # : + -، على أن يبدأ المرجع بحرف أو رقم. ويُضبط الطول الأقصى في الإعدادات، 40 محرفًا افتراضيًا و64 على الأكثر. والإدخال المرفوض يعرض رسالة تحت الحقل.

هل يمكن تغيير تسمية الحقل؟

نعم، في كل لغة: «رقم أمر الشراء» مثلًا. وإن بقيت فارغة، يحتفظ الحقل بتسمية «مرجع طلبك» مترجمةً. وتُستعمل التسمية نفسها في تفاصيل الطلب وعلى المستندات.

هل تبطئ المتجر؟

لا. تحمّل الوحدة 0.5 كيلوبايت من CSS و1.3 كيلوبايت من JavaScript مضغوطة، في صفحة الطلب وحدها. ولا تحمّل الصفحات الأخرى شيئًا.

هل تعمل مع قالبي ومسار الطلب لديّ؟

مع مسار الطلب الأصلي لـ PrestaShop، دون أي إعداد (تم التحقق مع Classic على 1.7.6 و8.1 و9.2). ويضع القالب أو مسار الطلب المخصّص الخطّاف displayLnkPorefField؛ وتنطبق حماية الخادم في كل الأحوال.

هل هي متوافقة مع تعدد المتاجر؟

نعم. تُضبط الإعدادات لكل متجر أو لكل مجموعة متاجر أو لكل المتاجر. ويرتبط كل مرجع بمتجر طلبه. وتُضبط سلاسل الترقيم متجرًا متجرًا، لكل منها عدّادها.

كيف أرقّم فواتيري بصيغتي؟

في الإعدادات، قسم الترقيم، افتح «الفواتير». اكتب النمط، مثل F{YYYY}-{NNNNN}، واختر متى يعود العدّاد إلى البداية (أبدًا، كل سنة، كل شهر)، ثم فعّل السلسلة. وتعرض المعاينة الرقم التالي أثناء الكتابة. وللطلبات وإشعارات الدائن وإيصالات التسليم سلسلة لكل منها، على النموذج نفسه.

ما مصير الفواتير الصادرة من قبل؟

تحتفظ برقمها: لا تعيد الوحدة ترقيم مستند صادر أبدًا. ولا تسري السلسلة إلا على المستندات التالية، وبدايتها المقترحة فوق آخر رقم أعطاه PrestaShop مباشرة، كي لا يعود أي رقم مطبوع.

هل يمكن أن تحصل فاتورتان صادرتان في الثانية نفسها على الرقم نفسه؟

لا. يُؤخذ العدّاد في استعلام واحد يقفل سطره، ويرفض فهرس فريد أي تكرار. ويحصل مستندان صادران معًا على رقمين متتاليين.

هل يذكر إشعار الدائن الفاتورة الأصلية؟

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

هل يمكن تغيير النمط خلال السنة؟

نعم. تبقى الأرقام المُعطاة كما هي، ويسري النمط الجديد على المستندات التالية. ولا يُعطى رقم سبق إعطاؤه مرة ثانية أبدًا. ويحفظ السجل كل تغيير، مع الموظف والتاريخ.

هل تعدّل الوحدة ملفات PrestaShop؟

تستخدم خطافات النواة حيثما وُجدت. أما عنوان إشعار الدائن وإيصال التسليم بصيغة PDF واسم ملفيهما، فلا تقدّم النواة خطافًا يعمل لذلك: لذا تثبّت الوحدة تجاوزين (override) مُعلنين، وثالثًا لمرجع الطلب في الإصدارات من 1.7.6 إلى 8.0. يثبّتها PrestaShop ويزيلها مع الوحدة. ولا يُعدَّل أي قالب بريد إلكتروني.

سجل الإصدارات

4 إصدارات منشورة لـ PrestaShop

  1. الإصدار 1.9.1 PrestaShop 9

    الجديد

    • تصبح الوحدة «LNK الترقيم والمراجع»: إضافة إلى مرجع المشتري، تُرقّم مستندات المتجر.
    • سلاسل ترقيم لكل متجر، لمرجع الطلب ورقم الفاتورة ورقم إشعار الدائن ورقم إيصال التسليم: الوسوم {YYYY} و{YY} و{MM} و{SHOP} والعدّاد {N…}، وإعادة التصفير أبدًا أو كل سنة أو كل شهر، ورقم البداية.
    • عدّاد ذرّي: يحصل مستندان صادران في الثانية نفسها على رقمين مختلفين متتاليين. لا يُعطى رقم مرتين، ويحتفظ كل مستند صادر برقمه.
    • الفاتورة: يُسند رقم السلسلة عند انتقال الطلب إلى حالة «الفاتورة»، ويظهر على ملف PDF وفي لوحة الإدارة ولدى LNK الفوترة الإلكترونية. وتحتفظ الفاتورة الصادرة قبل السلسلة برقمها.
    • إشعار الدائن: يُسند رقم السلسلة عند إنشاء الإشعار. ويحمله ملف PDF عنوانًا واسمًا للملف، ويذكر الفاتورة الأصلية (رقمها وتاريخها).
    • إيصال التسليم: يُسند رقم السلسلة عند تغيير الحالة الذي يُنشئ الإيصال. ويحمله ملف PDF عنوانًا واسمًا للملف. ويحتفظ الإيصال الصادر قبل السلسلة برقمه.
    • لوحة الإدارة: قسم لكل مستند (النمط، وإعادة التصفير، ورقم البداية مطويًّا تحت «متقدّم»)، ومعاينة مباشرة للأرقام التالية، وسجل: البحث عن رقم أو مرجع طلب أو مرجع مشترٍ، وآخر الأرقام المُعطاة، وتغييرات السلاسل. وفي صفحة الطلب، أرقام السلسلة أمام أرقام PrestaShop.
    • العقد lnk.poref.reference/1: مرجع المشتري لوحدة LNK الفوترة الإلكترونية.
  2. الإصدار 1.9.0 PrestaShop 9

    الجديد

    • حقل «مرجع طلبك» في أعلى خطوة الدفع: رقم أمر الشراء الخاص بالمشتري، يُحفظ في السلة أثناء الكتابة، ثم يُنسخ إلى الطلب.
    • مرجع إلزامي لمجموعات العملاء المختارة: ينتظر زر الدفع المرجع، ويعيد الخادم إلى خطوة الدفع أي دفع بدأ من دونه.
    • المرجع في تفاصيل الطلب لدى العميل، وفي صفحة الطلب في لوحة الإدارة (قابل للتعديل)، وفي عمود قابل للتصفية في قائمة الطلبات، وعلى الفاتورة وإيصال التسليم بصيغة PDF، وفي المتغير {lnk_poref} لرسائل الطلب الإلكترونية.
    • عقد القالب lnk.poref/1: الخطّافان displayLnkPorefField وdisplayLnkPoref، والحدث lnk:poref:saved، ومتغيرات CSS ‏--lnk-poref-*.
    • صفحة إعدادات بالمظهر المشترك لوحدات LNK، تحت «الطلبات»، مع معاينة للحقل وتفاصيل الطلب والفاتورة.
    • تعدد المتاجر: إعدادات لكل متجر أو لكل مجموعة أو مشتركة؛ والمراجع مرتبطة بمتجر طلبها.
    • الفرنسية والإنجليزية والعربية (من اليمين إلى اليسار).
  3. الإصدار 1.1.1 PrestaShop من 1.7.6 إلى 8.x

    الجديد

    • تصبح الوحدة «LNK الترقيم والمراجع»: إضافة إلى مرجع المشتري، تُرقّم مستندات المتجر.
    • سلاسل ترقيم لكل متجر، لمرجع الطلب ورقم الفاتورة ورقم إشعار الدائن ورقم إيصال التسليم: الوسوم {YYYY} و{YY} و{MM} و{SHOP} والعدّاد {N…}، وإعادة التصفير أبدًا أو كل سنة أو كل شهر، ورقم البداية.
    • عدّاد ذرّي: يحصل مستندان صادران في الثانية نفسها على رقمين مختلفين متتاليين. لا يُعطى رقم مرتين، ويحتفظ كل مستند صادر برقمه.
    • الفاتورة: يُسند رقم السلسلة عند انتقال الطلب إلى حالة «الفاتورة»، ويظهر على ملف PDF وفي لوحة الإدارة ولدى LNK الفوترة الإلكترونية. وتحتفظ الفاتورة الصادرة قبل السلسلة برقمها.
    • إشعار الدائن: يُسند رقم السلسلة عند إنشاء الإشعار. ويحمله ملف PDF عنوانًا واسمًا للملف، ويذكر الفاتورة الأصلية (رقمها وتاريخها).
    • إيصال التسليم: يُسند رقم السلسلة عند تغيير الحالة الذي يُنشئ الإيصال. ويحمله ملف PDF عنوانًا واسمًا للملف. ويحتفظ الإيصال الصادر قبل السلسلة برقمه.
    • لوحة الإدارة: قسم لكل مستند (النمط، وإعادة التصفير، ورقم البداية مطويًّا تحت «متقدّم»)، ومعاينة مباشرة للأرقام التالية، وسجل: البحث عن رقم أو مرجع طلب أو مرجع مشترٍ، وآخر الأرقام المُعطاة، وتغييرات السلاسل. وفي صفحة الطلب، أرقام السلسلة أمام أرقام PrestaShop.
    • العقد lnk.poref.reference/1: مرجع المشتري لوحدة LNK الفوترة الإلكترونية.
عرض الإصدار السابق
  1. الإصدار 1.1.0 PrestaShop من 1.7.6 إلى 8.x

    الجديد

    • حقل «مرجع طلبك» في أعلى خطوة الدفع: رقم أمر الشراء الخاص بالمشتري، يُحفظ في السلة أثناء الكتابة، ثم يُنسخ إلى الطلب.
    • مرجع إلزامي لمجموعات العملاء المختارة: ينتظر زر الدفع المرجع، ويعيد الخادم إلى خطوة الدفع أي دفع بدأ من دونه.
    • المرجع في تفاصيل الطلب لدى العميل، وفي صفحة الطلب في لوحة الإدارة (قابل للتعديل)، وفي عمود قابل للتصفية في قائمة الطلبات، وعلى الفاتورة وإيصال التسليم بصيغة PDF، وفي المتغير {lnk_poref} لرسائل الطلب الإلكترونية.
    • عقد القالب lnk.poref/1: الخطّافان displayLnkPorefField وdisplayLnkPoref، والحدث lnk:poref:saved، ومتغيرات CSS ‏--lnk-poref-*.
    • صفحة إعدادات بالمظهر المشترك لوحدات LNK، تحت «الطلبات»، مع معاينة للحقل وتفاصيل الطلب والفاتورة.
    • تعدد المتاجر: إعدادات لكل متجر أو لكل مجموعة أو مشتركة؛ والمراجع مرتبطة بمتجر طلبها.
    • الفرنسية والإنجليزية والعربية (من اليمين إلى اليسار).

سلتك

سلتك فارغة.