استيراد المنتجات أو تصديرها بملف CSV

انقل منتجاتك من جدول بيانات أو منصة أخرى، وصحّح الصفوف التي تحتاج تعديلاً، ونزّل منتجاتك كملف CSV وقت ما تريد.

متاح في خطة البداية وما فوقها

آخر تحديث

انقل منتجاتك إلى نقطة شوب من جدول بيانات أو من منصة أخرى بملف CSV، وحدّث الأسعار والمخزون دفعة واحدة، ونزّل منتجاتك كملف CSV وقت ما تريد. استيراد CSV وتصديره متاحان من خطة البداية فما فوق.

نزّل القالب للبدء

يوضّح القالب شكل الملف الذي تقرؤه نقطة شوب. ابدأ منه إذا كنت تجهّز قائمتك بنفسك.

  1. من القائمة الجانبية، افتح المنتجات ثم اختر المنتجات تحتها، أو افتح قائمة منتجاتك (يفتح في تبويب جديد).
  2. في أعلى الصفحة، اختر استيراد CSV. تُفتح نافذة استيراد المنتجات من ملف.
تعرض النافذة الأعمدة التي تقرؤها ورابط القالب.
  1. اختر نزّل قالباً للبدء.

يُنزَّل الملف noqtashop-import-template.csv. فيه صف العناوين بلغة لوحة التحكم عندك، وصف مثال واحد: تي شيرت قطني برمز TSH-001. ويُفتح القالب في Excel بشكل صحيح، والعربية معه.

احذف صف المثال قبل الاستيراد. إذا تركته، يُستورد تي شيرت قطني بحالة Active (نشط)، أي معروضاً للبيع في واجهة متجرك فوراً بسعر 12.50 و40 قطعة في المخزون، داخل فئة جديدة اسمها ملابس.

تبيع على منصة أخرى؟ صدّر منتجاتك منها كملف CSV وجرّب استيراده كما هو. تفهم نقطة شوب بعض أسماء الأعمدة الشائعة، مثل Title للاسم وQuantity للمخزون، والأسماء العربية والفرنسية أيضاً. وإذا رُفض الملف برسالة «يجب أن يحتوي الملف على عمودَي «رمز المنتج» و«الاسم» على الأقل.»، غيّر اسم العمود الذي فيه رمز كل قطعة إلى رمز المنتج، واسم عمود عنوان المنتج إلى الاسم. وأي عمود آخر تريد استيراده، سمّه باسمه في الجدول أدناه.

الأعمدة: «رمز المنتج» و«الاسم» مطلوبان والباقي اختياري

يجب أن يحمل الصف الأول من الملف أسماء الأعمدة. تجد نقطة شوب كل عمود باسمه لا بمكانه، فتستطيع ترتيب الأعمدة كما تريد وحذف الاختيارية منها. حالة الأحرف والمسافات والشرطات والشرطات السفلية لا تهم، والأسماء الإنجليزية والفرنسية مفهومة أيضاً، مثل Price أو Prix للسعر. والأعمدة التي لا تستخدمها نقطة شوب تُتجاهل.

العمودمطلوب؟ماذا يحمل
رمز المنتجنعم، في كل صفرمز SKU الخاص بالمنتج أو المتغير، مثل LY-TRC-DRS. به تُطابق الصفوف.
الاسمنعم، في كل صفاسم المنتج.
الرابطلارابط المنتج، مثل terracotta-linen-shirt-dress. إذا تركته فارغاً يُنشأ من الاسم.
الحالةلاActive أو Draft أو Archived بالإنجليزية. إذا كانت فارغة أو غير ذلك يصير المنتج الجديد مسودة.
الفئةلااسم الفئة نفسها، مثل فساتين — لا مسار مثل نسائي > فساتين.
العلامة التجاريةلاالعلامة التجارية، مثل ليال.
الوصفلاوصف المنتج كنص عادي.
السعرلاالسعر كرقم، مثل 38.000. إذا كان فارغاً يكون 0 للمنتج الجديد.
سعر المقارنةلاالسعر قبل الخصم الذي يظهر مشطوباً.
سعر التكلفةلاما تكلّفك القطعة، لأرقام الأرباح.
المخزونلاالكمية المتوفرة كعدد صحيح. إذا كان فارغاً يكون 0 للمنتج الجديد.
تتبع المخزونلاfalse بأحرف صغيرة لتبيع دون عدّ المخزون. الفارغ أو أي قيمة أخرى يُبقي العدّ شغالاً.
الخياراتلايكتبه التصدير للاطلاع فقط، والاستيراد لا يقرؤه.

