Shopify · CSV · Excel

استيراد منتجات Shopify من ملف CSV أو Excel

يعمل استيراد CSV في Shopify جيدًا بشرط أن يتبع الملف قالبه بدقة. إليك الصيغة المطلوبة، والطريقة خطوة بخطوة، والأخطاء الأكثر شيوعًا، وطريقًا آخر: يقرأ ListoMax ملف CSV أو Excel كما هو، وينشئ كل منتج في Shopify عبر واجهة Admin API.

بقلم Yvan Barbaggio، مبتكر ListoMax · آخر تحديث

خطوة بخطوة

كيف تستورد ملف CSV إلى Shopify؟

في لوحة إدارة Shopify، صفحة المنتجات، زر الاستيراد: ترفع ملف CSV بترميز UTF-8، وتختار خيارين، ثم تراجع الملخص قبل البدء.

افتح الاستيراد

في لوحة إدارة Shopify افتح المنتجات، ثم انقر على استيراد وأضف ملف CSV.

اختر الخيارات

خانتان: نشر المنتجات الجديدة على كل قنوات البيع (مفعّلة افتراضيًا)، واستبدال المنتجات التي يوجد معرّف عنوانها (handle) مسبقًا. من دون الخانة الثانية تُتجاهل المنتجات الموجودة.

راجع ثم استورد

يعرض Shopify تفاصيل الاستيراد قبل بدئه. بعد البدء لا يمكن إلغاؤه، وتصلك رسالة تأكيد بالبريد في النهاية.

تحقق من الكتالوج

راجع الأسعار والمتغيرات والصور والمجموعات. لا يحتفظ Shopify بسجل للاستيرادات السابقة، فدوّن ما أرسلته.

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

القالب

ما صيغة ملف CSV التي يقبلها Shopify؟

ملف CSV بترميز UTF-8، أعمدته مفصولة بفواصل، وسطره الأول للعناوين، وحجمه 15 ميغابايت كحد أقصى. للمنتج الجديد يكفي العنوان، وعندما تكون له متغيرات يصبح الـ handle إلزاميًا أيضًا.

القاعدةما يطلبه Shopify
الترميزUTF-8، وإلا تصبح الحروف غير مقروءة
الفاصلفاصلة بين الأعمدة؛ عناوين مطابقة للقالب بما فيها الأحرف الكبيرة
الحجم15 ميغابايت كحد أقصى؛ وما زاد يُقسَّم إلى عدة ملفات
الأعمدة الإلزاميةالعنوان للمنتج الجديد؛ العنوان والـ handle للتحديث أو للمنتج ذي المتغيرات
المتغيراتالسطر الأول: كل معلومات المنتج. الأسطر التالية: الـ handle نفسه وتفاصيل كل متغير. ثلاثة خيارات كحد أقصى (Option1 إلى Option3)
الصورعنوان عام بصيغة https في كل سطر، و250 صورة كحد أقصى لكل منتج
المجموعاتمجموعة واحدة فقط لكل منتج في العمود المخصص
انتبه إلى الفاصل في Excel. في بعض إعدادات اللغة والمنطقة يحفظ Excel ملفات CSV بفاصلة منقوطة، بينما ينتظر Shopify فواصل عادية، فتنتهي كل البيانات في عمود واحد. أما Google Sheets فيصدّر بترميز UTF-8 مع فواصل.
حل المشكلات

لماذا لا يعمل استيراد CSV في Shopify؟

في أغلب الأحيان يكون الملف هو السبب لا المتجر. إليك المشكلات الأكثر شيوعًا وأسبابها بحسب المساعدة الرسمية لـ Shopify.

رموز غريبة بدل الحروف

الملف ليس بترميز UTF-8. احفظه من جديد بهذه الصيغة ثم أعد المحاولة.

«Unexpected token < in JSON at position 0»

العناوين لا تطابق قالب Shopify، وهي حساسة لحالة الأحرف: «title» ليست «Title».

«Illegal quoting»

مشكلة في علامات الاقتباس داخل خلية: علامة غير مغلقة، أو ملف ليس بترميز UTF-8.

«Line is invalid»

تعارض بين قيم الخيارات في أسطر المنتج نفسه. راجع الأعمدة من Option1 إلى Option3.

اختفت الصور

قد يؤدي فرز الملف في Excel أو Numbers إلى فصل أسطر الصور عن منتجها. تجنّب فرز ملف جاهز.

معلومات محذوفة

في وضع الاستبدال، يحلّ العمود الموجود الفارغ محل القيمة الحالية بلا شيء. احذف من الملف الأعمدة التي لا تريد تغييرها.

اعرف أي سطر يسبب المشكلة. في ListoMax يظهر كل إخفاق برقم سطره وسببه، ويتيح خيار المتابعة رغم الأخطاء.

لاكتشاف هذه الأخطاء قبل الاستيراد، افحص ملفك باستخدام مدقق CSV المجاني لـ Shopify: يُقرأ في متصفحك ولا يُرسل شيء.

طريق آخر

