تجاوز إلى المحتوى الرئيسي
الإصدار: 1.x

تكامل WCPOS مع ATUM

يدمج ATUM Multi-Inventory مع WCPOS Pro، مما يتيح إدارة المخزون والتسعير وSKU حسب الموقع في نقطة البيع.

يتيح لك ATUM Multi-Inventory تقسيم مخزون المنتج عبر مواقع مخزون متعددة، مثل المستودعات ومتاجر البيع بالتجزئة وغير ذلك. يربط هذا المكوّن الإضافي مواقع ATUM هذه بـمتاجر WCPOS Pro بحيث يرى كل جهاز POS مستويات المخزون والأسعار وSKU الصحيحة لموقعه الفعلي.

الميزات​

المخزون حسب الموقع

يسحب كل متجر كميات المخزون من موقع مخزون ATUM المعيّن له بدلاً من مخزون WooCommerce الإجمالي.

تسعير مرن

اختر التسعير من إعدادات WooCommerce الافتراضية، أو أسعار WCPOS Pro حسب كل متجر، أو أسعار ATUM الخاصة بالموقع.

رموز SKU حسب الموقع

يمكن اختياريًا استبدال SKU الرئيسي للمنتج بـ SKU خاص بموقع ATUM في POS.

حركة مخزون آمنة للتدقيق

تخصم الطلبات المخزون وتستعيده في موقع ATUM الصحيح، مع سجل تدقيق كامل في atum_inventory_orders.

الكتابة العكسية لتعديلات المنتج

تتم مزامنة تعديلات POS على المخزون والسعر وSKU مرة أخرى إلى صف مخزون ATUM المرتبط بذلك الموقع.

التثبيت​

1

تثبيت ATUM وMulti-Inventory

ثبّت ATUM Inventory Management وإضافة ATUM Multi-Inventory. كوّن مواقع المخزون في ATUM.

2

تثبيت تكامل WCPOS مع ATUM

ثبّته من WP Admin > نقطة البيع > الإعدادات > الإضافات, أو نزّل أحدث إصدار من صفحة إصدارات GitHub وارفعه عبر إضافات > إضافة جديد > رفع إضافة.

3

ربط المتاجر بمواقع ATUM

انتقل إلى نقطة البيع > المتاجر، وحرّر متجرًا، ثم اضبط قسم الشريط الجانبي مخزون ATUM. اختر موقع المخزون الذي ينبغي أن يستخدمه المتجر، وحدد مصدر التسعير، ويمكنك اختياريًا تفعيل تجاوزات SKU.

تهيئة المتجر​

تضيف الإضافة قسم مخزون ATUM إلى الشريط الجانبي لمحرر متجر WCPOS Pro، مع ثلاثة إعدادات لكل متجر:

  • موقع المخزون — موقع ATUM الذي يسحب منه هذا المتجر المخزون.
  • مصدر التسعير — من أين تأتي أسعار المنتجات:
    • افتراضي — أسعار WooCommerce القياسية
    • WCPOS Pro — تسعير لكل متجر يتم ضبطه في WCPOS Pro
    • ATUM — أسعار خاصة بالموقع من مخزون ATUM
  • تجاوز SKU — استخدام وحدات SKU الخاصة بالموقع من ATUM اختياريًا بدلًا من SKU الرئيسي للمنتج.

سلوك POS​

عند تعيين موقع ATUM لأحد المتاجر، يتم تعديل بيانات المنتج المقدمة إلى POS تلقائيًا:

  • كميات المخزون تعكس مخزون الموقع المحدد، وليس إجمالي مخزون WooCommerce.
  • حالة المخزون تتم إعادة احتسابها بناءً على كمية الموقع.
  • تأتي الأسعار من مصدر التسعير المكوَّن.
  • تُستبدل رموز SKU برمز SKU الخاص بموقع ATUM إذا كان التجاوز مفعّلًا.

تتم جميع التعديلات بشفافية عبر WCPOS REST API — ولا يلزم إجراء أي تغييرات من جهة تطبيق POS. كما تُكتب تعديلات المنتجات التي تتم من POS مرة أخرى إلى صف مخزون ATUM المعيّن؛ راجع الكتابة الراجعة لتعديل المنتج أدناه.

