إصلاح أخطاء استيراد الحقول الوصفية لمنتجات Shopify

تفشل عمليات استيراد الحقول الوصفية غالبًا بسبب تعريف غير مطابق، أو قيمة لا توافق النوع، أو صف منتج لا يحتوي الأعمدة اللازمة.

خطأ Shopify: Validation failed: Value must be a valid product reference

يعرض Shopify هذه الرسالة عندما يشير حقل تعريف مرجعي لمنتج إلى منتج غير موجود بعد في المتجر. استورد المنتجات المشار إليها أو أنشئها أولًا، ثم أعد استيراد قيم حقول التعريف. يسرد Shopify الرسالة نفسها في دليل استكشاف أخطاء استيراد CSV للمنتجات.

أصلح namespace وkey

يجب أن يصبح كل عنوان بصيغة product.metafields.<namespace>.<key>. استخدم الحروف والأرقام والشرطات والشرطات السفلية فقط والتزم بحدود الطول.

أصلح القيم حسب النوع

يجب أن توافق قيم boolean والتواريخ والأرقام وURL والقياسات صيغة النوع المحدد. تُفصل عناصر القوائم بفاصلة منقوطة ويجب ألا تتجاوز الحد الموثق.

إذا أظهر Shopify قاعدة إضافية، فراجع تعريف الحقل في المتجر؛ فالخيارات وregex وحدود min/max المخصصة ليست جزءًا من CSV.

راجع أعمدة المنتج والعناوين المكررة

للتحديثات أبقِ Title وURL handle (أو Handle المتوافق). ولا تربط عمودَي مصدر بعنوان إخراج واحد.

أعد الفحص بعد كل تصحيح

يفحص preflight الملف كاملًا ويحافظ على الأعداد الإجمالية الدقيقة. نزّل CSV جديدًا فقط بعد زوال المشكلات المانعة.

أصلح CSV للحقول الوصفية

شاهد التحويل

تتحول العناوين المربكة إلى أعمدة جاهزة للاستيراد.

أعد تسمية الأعمدة التي تحتاجها مع إبقاء كل قيمة تحت العنوان الصحيح.

cust_idcustomer_id

given_namefirst_name

mailemail

✓ تبقى القيم في العمود الصحيح