صدّرت 400 منتج، وعدّلت جدول البيانات لساعتين، ثم ضغطت على الاستيراد. فيعرض شوبيفاي قائمة طويلة من الأخطاء باللون الأحمر. هكذا تعرّفت عن كثب على أخطاء استيراد CSV في شوبيفاي.
الأمر يتجاوز الإحباط. كل ساعة تمر من دون أن تكون منتجاتك منشورة تعني مبيعات ضائعة. إليك ما يحدث، وكيف تُوقفه.
🎯 ملخص سريع
- معظم الأخطاء مصدرها رؤوس أعمدة خاطئة، وترميز ملف غير صحيح، ومعرّفات handle خاطئة أو مكررة
- ابدأ دائماً من ملف 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»). يجب أن يكون فريداً ومكتوباً بأحرف صغيرة مع شرطات. الـ handles المكررة قد تستبدل منتجات موجودة بدلاً من إنشاء منتجات جديدة، وكل صفوف المنتج نفسه تحتاج الـ handle نفسه تماماً.
حين لا يعمل استيراد CSV في شوبيفاي، تستحق هذه المشكلات الصغيرة الفحص أيضاً:
- الأسعار مكتوبة بصيغة «$29.99» بدلاً من «29.99» (لا رموز عملة مسموح بها)
- التواريخ ليست بتنسيق ISO 8601 (YYYY-MM-DD HH:MM:SS)
- صفوف فارغة زائدة أو أعمدة مخفية تركتها تصفية Excel
- صفوف متغيرات بلا قيمة Handle حين يملك المنتج خيارات متعددة
إن كنت تنقل متجرك من منصة أخرى، فإن تصدير نظامك القديم نادراً ما يُطابق تنسيق شوبيفاي مباشرة. فمن المفيد أن تقرأ دليل التحقق قبل الانتقال قبل أن تفتح جدول البيانات.
🔧 كيف تنظّف الملف كي يُستورد من أول مرة
جاهز لإصلاح استيراد منتجاتك في شوبيفاي؟ ينظّف فريق CartWorks ملفك ويصلح أخطاءه ويستورده لك، فتصل منتجاتك بشكل صحيح من المرة الأولى.
إصلاح الترميز:
- إن كنت مضطراً لاستخدام Excel، اختر «CSV UTF-8 (Comma delimited)» عند الحفظ، لا خيار «CSV» العادي.
إصلاح الـ Handles. يحتاج كل منتج إلى handle نظيف وفريد بأحرف صغيرة وشرطات، وأي handle يحتوي علامات ترقيم أو أرقاماً يحتاج إلى مراجعة للتأكد من عدم تكراره.
بالنسبة للمنتجات ذات المتغيرات، كل صف ينتمي للمنتج ذاته يحتاج نفس قيمة Handle بالضبط. أعمدة Title وBody وVendor والصور لا تحتاج إلى ملء إلا في الصف الأول لذلك الـ handle. صفوف المتغيرات التالية يمكن تركها فارغة.
💡 نصيحة: استورد دفعة اختبارية من 5 إلى 10 منتجات أولاً. اكتشف مشكلات التنسيق قبل أن ترفع 2,000 صف ثم تجد 400 خطأ.
| الخطأ | ما المشكلة | الحل |
|---|---|---|
| اسم عمود غير معروف | حالة أحرف الرأس أو تهجئته لا تطابق شوبيفاي | انسخ الرؤوس من CSV النموذجي لشوبيفاي |
| رموز غريبة بدل الأحرف | الملف محفوظ بصيغة خاطئة | أعد التصدير من Google Sheets أو أعد الحفظ بترميز UTF-8 |
| منتجات موجودة تُستبدل | قيم handle مكررة في ملفك | راجع الـ handles وتأكد أن كلاً منها فريد |
| المتغيرات لا تتجمع صحيحاً | Handle مفقود أو مختلف في صفوف المتغيرات | انسخ handle المنتج الأصلي إلى كل صف متغير |
| عمود السعر مرفوض | رمز عملة في خلية السعر | أرقام فقط: 29.99 لا $29.99 |
للمتاجر التي تضم أكثر من بضع مئات من المنتجات، تتراكم هذه الحالات بسرعة. يوضّح دليل التعديل الجماعي للكتالوجات الكبيرة في شوبيفاي متى يبدأ العمل بجداول البيانات في استهلاك وقت أكثر مما يوفّره.
🔧 الاستيراد يُسبّب لك صداعاً؟
تتولى CartWorks مطابقة بياناتك مع تنسيق شوبيفاي وتنظيفها واستيرادها كجزء من بناء المتجر أو الانتقال. أخبرنا بما لديك وسنلقي نظرة.
🚀 متى تستحق الاستعانة بخبير
لمتجر نظيف بـ 50 منتجاً، يمكنك إصلاح الاستيراد في بضع ساعات بالخطوات أعلاه. أما مع كبر الحجم، فتتضاعف الحالات الاستثنائية.
أرقام SKU مكررة مختبئة في البيانات القديمة. صور تحتاج إعادة استضافة قبل إدراجها في CSV. حقول Metafields غير موجودة في تنسيق شوبيفاي القياسي. ومنتجات بـ 100 متغير يكفي فيها خطأ إملائي واحد في الـ handle لإفساد المنتج كله. العمل على الملف يتحول من دون أن تلاحظ إلى مشروع كامل.
تتولى CartWorks استيراد بيانات المنتجات ضمن بناء المتاجر والانتقال. نطابق بياناتك مع تنسيق شوبيفاي، نُجري استيراداً تجريبياً بدفعة صغيرة، ثم نُنجز الاستيراد الكامل بعد التأكد من الهيكل. يمكننا أيضاً إعداد عملية استيراد قابلة للتكرار إن كنت تُضيف منتجات بالجملة بصفة منتظمة.
إن كان الكتالوج هو ما يؤخر إطلاق متجرك، أرسل لنا رسالة سريعة وسنحدد معك ما يلزم.