اكتب الأرقام بالأرقام 0 إلى 9 لا ٠ إلى ٩، وبنقطة للكسور، ولا شيء غير ذلك: 38.000، لا 38,000 (الفاصلة تُقرأ فاصلة آلاف)، ولا 38 د.أ، ولا ٣٨. ويتسع الملف الواحد لـ 2,000 صف منتجات.

كيف تُطابق الصفوف: برمز SKU

تقرأ نقطة شوب الملف صفاً صفاً، وتقرر لكل صف:

رمز SKU في الصف…ماذا يحدثيُحسب ضمن
لمنتج موجود عندكيُحدَّث ذلك المتغير: سعره وسعره قبل الخصم وتكلفته ومخزونه، وفئة المنتج — من الخانات التي عبّأتها فقط. الخانة الفارغة تُبقي القيمة كما هي. يحتاج صلاحية تعديل المنتجات.حُدِّثت
جديد، ورابطه (أو اسمه إن لم يكن له رابط) يطابق منتجاً عندك أو صفاً سابقاً في الملفيُضاف متغير جديد إلى ذلك المنتج. وإضافته إلى منتج كان عندك أصلاً تحتاج صلاحية تعديل المنتجات.متغيرات أُضيفت
جديد ولا يطابق شيئاًيُنشأ منتج جديد، وهذا الصف أول متغير فيه.منتجات أُنشئت
لمنتج حذفتهلا شيء: المنتج المحذوف يحتفظ برموزه. يظهر الصف مع رسالة الرمز «…» يخص منتجاً محذوفاً. استخدم رمزاً آخر.يظهر تحت صفوف تحتاج مراجعة

تُطابق رموز SKU دون اعتبار لحالة الأحرف. واسم الفئة الذي لا يطابق أي فئة عندك يُنشأ فئةً جديدة في المستوى الأعلى، وإذا كانت فئة أخرى تستخدم الرابط الذي يعطيه اسمها، تأخذ الفئة الجديدة الرابط وفي آخره -2. ولا يغيّر الاستيراد حالة منتج موجود ولا رابطه، ولا يغيّر هل يتتبع المخزون. واسم المنتج المحذوف ورابطه صارا متاحين من جديد، فالصف الذي يحمل اسمه يُنشئ منتجاً جديداً بذلك الرابط.

والصف المطابق يستبدل أيضاً اسم المنتج، وعلامته التجارية ووصفه إذا كانت خاناتهما معبّأة. أما هل يرى العملاء النص الجديد، فيعتمد على المنتج:

  • منتج أنشأه الاستيراد ولم يحفظه أحد من صفحته بعد ذلك: نص الملف هو ما يراه العملاء، بكل اللغات. واستيراد اسم مختلف يغيّر اسم المنتج.
  • منتج حُفظ من صفحته في لوحة التحكم: يبقى العملاء يرون الاسم والعلامة التجارية والوصف المكتوبة في صفحته، مهما كان في الملف. والاستثناء الوحيد علامة تجارية أو وصف تركته فارغاً في الصفحة: عندها يظهر نص الملف.

لتغيير اسم منتج أو إعادة كتابة وصفه، استخدم صفحته — راجع تعديل منتج. وحتى تحافظ على نصوص منتج مستورد، اترك الاسم كما هو تماماً، واترك العلامة التجارية والوصف فارغين في الملف. وغيّر الحالات من القائمة: انشر عدة منتجات معاً.

ملاحظة

الاستيراد يغيّر المنتجات مباشرة، دون معظم السجلات التي تحتفظ بها لوحة التحكم. تغييراته لا تظهر في تبويب السجل للمنتج، ولا في سجل التدقيق. والمخزون هو الاستثناء: كل رقم مخزون يغيّره الملف يظهر في سجل المخزون للمتغير بعبارة تم الضبط من استيراد المنتجات، والطلب الذي يصل أثناء الاستيراد يأخذ قطعه من الرقم الجديد. ورفع مخزون متغير نفد بالاستيراد لا يرسل رسالة للعملاء الذين ضغطوا أعلمني — أعد تعبئة هذه المتغيرات من صفحة المنتج بدلاً من ذلك: راجع رسالة عودة التوفر. وتعرض واجهة متجرك أسعار الملف ومخزونه وفئاته الجديدة فور انتهاء الاستيراد.

