نسخة تطويرية. موصّل Commerce متاح على نظام التطوير فقط. وهو ليس جزءًا من إصدار الإنتاج بعد، ولا تصفه وثائق الإنتاج.
كيف تتكامل الأجزاء
مخزون النظام هو المرجع الذي يبيع منه المتجر. بعد ربط المتجر وتفعيله يرسل النظام إلى المتجر رقم المتاح للبيع لكل منتج كلما تحرك المخزون، ولا يعود ممكنًا تعديل مخزون المتجر نفسه في Commerce. أما الطلبات التي تُقدَّم في المتجر فتأتي في إصدار لاحق. وإلى ذلك الحين لا تسجّل مبيعات المتجر ولا مرتجعاته في النظام يدويًا: يواصل Commerce طرح كل طلب بعد الربط، فتحتسب فاتورة النظام للبيع نفسه مرتين ويزداد النقص في العرض كل يوم؛ وحين تُعاد وحدة مرتجعة إلى المخزون في Commerce يعيدها Commerce إلى البيع بنفسه، وإيصال استلام في النظام للطرد نفسه يحتسبها مرتين.
يظهر الموصّل تحت المتاجر الإلكترونية في الشريط الجانبي (/commerce-connector) عند تفعيل الوحدة للشركة. يحتاج عرض القائمة إلى صلاحية Commerce.Link.Read؛ ويحتاج ربط متجر واختيار المستودعات والتفعيل إلى Commerce.Link.Manage، ويحتاج تشغيل مطابقة المنتجات إلى Commerce.Sync.Run. وهذه الصلاحيات على مستوى الشركة كلها: المستخدم المقيّد ببعض الفروع يرى مع ذلك مخزون كل مستودع مرتبط في صفحة الربط، ومن يجوز له إدارة الروابط يستطيع ربط أي مستودع للشركة.
انتقل إلى: قائمة المتاجر · قبل أن تبدأ · ١. الاتصال · ٢. المستودعات والمخزون الاحتياطي · ٣. مطابقة المنتجات · ٤. التفعيل · الحالات والمخزون المجمّد · صفحة الربط · خريطة المنتجات · عمليات التشغيل والفروقات · فك الربط وإعادته.
قائمة المتاجر
يظهر كل متجر مرتبط في بطاقة تعرض حالته، وسببها بالكلمات حين يحتاج إلى انتباه، وعنوان Commerce، ووقت آخر إرسال للمخزون، وعدد المنتجات المنتظرة للإرسال. وتنبّه شارتان إلى ما يستحق النظر: المخزون مجمّد (لا يستطيع أحد تغيير أرقام المتجر ولا يُرسل شيء؛ وتذكر البطاقة السبب وتذكر صفحة الربط طريقة الخروج) وأرقام عُدِّلت في Commerce (وجد الفحص الليلي أرقامًا غُيِّرت في Commerce من وراء ظهر النظام فصحّحها). والربط الذي ما زال قيد الإعداد يعرض متابعة الإعداد.
قبل أن تبدأ
- مفتاح للمتجر من Commerce. أنشئ في Commerce مفتاح API لهذا المتجر وحده، بصلاحية الوصول إلى المخزون والطلبات والمنتجات وخطافات الويب ولا شيء غيرها. يُرفض مفتاح حساب التاجر كله أو مفتاح بصلاحيات أكثر أو أقل، وتسمّي الرسالة المناطق.
- مستودع له جرد افتتاحي خاص به. يحتاج كل مستودع يجوز للمتجر البيع منه إلى جرد افتتاحي مرحَّل خاص به (المخزون ← تسوية المخزون). والمستودع الذي لم يُجرد قط يمنع التفعيل لأن النظام لا يستطيع أن يضمن رقمه.
- منتجات معلَّمة «معروض عبر الإنترنت». لا يُعرض على المتجر المرتبط إلا المنتجات الحاملة هذه العلامة؛ وتقرن المطابقة كل منها بمتغيّر المتجر الذي له رمز SKU نفسه.
- العملة نفسها. يجب أن يبيع المتجر بعملة الشركة. أما اختلاف الرقم الضريبي للمتجر عن رقم الشركة فمسموح متى قبلته.
١. الاتصال
اختر ربط متجر وأدخل عنوان Commerce الخاص بالمتجر والصق مفتاح API للمتجر ثم تحقق من المفتاح. لا يُكتب شيء بعد: تعرض الصفحة المتجر وعملته واسم المفتاح وتاريخ انتهاء المفتاح (في ذلك اليوم يرفضه Commerce ويتوقف وصول المخزون من النظام إلى المتجر، ما لم تستبدل المفتاح قبله) والرقمين الضريبيين، وهل سبق لهذه الشركة ربط المتجر (إعادة الربط تحفظ مطابقات المنتجات وعدّاد الطلبات). وإذا اختلف الرقمان الضريبيان فضع علامة في المربع للربط على أي حال. وإذا تغيّر أحدهما أثناء نظرك فتعرض الصفحة الرقمين الجديدين وتطلب العلامة من جديد.
يجب أن يكون عنوان Commerce من العناوين المسموح لهذا النظام بالاتصال بها، وإلا قالت الرسالة ذلك ولم يُرسل المفتاح قط. يسافر المفتاح مرة واحدة للتحقق منه ثم يُحفظ مشفّرًا، ولا يُعرض مرة أخرى، وينساه النموذج لحظة إنشاء الربط. ينشئ ربط هذا المتجر الربط في حالة قيد الإعداد. والربط لا يغيّر المتجر: يحتفظ بمخزونه الخاص إلى أن تفعّل.
٢. المستودعات والمخزون الاحتياطي
حدّد المستودعات التي يجوز للمتجر بيع مخزونها ورتّبها بحسب الشحن (تغيّر الأسهم الأولوية). يعرض كل مستودع شارة مجرود بتاريخ جرده الافتتاحي الخاص، أو لم يُجرد مع رابط إلى صفحة تسوية المخزون، وعدد المنتجات المقيسة فيه. والمخزون الاحتياطي يحجز هذا العدد من وحدات كل منتج: يرى المتجر المخزون المتاح مطروحًا منه الاحتياطي. يتطلب الحفظ مستودعًا واحدًا على الأقل وعددًا صحيحًا من 0. وإذا غيّر شخص آخر الربط في الأثناء فتُحمَّل أحدث نسخة وتحفظ من جديد.
٣. مطابقة المنتجات
يقرأ طابق المنتجات الآن كتالوج المتجر ويقرن كل منتج معلَّم «معروض عبر الإنترنت» بمتغيّر المتجر الذي له رمز SKU نفسه. ولا يغيّر شيئًا في المتجر. وتصنّف النتيجة كل منتج: مطابَق ومطابَق والمخزون غير متتبَّع (المتجر لا يتتبع مخزون ذلك المتغيّر) وملتبس (SKU على عدة متغيّرات أو منتجات) وفي النظام فقط (منتج معلَّم «معروض على الإنترنت» لا يطابقه أي صنف في المتجر) وفي Commerce فقط (صنف في المتجر لا يطابقه أي منتج معروض في النظام) ومتجاهَل ولا يمكن مطابقته ومنتج النظام غير نشط. ويُقرأ الكتالوج الكبير في الخلفية، وتتابعه الصفحة إلى أن ينتهي. وحفظ المستودعات من جديد يجعل آخر مطابقة قديمة، فشغّلها مرة أخرى.
٤. التفعيل
يسرد فحص التفعيل ما يجب أن يتحقق، كلًا بعلامة صح أو خطأ مع طريقة الإصلاح: مستودع مرتبط ونشط؛ ولكل مستودع مرتبط جرد افتتاحي خاص به؛ وتطابق العملتين؛ وقبول الفرق الضريبي؛ ومطابقة المنتجات بعد آخر تغيير في الإعدادات؛ ومعرفة النظام عنوانه العام؛ وتوفّر مكان في المتجر لخطاف الويب الخاص بالنظام؛ وإمكان سرد الطلبات التي تغيّرت مؤخرًا في المتجر كاملة؛ وألّا يكون فك ربط هذا المتجر لدى شركة أخرى ما زال يكتمل (ينتظر فك الربط نحو دقيقة آخر إرسال له قبل أن يعيد إلى المتجر مخزونه، فبعد دقيقة ينجح هذا الفحص).
وبعض الأمور يحتاج إلى تأكيدك الصريح:
- طلبات قد يظل رقم النظام يتضمنها. الطلبات المفتوحة، والطلبات التي تغيّرت منذ جرد المستودعات، قد لا تكون منعكسة بعد في مخزون النظام. تُسرد بوحداتها لكل SKU؛ فأكّد أنها محتسبة وإلا جاز أن يبيعها المتجر مرتين. وعند إعادة ربط متجر بعد فك الربط تظهر الطلبات التي وُضعت في الأثناء مجموعةً مستقلة مع تحذير من أن ما سجّلته منها يدويًا يُحتسب مرتين.
- متغيّرات لا يتتبع Commerce مخزونها. فعّل التتبع في Commerce قبل التفعيل؛ فحين يصبح النظام مصدر المخزون يرفض Commerce تغيير التتبع إلى أن تستعيد المخزون. وكما هي مؤكَّدة تُباع بعد التفعيل دون حد.
- يصحّ التأكيد لما سُرد بالضبط. فإن سردت مطابقة لاحقة، أو مستودع جُرد قبل ذلك، أو طلب تغيّر، أكثر مما سُرد فيطلب الفحص التأكيد من جديد، حتى بعد محاولة فشلت.
- متغيّرات لن يرسلها النظام تُسرد للعلم فقط (غير مطابقة أو متجاهَلة أو ملتبسة أو غير نشطة أو غير معروضة عبر الإنترنت). يتجمد مخزونها: لا يستطيع أحد تعديله في Commerce، وتظل المبيعات والإلغاءات تحرّكه.
يبقى زر تفعيل معطّلًا إلى أن ينجح كل فحص وتُؤكَّد كل الإقرارات. ثم يحوّل مصدر مخزون المتجر إلى النظام، ويسجّل خطاف ويب متوقفًا، ويرسل الأرقام الأولى قبل أن تجيب الصفحة: تذكر النتيجة كم منتجًا أُرسل وكم يتبعها خلال دقائق. ثم يعرض العودة إلى المتاجر الربط نشطًا.
الحالات والمخزون المجمّد
الربط إما قيد الإعداد أو نشط أو يحتاج إلى انتباه أو المفتاح مرفوض أو غير مرتبط. حين يصبح مستودع مرتبط غير نشط أو يفقد جرده يواصل الربط الإرسال لكنه يعرض ذلك المستودع بقيمة 0 إلى أن يُصلح. وحين يُرفض المفتاح، أو يبدأ نظام آخر بإرسال المخزون، أو يرفض Commerce الأرقام، لا يُرسل شيء ويكون المخزون مجمّدًا: تذكر البطاقة السبب وتذكر صفحة الربط طريقة الخروج، ومنها استرجاع المخزون في Commerce (Integrations → Inventory source → Commerce). وحين يُعاد المتجر إلى مخزونه الخاص في Commerce لا يُرسل شيء أيضًا، لكن المخزون ليس مجمّدًا: يستطيع التاجر تعديله في Commerce من جديد، ويعرض الربط يحتاج إلى انتباه إلى أن يُعاد النظام مصدرًا للمخزون. وتُعلَن كل حالة كهذه أيضًا لمن يملك إدارة الروابط، مرة في اليوم ما دامت قائمة. ويفتح الإشعار صفحة الربط.
صفحة الربط
افتح متجرًا من القائمة (أو من إشعار) لتراه كاملًا. يذكر أعلى الصفحة الحالة وسببها بالكلمات. وعندما يكون مخزون المتجر مجمّدًا يظهر شريط أحمر يقول ذلك وما يجب فعله، ويكون زر المخرج تحته مباشرة:
- المفتاح مرفوض (رفض Commerce المفتاح المخزّن، أو تعذّر على هذا الخادم قراءته): اضغط استبدل المفتاح والصق مفتاحًا جديدًا للمتجر نفسه. لا يُمسّ المفتاح القديم، فألغِه في Commerce بعد ذلك. يُفحص المفتاح الجديد ويُرسل مرة واحدة وتنساه الصفحة.
- رفض Commerce الأرقام (لعدة منتجات معًا)، أو أُعيد المتجر إلى مخزونه الخاص: بعد أن تتحقق من إعداد المتجر اضغط اجعل النظام مصدر المخزون من جديد (يسأل أولًا).
- نظام آخر يرسل المخزون، أو استُعيدت قاعدة بيانات الشركة: أوقف النظام الآخر ثم استأنف الإرسال (يسأل أولًا). يعيد النظام ضبط تسلسلات الإرسال الخاصة بالمتجر ويرسل كل الأرقام من جديد.
- لم يعد النظام يسمح بعنوان المتجر: اطلب من مدير النظام أن يسمح به من جديد.
- وفي كل الحالات يمكنك بدلًا من ذلك أن تسترد المخزون في Commerce (Integrations ← Inventory source ← Commerce).
إذا كان مستودع مرتبط غير نشط أو بلا جرد خاص به فيواصل المتجر البيع، لكن من مخزون المستودعات النشطة التي جرى جردها فقط؛ ويقول سطر السبب ذلك. ويعرض شريط أصفر الموضع الذي توقف عنده عدّاد الطلبات (رقم الطلب، وهل وصل إلى النظام، ومنذ متى): كل طلب لاحق يخصمه Commerce فعلًا، فيعرض المتجر مخزونًا أقل مما يمكنه إلى أن تُحل المشكلة.
الأزرار: أرسل الآن يرسل المنتظر ويُخرج المنتجات من الحجر (يحتاج Commerce.Sync.Run)؛ طابق الآن يقارن كل رقم في المتجر برقم النظام. ويسأل كلاهما Commerce أولًا إن كان المتجر ما زال يأخذ مخزونه من النظام: فإن استرجعه التاجر لم يُكتب فوقه شيء، وإن تعذّرت قراءة رد Commerce لم يُرسل شيء إلى أن تمكن قراءته (وتمتنع الدورات التلقائية والمطابقة الليلية بالطريقة نفسها، وتعرض النظرة العامة ذلك على أنه ما توقفت عنده الدورة الأخيرة، ويُبلَّغ من يديرون الروابط إذا استمر ثلاث دورات متتالية)؛ طابق المنتجات يقرأ الكتالوج من جديد؛ استبدل المفتاح؛ وفك الربط. ويجيب كل منها في الصفحة بجملة. وما دام الربط لا يستطيع إرسال المخزون (مفتاح مرفوض، أو متجر استرجع مخزونه، مثلًا) يُعطَّل أرسل الآن وطابق الآن وتقول الصفحة ذلك، ويظهر السبب فوقهما. ويفتح المفتاح المرفوض نموذج استبدال مفتاح المتجر من تلقاء نفسه، ولا يراه إلا من يجوز لهم إدارة الروابط. ولدقيقة أو دقيقتين بعد التفعيل تقول الصفحة إن المتجر يجري تحويله بدلًا من أن التفعيل لم يكتمل. وتحت نظرة عامة الوقائع (آخر إرسال، وآخر فحص، وعدّاد الطلبات، وآخر مطابقة شاملة، وما توقفت عنده الدورة الأخيرة) والإعدادات: المستودعات التي يجوز للمتجر البيع منها بترتيب الشحن، والمخزون الاحتياطي. وإذا حفظ غيرك الإعدادات قبلك حمّلت الصفحة الإصدار الأحدث وأبقت اختياراتك لتحفظ من جديد.
خريطة المنتجات
يسرد تبويب المنتجات كل صنف في المتجر (وكل منتج معروض في النظام بلا صنف) مع حالته، في تبويبات لكل منها عدّاده: مطابَقة، ومحجوزة للتحقق، ومخزون غير متتبَّع، وغير معروضة (أُطفئ «معروض على الإنترنت»)، وفي الحجر (رفض Commerce رقم المنتج وحده وستُعاد المحاولة)، وملتبسة، وفي النظام فقط (منتج معروض في النظام بلا صنف في المتجر)، وفي Commerce فقط (صنف في المتجر لا يملكه أي منتج معروض في النظام: يظهر هنا زر تجاهل)، ومتجاهَلة، ولا يمكن مطابقتها، ومنتج النظام غير نشط. ويذكر سطر تحت التبويبات عدد المنتجات التي لم يقِسها بعدُ أي مستودع مجرود، كما وجدته آخر مطابقة شاملة. ابحث برمز SKU؛ والقائمة مقسّمة إلى صفحات وتذكر دائمًا عدد عناصرها.
يعرض كل صف آخر رقم أُرسل والرقم الذي طبّقه Commerce والنتيجة بالكلمات. ولماذا هذا الرقم؟ يفتح تعليل النظام: ما كان سيعرضه على الإنترنت الآن، والمخزون الاحتياطي المحجوز، وكل مستودع مرتبط مع المتوفر فيه والمحجوز، وسبب عدم احتساب مستودع (ليس مستودعًا لهذه الشركة، أو غير نشط، أو بلا جرد افتتاحي خاص به، أو لم يُقَس لهذا المنتج بعد). ومن هناك يمكنك تحديد مخزون احتياطي لهذا المنتج (يتقدم على مخزون الربط؛ ومسحه يعيد استخدام مخزون الربط). ومعروض على الإنترنت يشغّل منتجًا مطابَقًا أو يطفئه لهذا المتجر: وإطفاؤه يرسل إلى المتجر صفرًا له. وتجاهل يبعد صنفًا في المتجر لا يملكه النظام؛ وأوقف التجاهل يعيده. «المعروض» والمخزون الاحتياطي يخصّان منتج النظام، لذلك ينطبق التغيير على كل صفوفه. ويحتاج أي تغيير إلى Commerce.Link.Manage.
محجوزة للتحقق. المنتج الذي يُطابَق بعد تفعيل المتجر (منتج عُلِّم حديثًا «معروض على الإنترنت»، أو SKU ملتبس أُصلح، أو منتج أُعيد تنشيطه) لا يُعرض فورًا: فقد تشمله طلبات سابقة للربط، وCommerce لا يطرحها أبدًا. وخلال دقائق يقرأها النظام؛ فإن لم يشمله أي منها عُرض من تلقاء نفسه، وإلا بقي محجوزًا وقال الصف ذلك. وتشغيل معروض على الإنترنت يعرض تلك الطلبات بوحداتها، ولا يعرض المنتج إلا بعد أن تؤكد قبولها (سجّلها في النظام أولًا إن لم تكن مسجّلة). والصنف الذي لا يتتبع Commerce مخزونه يُحجز بالطريقة نفسها إلى أن تؤكد أنه يُباع بلا حد. ويُبلَّغ من يديرون الروابط مرة في اليوم ما دام شيء محجوزًا.
عمليات التشغيل والفروقات
يسرد تبويب عمليات التشغيل والفروقات ما فعله النظام للمتجر، من الأحدث: مطابقات المنتجات والمطابقات الشاملة وفحوص الطلبات وفحوص حركات المخزون، لكل منها حالته وسبب فشله إن فشل. افتح مطابقة المنتجات لترى فئاتها. وافتح مطابقة شاملة لترى عدد المنتجات في كل فئة ونتيجة فحص المصدر والفروقات: أرقامًا وُجدت مختلفة في المتجر. ويذكر كل صف ما حدث: عُدّل في Commerce (غيّر أحدهم الرقم بين إرسالَين من النظام)، أو مستحق الإرسال أصلًا (كان تغيير النظام نفسه على وشك أن يُرسل)، أو تغيّر دون حركة في النظام. ويعيد النظام رقمه الخاص لكل منها. عدّل المخزون في النظام لا في Commerce ما دام النظام مصدر مخزون المتجر. وتعرض العملية 1000 صف على الأكثر وتذكر عدد ما وُجد. وتُبلغ أي مطابقة شاملة مكتملة (الليلية أو طابق الآن) من يديرون الربط مرة في اليوم عند وجود أرقام عُدّلت في Commerce أو تغيّرت دون حركة في النظام.
وتفتح هذه الصفحة إشعارات أخرى كذلك: ربط متعثّر (عدة دورات متتالية تتوقف بالطريقة نفسها)، وكلمة نتيجة لا يعرفها النظام من Commerce (الموصّل أقدم من Commerce ويجب تحديثه)، وفك ربط قطعته إعادة تشغيل فأكمله النظام بنفسه، ومنتجات محجوزة للتحقق (تفتح تبويب المنتجات)، وربط حُرِّر لشركة أخرى (انظر أدناه).
فك الربط وإعادته
فك الربط يسأل أولًا ويذكر ما سيحدث: يتوقف النظام عن الإرسال، وينتظر ما هو قيد الإرسال، ويعيد إلى المتجر مخزونه (ليمكن تعديله في Commerce من جديد)، ويزيل الـ webhook وينسى المفتاح. وقد يستغرق حتى دقيقة. ألغِ مفتاح API في Commerce بعد ذلك. وإن تعذّر إعادة المخزون (لم يرد Commerce أو تعذّرت قراءة المفتاح) فتطلب الصفحة أن تستعيده في Commerce. وفك الربط الذي قطعته إعادة تشغيل يعرض إكمال فك الربط.
تبقى مطابقات المنتجات وعدّاد الطلبات وإعدادات المستودعات، لذلك فإن ربط هذا المتجر من جديد (من صفحة المتجر المفكوك ربطه، أو عبر ربط متجر) بمفتاح جديد يعيد الربط نفسه: ويقول المعالج ذلك، ويبدأ عمرًا جديدًا بإقرارات جديدة.
للمتجر ربط حيّ واحد في كل مرة بين جميع شركات هذا النظام. فإن كان ربط شركة أخرى يحجزه لكنه لم يحوّل المتجر قط إلى مخزون النظام (تجربة انتهت، أو إعداد لم يكمله أحد قبل أن يصل تفعيله إلى المتجر)، فألغِ مفتاح ذلك الربط في Commerce: يحرّر ربط متجر التالي بمفتاح صالح الربطَ القديم ويُبلغ تلك الشركة. أما الربط الذي قد يكون حوّل المتجر، ومنه ما توقف تفعيله في منتصفه (يظهر «التفعيل غير مكتمل»)، فلا يُحرَّر بهذه الطريقة؛ تفكّه شركته نفسها، وإن كان مفتاحه ملغى أصلًا فالمخرج أن تستعيد المخزون في Commerce. ويُرفض مسح بيانات الشركة ما دام ربط قد يكون حوّل متجره؛ ويُرفض إلغاء تنشيط الشركة أو حذفها وإلغاء تثبيت الموصّل لأي ربط لم يُفك كاملًا، ولو لم يُفعَّل قط. فك الربط أولًا ليستعيد المتجر مخزونه ويغادر المفتاح النظام.