كيف تستورد ملف المورّد إلى Shopify دون إعادة إعداده؟

احتفظ بملفك كما هو. يقرأ ListoMax ملف CSV أو الورقة الأولى من مصنف Excel، ويتعرّف على الأعمدة المفيدة، ثم ينشئ كل منتج في Shopify عبر واجهة Admin API الرسمية مع حالة لكل منتج.

استيراد CSV في Shopifyالاستيراد في ListoMax
الصيغةCSV بترميز UTF-8 بفواصل، وعناوين قالب ShopifyCSV أو Excel، الفاصل يُكتشف تلقائيًا، وعناوين بسيطة
المتغيراتسطر لكل متغير مع تكرار الـ handleالمحاور تُدخل مرة واحدة والتركيبات تُولَّد
الصورعناوين عامة، واحد في كل سطرعدة عناوين في خلية واحدة يفصلها خط عمودي
اللغاتالترجمات تُدار على حدةعمود لكل لغة يُرسل إلى لغات المتجر المنشورة
المتابعةبريد في النهاية ولا سجلعدّاد مباشر وأخطاء مرقّمة
منتج موجوديُتعرّف عليه بالـ handle إن فُعّل الاستبداليُتعرّف عليه بمرجعه ويُحدَّث
عدة متاجراستيراد لكل متجرShopify وPrestaShop وWooCommerce دفعة واحدة
المعلومةالعنوان الذي يتعرّف عليه ListoMax
الاسم لكل لغةname_fr, name_en, name_es, name_de
المرجعreference أو sku
السعر والتخفيضprice, sale_price
المخزون والوزن والباركودquantity, weight, ean
التصنيفcategory, tags
النصوصdescription_ar (ولغات أخرى)
الصور والظهورimages, active
تحسين محركات البحثseo_title_ar, seo_desc_ar

تُتجاهل الأعمدة غير المعروفة دون إيقاف الاستيراد، وتُعرض الأسطر الستة الأولى قبل البدء. يمكن تنزيل قالب CSV وقالب Excel من البرنامج، معبّأين بمثال. تختار المتاجر الوجهة قبل البدء، ثم تنضم المنتجات المستوردة إلى كتالوج ListoMax قابلة للتعديل وإعادة النشر.

ما لا يُرسل إلى Shopify. الوصف المختصر والأبعاد وتواريخ التخفيض لا مقابل مباشرًا لها في Shopify: تبقى هذه الأعمدة في بطاقة ListoMax وتُرسل إلى PrestaShop وWooCommerce.

كل ما يُنشأ في المتجر، من متغيرات ومجموعات وتحسين لمحركات البحث ونشر، مفصّل في صفحة إضافة المنتجات بالجملة إلى Shopify. وللمنتجات ذات الخيارات راجع إنشاء متغيرات Shopify بالجملة. تبيع في متاجر أخرى أيضًا؟ اقرأ استيراد CSV وExcel إلى PrestaShop واستيراد منتجات CSV إلى WooCommerce.

الأسئلة الشائعة

إجابات عن أسئلتك

هل يقبل Shopify ملفات Excel؟

ينتظر استيراد Shopify ملف CSV بترميز UTF-8 مع فواصل بين الأعمدة، لذا يجب حفظ مصنف Excel بصيغة CSV مع التحقق من الفاصل. أما ListoMax فيقرأ الورقة الأولى من ملف Excel مباشرة دون تحويل.

ما الحجم الأقصى لملف CSV في Shopify؟

15 ميغابايت. وما زاد، أو إذا فشل الرفع، ينصح Shopify بتقسيم الملف إلى عدة ملفات أصغر.

كيف تستورد المتغيرات عبر CSV إلى Shopify؟

يحمل السطر الأول من المنتج كل معلوماته، وكل سطر يليه يكرر الـ handle نفسه ويصف متغيرًا واحدًا بقيمه من Option1 إلى Option3. يقبل Shopify ثلاثة خيارات وحتى 2048 متغيرًا لكل منتج.

هل يمكن تحديث منتجات Shopify الموجودة عبر CSV؟

نعم، بتفعيل خيار استبدال المنتجات ذات الـ handle نفسه. انتبه: العمود الموجود الفارغ يمحو القيمة الحالية. في ListoMax يُتعرّف على المنتج الموجود بمرجعه ويُحدَّث.

هل يمكن تجربة الاستيراد دون مخاطرة؟

نعم. تتيح التجربة المجانية لـ ListoMax خمس عمليات نشر حقيقية دون بطاقة بنكية. انشر تجاربك كمسودة: يُنشأ المنتج في Shopify ويبقى مخفيًا عن عملائك. التراخيص في صفحة الأسعار.

جرّبه على متجر Shopify الخاص بك

5 عمليات نشر حقيقية مجانًا، دون الحاجة إلى بطاقة ائتمان. ثم ترخيص مدى الحياة: €49 لجهاز كمبيوتر واحد، و€149 لما يصل إلى 5 أجهزة.

شارك هذه الصفحة