ما هو الاستيراد بملف CSV؟
ملف CSV (قِيَم مفصولة بفواصل) هو طريقة سريعة لإضافة عدد كبير من المنتجات إلى متجر Storeino دفعة واحدة، مع كل تفاصيلها — السعر، الكمية، الصور، الأوصاف.
تستطيع توليد هذا الملف من Excel أو Google Sheets أو من منصة أخرى، ثم رفعه مرّة واحدة. النظام يتعرّف على الأعمدة تلقائيًا ويربطها بحقول المنتج.
الأعمدة في ملف CSV
الجدول التالي يوضّح كل عمود متاح، أيها إلزامي، وما القيمة المتوقّعة. الأعمدة الفارغة تُملأ بقيم افتراضية تلقائيًا حين يكون ذلك ممكنًا.
| العمود | الحالة | الوصف والمثال |
|---|---|---|
name | إلزامي | اسم المنتج كما سيظهر في المتجر. حقل إلزامي ولا يجوز تركه فارغًا. مثال Sneakers Pro Edition |
salePrice | إلزامي | سعر البيع للمنتج. أدخل الرقم فقط بدون رمز عملة. مثال 9.99 |
comparePrice | اختياري | السعر قبل التخفيض، يظهر مشطوبًا بجانب السعر الحالي. أدخل الرقم فقط. مثال 19.99 |
quantity | إلزامي | عدد القطع المتوفّرة في المخزون. القيمة الافتراضية إذا تُرك فارغًا هي صفر. مثال 120 |
images | اختياري | روابط صور المنتج. لإضافة عدّة صور، افصلها بحرف |. مثال https://example.com/a.png|https://example.com/b.jpg |
status | اختياري | هل المنتج منشور أم مسودّة؟
|
body | اختياري | الوصف الكامل للمنتج. يقبل صياغة HTML للتنسيق. |
description | اختياري | وصف قصير (حتى 200 حرف) يظهر في بطاقات المنتج وقوائم البحث. |
tags | اختياري | وسوم مفصولة بفواصل تساعدك في تنظيم المنتجات داخل المتجر. مثال tag1, tag2, tag3 |
type | اختياري | نوع المنتج. استخدم "variable" للمنتجات ذات المتغيّرات (اللون، المقاس…)، واتركه فارغًا للمنتج البسيط.
|
options | اختياري | يحدّد خيارات المتغيّرات وقيمها. الصيغة: الاسم: قيمة1، قيمة2؛ الاسم2: قيمةأ، قيمةب. مثال color: red, blue; size: S, M, L |
variant.weight | اختياري | الوزن (بالكيلوغرام) الخاص بصف هذا المتغيّر، يُستخدم في الشحن. مثال 0.3 |
المنتجات المتغيّرة والمتغيّرات
لاستيراد منتج له متغيّرات (مقاسات، ألوان…)، اضبط عمود "type" على "variable" وأضف صفًّا لكل متغيّر. الصفوف التي تحمل اسم المنتج نفسه تُجمَّع تلقائيًا.
اكتب اسم كل متغيّر بالصيغة "المنتج | خيار1 | خيار2" (مثال: "تي شيرت | أحمر | M")، وأضف عمود "options" يسرد كل خيار وقيمه بالصيغة "color: red, blue; size: S, M, L". يبني Storeino مصفوفة الخيارات، ثم يملأ سعر ومخزون و SKU كل متغيّر من صفّه. احرص على ترتيب قيم الخيارات بنفس التسلسل في كل صف (مثلًا اللون ثم المقاس دائمًا) حتى تُربط كل قيمة بالخيار الصحيح.
name,options,salePrice,quantity
T-Shirt | Red | S,"color: red,blue; size: S,M",99,10
T-Shirt | Red | M,,99,5
T-Shirt | Blue | S,,89,8
T-Shirt | Blue | M,,89,3تُقرأ الأعمدة salePrice و comparePrice و quantity وأعمدة variant.* لكل صف على حدة، فيحتفظ كل متغيّر بسعره ومخزونه الخاصّين. وإذا حذفت عمود "options"، يُنشأ خيار واحد تلقائيًا من أسماء المتغيّرات. يكفي ملء عمود "options" في الصف الأول من كل منتج — ويمكن تركه فارغًا في صفوف المتغيّرات التالية.
نصائح قبل الاستيراد
- ابدأ بدفعة صغيرة
جرّب الاستيراد بـ 5 أو 10 منتجات أوّلًا للتأكد من أن الأعمدة مطابقة، قبل رفع آلاف الصفوف.
- استخدم تشفير UTF-8
احفظ الملف بترميز UTF-8 لتفادي مشاكل الحروف العربية والرموز الخاصة.
- تأكّد من روابط الصور
يجب أن تكون الروابط مباشرة وقابلة للوصول العام. روابط Google Drive الخاصة لن تُحمَّل.
- احتفظ بنسخة احتياطية
صدِّر منتجاتك الحالية إلى CSV قبل أي استيراد كبير حتى تستطيع التراجع إذا حدث خطأ.
هل لديك سؤال آخر؟
فريق الدعم متاح للمساعدة في رفع الملفات الكبيرة أو حلّ أي خطأ.