تنبيه

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

اختر ملفاً: CSV حتى 5 ميغابايت

الاستيراد يحتاج صلاحية إضافة المنتجات. والصفوف التي تغيّر منتجاً موجوداً عندك — رمز SKU موجود، أو متغير جديد لمنتج موجود — تحتاج أيضاً صلاحية تعديل المنتجات. مالك المتجر ومدير المتجر لديهما الصلاحيتان. أما الدور الذي فيه إضافة المنتجات وحدها فيستورد المنتجات الجديدة فقط: تظهر الصفوف الأخرى تحت صفوف تحتاج مراجعة، ويُستورد الباقي. وهذا ما يقوله السطر تحت الأعمدة في النافذة: تُطابق الصفوف برمز SKU — الرمز الجديد يُنشأ، والموجود في الكتالوج يُحدَّث في مكانه، وهذا يحتاج صلاحية «تعديل المنتجات». الفئات الناقصة تُنشأ بالاسم. راجع الأدوار والصلاحيات.

  1. في قائمة المنتجات، اختر استيراد CSV.
  2. في نافذة استيراد المنتجات من ملف، اسحب ملفك إلى أفلت ملف CSV هنا، أو اختر اختر ملفاً وحدّده.

يظهر اسم الملف ويصير الزر اختر ملفاً آخر.

يظهر اسم الملف المختار في منطقة الإفلات، ويصير زر «استيراد» متاحاً.

تفحص النافذة الملف لحظة اختياره، وترفضه قبل إرسال أي شيء:

تُقبل فقط الملفات بامتداد csv.
  • هذا ليس ملف CSV. صدّر ملفاً من منصتك الحالية، أو نزّل القالب أدناه. امتداد الملف ليس csv — ملف Excel بامتداد xlsx مثلاً. في Excel اختر Save as (حفظ باسم) ثم CSV UTF-8 (Comma delimited)، وفي Google Sheets اختر File ثم Download ثم Comma-separated values.
الملف الأكبر من 5 ميغابايت يُرفض قبل إرسال أي شيء.
  • الملف أكبر من 5 ميغابايت. قسّمه واستورد كل جزء. انسخ صف العناوين إلى كل جزء.
  1. اختر استيراد. يعرض الزر جارٍ الاستيراد… حتى ينتهي، ولا يمكن إغلاق النافذة خلال ذلك.

وإذا تعذّر استيراد الملف كله، لا يتغيّر شيء، ويبقى ملفك مختاراً، وتظهر رسالة أسفل الشاشة توضّح السبب:

الرسالةماذا تفعل
«يجب أن يحتوي الملف على عمودَي «رمز المنتج» و«الاسم» على الأقل.»تأكد أن الصف الأول فيه عمود لرمز المنتج وعمود للاسم.
«يقبل الاستيراد الواحد 2,000 صف كحد أقصى. قسّم الملف واستورد كل جزء على حدة.»قسّمه إلى ملفات لا يزيد كل منها عن 2,000 صف، ولكل ملف صف العناوين.
«تعذّرت قراءة الملف: إحدى علامات الاقتباس فيه غير مغلقة. …»في إحدى الخانات علامة اقتباس مفتوحة بدون إغلاق. صحّحها، واحفظ الملف بصيغة CSV، واستورده مرة أخرى.
«حجم الملف أكبر من 4 ميغابايت. قسّمه واستورد كل جزء على حدة.»بعض الملفات الأصغر من 5 ميغابايت تبقى أطول من أن تُقرأ. قسّمه.
«لا يحتوي الملف على أي صفوف.»الملف فارغ. تأكد أنك حفظت الورقة الصحيحة.

اقرأ النتيجة: ما أُنشئ وما أُضيف وما حُدِّث

عندما ينتهي الاستيراد تعرض النافذة ثلاثة أرقام:

  • منتجات أُنشئت — منتجات جديدة.
  • متغيرات أُضيفت — متغيرات جديدة أُضيفت إلى منتجات، من صفوف تشترك في منتج واحد.
  • حُدِّثت — متغيرات كانت عندك وحُدِّثت في مكانها.
الصفوف التي استُوردت محفوظة، وما يحتاج تصحيحاً هو الصفوف المذكورة فقط.

