استيراد المنتجات وتحديثها باستخدام جدول بيانات#

نزّل قالب الفئة، وأدخل بيانات منتجاتك، ثم ارفعه في الكتالوج. يمكنك تنفيذ هذه الخطوات دون كتابة شيفرة أو استخدام بيانات اعتماد API.

قبل أن تبدأ#

اختر المتجر الصحيح في لوحة التحكم. يجب أن تكون لديك صلاحية تعديل كتالوجه. إذا لم يظهر زر تحميل جدول بيانات المنتج، فتحقق من المتجر المحدد، وصلاحية الكتابة في الكتالوج، وما إذا كان حسابك مخصصًا للقراءة فقط.

تنزيل قالب الفئة#

1. افتح لوحة التحكم ← الكتالوج.
2. انقر تحميل جدول بيانات المنتج لفتح مربع حوار استيراد المنتجات.
3. ضمن اختر فئة المنتج، حدد الفئة التي تريد استيرادها. تعتمد الخيارات على إعدادات متجرك.
4. انقر تنزيل قالب إكسل. استخدم قالبًا وملف رفع منفصلين لكل فئة.

نزّل قالبًا جديدًا عند إعداد كل عملية استيراد لتتوافق أعمدته مع المتطلبات الحالية للفئة. المصنف الذي تنزّله هو قالب، وليس تصديرًا لكتالوجك الحالي.

تعبئة المصنف#

استخدم أوراق العمل في المصنف كما يلي:

يحتاج كل صف منتج إلى sku وname وimage_url وproduct_url، بالإضافة إلى الأبعاد المطلوبة لفئته. اتبع علامات الحقول المطلوبة والتعليمات في القالب المنزّل. لا تترجم أسماء الحقول، ولا تضف أعمدة غير معروفة أو مكررة.

• احتفظ بخلايا SKU بتنسيق نصي حتى لا يحذف برنامج جداول البيانات الأصفار البادئة أو يغيّر المعرّفات الطويلة. استخدم صفًا واحدًا لكل SKU؛ تُرفض القيم المكررة داخل الملف نفسه، بما فيها القيم التي تختلف فقط في حالة الأحرف.
• استخدم عنوان صورة مباشرًا ومتاحًا للعامة عبر HTTP أو HTTPS في image_url؛ يجب أن يعمل دون تسجيل دخول أو ملفات تعريف ارتباط أو رؤوس طلب مخصصة. ضع عنوان صفحة تفاصيل المنتج في product_url.
• حدد الأبعاد والوحدات وفقًا لتعليمات القالب. إذا لم تُحدَّد وحدة في البُعد أو في dimension_unit، فستُستخدم in افتراضيًا.
• اختر قيمة status من القيم المقبولة في Enums. إذا تركته فارغًا، فستُستخدم active افتراضيًا؛ حدده صراحةً عند تحديث المنتجات.

احفظ الملف بصيغة .xlsx (موصى بها). تُقبل أيضًا صيغة .csv إذا احتوت فقط على صف عناوين المنتجات والبيانات. ملفات .xls القديمة غير مدعومة. يمكن أن يحتوي كل ملف على ما يصل إلى 50,000 صف منتج غير فارغ، وألا يتجاوز حجمه 50 MB.

رفع الملف والتحقق من النتيجة#

1. ارجع إلى مربع حوار الاستيراد وحدد الفئة نفسها التي استخدمتها للقالب.
2. ضمن أكمل وقم بتحميل، اختر الملف المحفوظ، ثم انقر بدء الاستيراد.
3. راجع الواردات الأخيرة لمعرفة اسم الملف وحالة المعالجة وأعداد الصفوف الناجحة والفاشلة. يؤكد الإرسال قبول الملف؛ وتستمر المعالجة في الخلفية.
4. انتظر انتهاء المعالجة وتحقق من الصفوف الفاشلة حتى إذا كانت حالة المهمة مكتمل. ارجع إلى الكتالوج للتحقق من بيانات المنتجات المستوردة وجاهزيتها.

إذا فشلت صفوف، فانقر فشل الملف، وافحص رسائل الخطأ، وصحح بيانات المنتجات، ثم ارفع الملف المصحح مع تحديد الفئة نفسها. يحتوي مصنف الأخطاء المنزّل على الصفوف الفاشلة وأعمدة التشخيص؛ ويتم تجاهل أعمدة التشخيص هذه عند إعادة الرفع.

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

تحديث المنتجات الحالية#

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

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

بعد انتهاء المهمة، تحقق من المنتجات المعنية في الكتالوج. لا يثبت نجاح الاستيراد وحده ظهور المنتجات في واجهة المتجر؛ تحقق من جاهزيتها ومن قائمة التحقق من إطلاق SDK.

أتمتة الاستيراد#

للمزامنة المتكررة من جانب الخادم، استخدم Product Import API. تُوثَّق حقول طلباته وحدوده وسلوك التحديث الجزئي فيه بصورة منفصلة عن خطوات الاستيراد بجدول البيانات.