صدّرت 400 منتج، وعدّلت جدول البيانات لساعتين، ثم ضغطت على الاستيراد. فإذا بشوبيفاي تُقذفك بجدار من النصوص الحمراء. هكذا تعرّفت عن كثب على أخطاء استيراد CSV في شوبيفاي.
الأمر يتجاوز الإحباط. كل ساعة تمر بلا منتجات على الهواء تعني مبيعات ضائعة. إليك ما يحدث فعلاً، وكيف تُوقفه.
🎯 ملخص سريع
- معظم الأخطاء مصدرها رؤوس أعمدة خاطئة، ترميز ملف غير صحيح، وhandles معطوبة أو مكررة
- ابدأ دائماً من ملف CSV النموذجي الخاص بشوبيفاي، لا من جدول بيانات فارغ
- احفظ الملف بترميز UTF-8 (Google Sheets يفعل ذلك تلقائياً عند التصدير)
- يجب أن تكون الـ handles فريدة، بأحرف صغيرة، ومفصولة بشرطة دون أحرف خاصة
- بالنسبة للكتالوجات الكبيرة أو المعقدة، تظهر مشكلات البيانات المخفية دائماً عند الاستيراد
⚠️ أبرز أخطاء استيراد CSV في شوبيفاي
تنسيق CSV في شوبيفاي صارم. خلية واحدة خاطئة قد ترفض الملف بالكامل. هذه العوامل الثلاثة هي مصدر الغالبية العظمى من أخطاء استيراد CSV في شوبيفاي.
رؤوس أعمدة خاطئة. تتوقع شوبيفاي أسماء بعينها: "Title"، "Body (HTML)"، "Vendor"، "Variant Price". غيّر حالة الأحرف، أضف مسافة، أو استخدم مرادفاً، وسيصبح العمود غير مرئي. بياناتك لن تذهب إلى أي مكان.
ترميز الملف. يحفظ Excel الملفات بترميز Windows-1252 افتراضياً. أما شوبيفاي فتريد UTF-8. أي حرف خارج نطاق ASCII الأساسي (حروف مُعلَّمة، نص عربي، علامات ترقيم خاصة) يتحول إلى رموز مشوّهة. المنتجات التي تحتوي "Café" في العنوان تظهر كـ "Café"، أو يفشل الاستيراد برسالة خطأ غامضة لا تفيدك بشيء.
مشكلات الـ Handle. عمود Handle هو المعرّف الداخلي للمنتج في شوبيفاي. يجب أن يكون فريداً، بأحرف صغيرة كلها، ومفصولاً بشرطات. "Red T-Shirt" يجب أن يصبح "red-t-shirt". الـ handles المكررة تُلغي المنتجات الموجودة بصمت بدل إنشاء جديدة. وغياب الـ handle في صفوف المتغيرات يُفكّك المنتجات متعددة الخيارات، لأن كل صف متغير للمنتج ذاته يحتاج نفس قيمة الـ handle تماماً.
حين لا يعمل استيراد CSV في شوبيفاي، تستحق هذه المشكلات الصغيرة الفحص أيضاً:
- الأسعار مكتوبة بصيغة "$29.99" بدلاً من "29.99" (لا رموز عملة مسموح بها)
- التواريخ ليست بتنسيق ISO 8601 (YYYY-MM-DD HH:MM:SS)
- صفوف فارغة زائدة أو أعمدة مخفية تركتها تصفية Excel
- صفوف متغيرات بلا قيمة Handle حين يملك المنتج خيارات متعددة
إن كنت تنقل متجرك من منصة أخرى، فإن تصدير نظامك القديم نادراً ما يُطابق تنسيق شوبيفاي مباشرة. يستحق دليل التحقق قبل الترحيل القراءة قبل أن تفتح جدول البيانات.
🔧 كيف تنظّف الملف كي يُستورد من أول مرة
جاهز لإصلاح استيراد منتجاتك في شوبيفاي؟ ابدأ من هنا: نزّل ملف CSV النموذجي من شوبيفاي. اذهب إلى المنتجات في لوحة التحكم، اضغط استيراد، وحمّل الملف النموذجي. ابنِ بياناتك داخل هذا الهيكل. لا تحاول أن تجعل شوبيفاي تتوافق مع هيكلك أنت. هذا لا ينتهي بخير أبداً.
إصلاح الترميز:
- تجنّب Excel تماماً. الصق بياناتك في Google Sheets وصدّرها بصيغة CSV. UTF-8 افتراضياً، دون أي إعدادات إضافية.
- إن كنت مضطراً لاستخدام Excel، اختر "CSV UTF-8 (Comma delimited)" عند الحفظ، لا خيار "CSV" العادي.
- للملفات الكبيرة، افتح CSV في VS Code أو Notepad++ وتأكد أن الترميز في شريط الحالة يظهر UTF-8.
إصلاح الـ Handles. احذف الأحرف الخاصة، استبدل المسافات بشرطات، واجعل كل شيء بأحرف صغيرة. في Google Sheets، الصيغة =LOWER(SUBSTITUTE(A2," ","-")) تحلّ معظم الأمر. راجع يدوياً أي شيء يحتوي علامات ترقيم أو أرقاماً قد تنشئ تكراراً.
بالنسبة للمنتجات ذات المتغيرات، كل صف ينتمي للمنتج ذاته يحتاج نفس قيمة Handle بالضبط. أعمدة Title وBody وVendor والصور لا تحتاج ملءً إلا في الصف الأول لذلك الـ handle. صفوف المتغيرات التالية يمكن تركها فارغة.
💡 نصيحة احترافية: استورد دفعة اختبارية من 5 إلى 10 منتجات أولاً. اكتشف مشكلات التنسيق قبل أن تدفع 2,000 صف وتعود لتجد 400 خطأ.
| الخطأ | ما المشكلة | الحل |
|---|---|---|
| اسم عمود غير معروف | حالة أحرف الرأس أو تهجئته لا تطابق شوبيفاي | انسخ الرؤوس من CSV النموذجي لشوبيفاي |
| رموز مكان أحرف | الملف محفوظ بترميز Windows-1252 لا UTF-8 | أعد التصدير من Google Sheets أو أعد الحفظ بترميز UTF-8 |
| منتجات موجودة تُستبدل | قيم handle مكررة في ملفك | راجع الـ handles وتأكد أن كلاً منها فريد |
| المتغيرات لا تتجمع صحيحاً | Handle مفقود أو مختلف في صفوف المتغيرات | انسخ handle المنتج الأصلي إلى كل صف متغير |
| عمود السعر مرفوض | رمز عملة في خلية السعر | أرقام فقط: 29.99 لا $29.99 |
للمتاجر التي تضم أكثر من بضع مئات من المنتجات، تتراكم هذه الحالات بسرعة. يوضّح دليل التعديل الجماعي للكتالوجات الكبيرة في شوبيفاي متى يبدأ العمل بجداول البيانات في أكل وقتك أكثر مما يوفّره.
🔧 الاستيراد يُسبّب لك صداعاً؟
تتولى CartWorks تعيين بياناتك وتنظيفها واستيرادها كجزء من بناء المتجر أو الترحيل. أخبرنا بما لديك وسنلقي نظرة.
🚀 متى يستحق الأمر طلب المساعدة
لمتجر نظيف بـ 50 منتجاً، يمكنك إصلاح الاستيراد في بضع ساعات بالخطوات أعلاه. أما كلما كبر الحجم، كلما تضاعفت الحالات الاستثنائية.
رموز SKU مكررة دفينة في البيانات القديمة. صور تحتاج إعادة استضافة قبل إدراجها في CSV. حقول Metafields غير موجودة في تنسيق شوبيفاي القياسي. منتجات بـ 100 متغير تكفي فيها خطأ إملائي واحد في الـ handle لتحطيم المجموعة كلها. العمل على الملف يتحول بصمت إلى مشروع كامل.
تتولى CartWorks استيراد بيانات المنتجات ضمن بناء المتاجر والترحيل. نُعيّن بياناتك على تنسيق شوبيفاي، نُجري استيراداً تجريبياً بدفعة صغيرة، ثم نُنجز الاستيراد الكامل بعد التأكد من الهيكل. يمكننا أيضاً إعداد عملية استيراد قابلة للتكرار إن كنت تُضيف منتجات بالجملة بصفة منتظمة.
إن كان الكتالوج هو ما يقف بينك وبين متجر مباشر، أرسل لنا رسالة سريعة وسنحدد معك ما يلزم فعلاً.