الصفوف التي فيها مشكلة تظهر تحت صفوف تحتاج مراجعة، ومعها عبارة صحّح هذه الأسطر واستوردها وحدها في ملف جديد. استيراد الملف كاملاً مرة أخرى يُحدِّث الأسطر التي استُوردت من قبل، وهذا يحتاج صلاحية «تعديل المنتجات». وكل صف غيرها حُفظ فعلاً. وإذا لم يكن هناك ما يحتاج تصحيحاً تقول النافذة تم استيراد كل الصفوف.

«تم استيراد كل الصفوف.»: لا شيء تصححه.

اختر تم لتغلق النافذة، أو استيراد ملف آخر لتستورد الجزء التالي. عند الإغلاق تُحمَّل قائمة المنتجات من جديد ومعها منتجاتك الجديدة.

بعدها أكمل المنتجات الجديدة في لوحة التحكم. الملف لا يحمل صوراً، فأضفها من تبويب الوسائط لكل منتج (إضافة صور المنتج). ونصوصه تصل بلغة واحدة: ترجمها إلى لغاتك الأخرى. والفئات التي أنشأها الاستيراد تكون في المستوى الأعلى، فانقلها تحت الفئة الرئيسية المناسبة من الفئات. وفي النهاية انشر المنتجات معاً.

ولأن الاستيراد لا يقرأ الخيارات، فالمتغيرات التي يضيفها ليس لها مقاس أو لون خاص بها. للمنتج الذي له مقاسات أو ألوان، استورد له صفاً واحداً، ثم جهّز خياراته من تبويب المتغيرات — راجع متغيرات المنتج. وبعدها، لتحدّث هذه المتغيرات بالاستيراد، استخدم في ملفك رموز SKU التي أنشأتها لها نقطة شوب.

صحّح الصفوف التي لم تُستورد

لكل صف تحت صفوف تحتاج مراجعة رقم في عمود الصف وشرح في عمود المشكلة. ترقيم الصفوف يبدأ بعد صف العناوين: الصف 9 هو تاسع صف منتجات، أي السطر 10 في جدول البيانات.

المشكلةماذا تفعل
«أدخل «رمز المنتج» و«الاسم».»عبّئ الخانتين. كل صف يحتاجهما، حتى صف المتغير.
«السعر «forty» ليس رقماً.»اكتب السعر بالأرقام 0 إلى 9، مثل 40.000، دون عملة. والأرقام العربية مثل ٤٠ تُرفض بالرسالة نفسها.
«المخزون «12.5» ليس عدداً صحيحاً.»اكتب عدداً صحيحاً بالأرقام 0 إلى 9، مثل 12.
«الرمز «LY-PSS-NVY» يخص منتجاً محذوفاً. استخدم رمزاً آخر.»منتج حذفته ما زال يحتفظ بهذا الرمز. أعطِ الصف رمز SKU جديداً.
«الرمز «LY-TLSD-TER-M» موجود في الكتالوج. تعديل المنتج يحتاج صلاحية «تعديل المنتجات». اطلب من صاحب المتجر إضافتها إلى دورك.»دورك يسمح بإضافة المنتجات لا بتعديلها، وهذا الصف سيغيّر منتجاً موجوداً. احذف الصف، أو اطلب من مالك المتجر أن يستورده أو أن يضيف تعديل المنتجات إلى دورك.
«المنتج «فستان قميص كتان تيراكوتا» موجود في الكتالوج. إضافة متغير إليه تحتاج صلاحية «تعديل المنتجات». اطلب من صاحب المتجر إضافتها إلى دورك.»رمز SKU الجديد في الصف سيصير متغيراً لمنتج موجود عندك. كما في الصف السابق: احذفه، أو اطلب ذلك من مالك المتجر.
«وصلت هذه الخطة إلى حد المنتجات.»الصف سينشئ منتجاً لا تتسع له خطتك. انتقل إلى خطة أعلى، أو احذف منتجات لم تعد تبيعها — راجع الخطط وما تتضمنه كل خطة.
بدون «تعديل المنتجات» تُستورد المنتجات الجديدة، وتظهر الصفوف التي ستغيّر منتجات موجودة.
  1. صحّح هذه الصفوف في ملفك، واحفظها في ملف CSV جديد فيه صف العناوين وهذه الصفوف فقط.
  2. اختر استيراد ملف آخر واستورد هذا الملف.