إدارة المخزون​

بالنسبة إلى طلبات POS التي تُنشأ في متاجر لها موقع ATUM معيّن، يتيح المكوّن الإضافي لتدفق خصم المخزون الأصلي في ATUM معالجة الكتابة — لكنه يوجّهه إلى الموقع الصحيح:

  1. حقن حمولة REST. عندما ينشئ POS طلبًا أو يحدّثه، يحقن المكوّن الإضافي إدخال mi_inventories في كل بند حتى يعرف ATUM الموقع الذي يجب السحب منه. بدون ذلك، سيعود ATUM إلى المخزون الرئيسي.
  2. عامل تصفية المخزون ضمن نطاق الموقع. يصفّي المكوّن الإضافي قائمة المخزونات المرشحة في ATUM بحيث تقتصر على المخزونات المرتبطة بمصطلح الموقع المعيّن للمتجر، مما يضمن اختيار المخزون الصحيح عند التخفيض والاستعادة.

ينفّذ ATUM نفسه تغيير المخزون الفعلي عند الطلب وردّ المبلغ، ويكتب الصفوف إلى atum_inventory_orders باستخدام order_id الحقيقي — مع الحفاظ على سجل التدقيق في ATUM.

الكتابة الراجعة لتعديل المنتج​

عندما يعدّل أمين الصندوق أو المدير منتجًا أو تنويعة من POS، تتم مزامنة التغييرات مرة أخرى إلى صف مخزون ATUM المعيّن لموقع ذلك المتجر — وليس فقط إلى منتج WooCommerce الرئيسي. يحافظ ذلك على مزامنة مخزون كل موقع وسعره ورمز SKU الخاص به مع ATUM دون تحديثات يدوية في WP Admin.

تُشغَّل الكتابة الراجعة عند تحديثات REST لمنتجات WCPOS وتنويعاتها (POST، PUT، PATCH إلى /wcpos/v1/products/...) التي تتضمن store_id. يبحث المكوّن الإضافي عن موقع ATUM المعيّن للمتجر ويحدّث صف المخزون لذلك الموقع فقط — ولا تتأثر المواقع الأخرى.

ما تتم مزامنته​

تراعي الكتابة الرجعية إعدادات كل متجر، بحيث لا تتغير بيانات ATUM إلا عندما يكون المتجر مالكا فعليا لتلك البيانات:

الحقلمتى تتم مزامنته
كمية المخزوندائما — يحافظ كل متجر لديه موقع ATUM معين على مزامنة صف موقعه.
السعر العادي / سعر التخفيض / السعرفقط عندما يكون مصدر التسعير للمتجر مضبوطا على ATUM.
SKUفقط عند تمكين تجاوز SKU للمتجر.

إذا كان المتجر يستخدم تسعير افتراضي أو WCPOS Pro، فتترك حقول أسعار ATUM كما هي حتى يستمر ATUM في العمل كسعر مرجعي بدلا من أن يكون مصدر الحقيقة. وينطبق الأمر نفسه على قيم SKU عندما يكون التجاوز معطلا.

ما الذي لا يؤدي إلى الكتابة الرجعية​

  • إنشاء المنتجات (تتم الكتابة الرجعية للتحديثات فقط — أما المنتجات الجديدة فتتبع مسار الحفظ العادي في WooCommerce).
  • الطلبات التي لا تحتوي على store_id — يجب أن يخبر POS الإضافة بالموقع الذي ستكتب إليه.
  • المتاجر التي لا يوجد لها موقع ATUM معين.
  • المنتجات التي لا يوجد لها صف مخزون ATUM حالي لموقع المتجر — لن تنشئ الإضافة صفوف مخزون جديدة، بل ستحدث الصفوف الموجودة فقط.

المتطلبات​

WordPress: WordPress 5.9+ مع PHP 7.4+
WooCommerce: WooCommerce مثبت ومفعّل
ATUM: إضافة ATUM Inventory Management وملحق ATUM Multi-Inventory
WCPOS: WCPOS Pro — تعدد المتاجر ميزة من فئة Pro