وتستطيع بدلاً من ذلك استيراد الملف كاملاً مرة أخرى إذا كان دورك يملك تعديل المنتجات: الصفوف التي استُوردت في المرة الأولى تُطابق برمز SKU وتُحدَّث فقط، فلا يُنشأ شيء مرتين. أما خانة سعر المقارنة أو سعر التكلفة إذا لم يكن فيها رقم فلا تُذكر كمشكلة: تُتجاهل، ويُستورد باقي الصف.

صدّر منتجاتك

  1. في قائمة المنتجات، اختر تصدير CSV.

يعرض الزر جارٍ إعداد الملف…، ثم يُنزَّل الملف. في اسمه التاريخ والوقت بتوقيت UTC، أي قبل توقيت الأردن بثلاث ساعات: الملف products-export-20261006-112530.csv صُدِّر الساعة 14:25 بتوقيت عمّان. وإذا لم يُنزَّل شيء، اختر تصدير CSV مرة أخرى.

في الملف نفس أعمدة القالب، و:

  • صف لكل متغير، فالفستان الذي له خمسة مقاسات يأخذ خمسة صفوف بنفس الاسم والرابط؛
  • كل المنتجات، ومنها المسودات والمؤرشفة — المنتجات المحذوفة فقط لا تظهر؛
  • أسماء الأعمدة ونصوص المنتجات بلغة لوحة التحكم عندك؛ ولتصدّر بلغة أخرى، غيّر لغة لوحة التحكم أولاً؛
  • الحالة بالإنجليزية؛
  • في عمود الخيارات، خيارات كل متغير كنص تقني، مثل "option":"Size" و"value":"M" مع ترجماتها ورموز ألوانها — وهو للاطلاع فقط، وتعديله لا يغيّر شيئاً؛
  • أسعار التكلفة عندك. ويستطيع تنزيله كل من يسمح له دوره بعرض المنتجات.

الخانة التي تبدأ بـ = أو + أو - أو @ تُحفظ وقبلها فاصلة علوية (') حتى لا يشغّلها جدول البيانات كمعادلة. والاستيراد يزيل هذه الفاصلة من جديد.

ملف التصدير يُستورد من جديد دون أن يتكرر شيء: كل صف يُطابق برمز SKU ويُحدَّث، وهذا يحتاج صلاحية تعديل المنتجات. ولتغيير أسعار أو كميات كثيرة، صدّر الملف، وعدّل هذه الأعمدة في جدول البيانات، ثم استورده.

والفئات هي الشيء الوحيد الذي تنتبه له عندما تستورد ملف تصدير من جديد. تُطابق الفئات بالاسم الذي حُفظت به في لوحة التحكم، وباللغة التي كُتب بها. فإذا صدّرت بلغة أخرى — أسماء عربية لفئات سمّيتها بالإنجليزية مثلاً — أفرغ عمود الفئة قبل أن تستورد الملف من جديد، وإلا يُنشئ الاستيراد فئات جديدة بهذه الأسماء وينقل المنتجات إليها.

نصيحة

إذا ظهرت العربية في ملف التصدير رموزاً غريبة في Excel، فلا تفتحه بالنقر المزدوج. في Excel افتح Data (البيانات) ثم From Text/CSV، واختر الملف، واجعل File origin (أصل الملف) 65001: Unicode (UTF-8).

في الخطة المجانية

استيراد CSV وتصديره، مثل باقي الأدوات الجماعية، متاحان من خطة البداية فما فوق. في الخطة المجانية يظهر قفل على تصدير CSV واستيراد CSV.

في الخطة المجانية يحمل «تصدير CSV» و«استيراد CSV» قفلاً.

إذا اخترت أحدهما فلن يُنزَّل أو يُفتح شيء: تظهر رسالة تذكر الخطة التي تتضمنه وسعرها، مع عرض الخطط الذي يفتح صفحة اشتراكك.

الضغط على زر عليه قفل يذكر الخطة التي تتضمنه.

راجع لماذا تظهر علامة القفل على بعض الميزات والخطط وما تتضمنه كل خطة. وفي الخطة المجانية أضف المنتجات واحداً واحداً: إضافة منتج.

الخطوة التالية: أضف صور منتجاتك الجديدة وخياراتها، أو عدّل عدة منتجات دفعة واحدة.