استيراد المنتجات

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

تنبيه: الاستيراد والتصدير عبر CSV من مزايا باقة متكامل. إذا كنت في باقة الأساسية أو الاحترافية، فستُحوَّل صفحة الاستيراد إلى صفحة ترقية الباقة. أضِف المنتجات يدوياً من صفحة إضافة المنتجات، أو رقِّ باقتك. راجع الباقات والأسعار.

أين أجدها

من القائمة الجانبية في لوحة التحكم، ضمن مجموعة المنتجات، افتح صفحة استيراد. ستظهر بطاقة بعنوان «استيراد من ملف CSV».

ترتيب الأعمدة في الملف

ضع بيانات كل منتج في سطر مستقلّ، وافصِل بين الحقول بفاصلة (,) بهذا الترتيب تماماً:

الاسم , القسم , السعر , المخزون (اختياري) , الوزن بالغرام (اختياري)

• الاسم: اسم المنتج كما سيظهر في المتجر — حقل إلزامي. إن تُرك فارغاً رُفِض الصفّ بسبب «الاسم مفقود».
• القسم: اسم القسم أو معرّفه (slug). يجب أن يكون قسماً موجوداً مسبقاً في متجرك؛ يقبل المتجر إمّا الاسم العربي للقسم وإمّا معرّفه الإنجليزي. فإن لم تطابق القيمة أيّاً منهما رُفِض الصفّ بسبب «قسم غير معروف».
• السعر: رقم بالريال اليمني — حقل إلزامي. يجب أن يكون رقماً موجباً أو صفراً، وإلا رُفِض الصفّ بسبب «سعر غير صالح».
• المخزون (اختياري): الكمية المتوفّرة من المنتج. اتركه فارغاً إن لم ترغب بتتبّع الكمية.
• الوزن بالغرام (اختياري): وزن المنتج بالغرام، ويفيد لاحقاً في حساب الشحن بالوزن.

ملاحظة: عند إعادة استيراد ملف سبق أن صدّرته، يتعرّف المتجر تلقائياً على عمود «سعر بعد الخصم» (بحسب عنوانه) فيُستعاد التخفيض: عمود «السعر» هو السعر العادي، و**«سعر بعد الخصم»** هو السعر المخفّض ويجب أن يكون أقلّ منه. (تُقبل كذلك الملفات القديمة التي تحمل عمود «السعر قبل الخصم».)

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

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

نصيحة: إن أردت إنشاء قسم جديد قبل الاستيراد، فأنشئه أولاً من صفحة الأقسام، ثم استخدم اسمه في ملفك.

كيفية استيراد منتجاتك

1. افتح القائمة المنسدلة «الأقسام المتاحة» أعلى البطاقة وتأكّد من أسماء الأقسام أو معرّفاتها التي ستستعملها في عمود «القسم».
2. جهّز صفوف منتجاتك حسب ترتيب الأعمدة أعلاه، ثم الصقها في المربّع النصّي الكبير (كل منتج في سطر).
3. أو اضغط «رفع ملف CSV» واختر ملفك من جهازك؛ سيُملأ المربّع بمحتوى الملف تلقائياً.
4. اضغط «معاينة». يعرض المتجر جدولاً يُظهر كل صفّ مع علامة صحّ خضراء إن كان صالحاً أو علامة خطأ حمراء إن كان غير صالح، إضافةً إلى عمود «ملاحظات» يبيّن سبب الخطأ في الصفوف المرفوضة (مثل «قسم غير معروف» أو «سعر غير صالح»). وفي الأعلى يظهر ملخّص مثل «5 صالح من 6 — سيتم تجاهل غير الصالح».
5. راجع المعاينة. إن وجدت أخطاءً، صحّح الصفوف في المربّع أو في ملفك ثم اضغط «معاينة» مجدداً. عند رضاك عن النتيجة اضغط «استيراد» لتنفيذ الصفوف الصالحة فقط دفعةً واحدة. تظهر بعدها رسالة «اكتمل الاستيراد» تبيّن كم منتجاً أُضيف وكم حُدِّث (وتُضيف «· فشل N» إن تعذّر حفظ صفّ ما) مع زرّ «عرض المنتجات» للانتقال إلى قائمتك.

ملاحظة: زرّ «استيراد» يبقى معطّلاً حتى تُجري معاينةً ناجحة فيها صفّ صالح واحد على الأقل. وكلّما عدّلت محتوى المربّع، يُعطَّل الزرّ من جديد حتى تعيد المعاينة — حمايةً من استيراد بيانات لم تُراجَع.

ماذا يحدث بعد الاستيراد

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

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

نصائح للسوق اليمني

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

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

تنبيه: احفظ ملفك بترميز UTF-8 ليظهر النصّ العربي صحيحاً عند الاستيراد؛ المتجر يقرأ الملفات على أنها UTF-8. إن ظهرت الحروف العربية كرموز غريبة فالسبب غالباً ترميز الملف.

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

أسئلة شائعة

ما الصيغة المدعومة؟ ملف بصيغة CSV (نصّ مفصول بفواصل)، أو لصق الصفوف مباشرةً في المربّع النصّي داخل الصفحة. عند رفع ملف يُقرأ بترميز UTF-8.

لماذا لا أرى صفحة الاستيراد؟ لأنها من مزايا باقة متكامل. في الباقتين الأساسية والاحترافية تُحوَّل الصفحة إلى صفحة ترقية الباقة. أضِف منتجاتك يدوياً أو رقِّ باقتك.

هل يجب أن يكون القسم موجوداً قبل الاستيراد؟ نعم. أنشئ الأقسام أولاً، ثم اكتب اسم القسم أو معرّفه في الملف. أيّ صفّ بقسم غير معروف يُرفَض في المعاينة ولا يُستورَد.

ماذا يحدث للصفوف غير الصالحة؟ تُتجاهَل عند الاستيراد ولا تُضاف، ويُدرَج الصالح فقط. تُبيّن المعاينة سبب كل خطأ (الاسم مفقود، قسم غير معروف، سعر غير صالح) لتصحّحها وتعيد المحاولة.

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

هل تُضاف صور المنتجات أو أوصافها عبر الاستيراد؟ لا. يستورد الملف الاسم والقسم والسعر والمخزون والوزن، و«سعر بعد الخصم» إن وُجد العمود (كما في ملف صدّرته). أمّا الصور والأوصاف والخيارات فأضِفها لاحقاً بفتح كل منتج وتحريره من قائمة المنتجات. وعند تحديث منتج موجود، تبقى صورته ووصفه وبقية تفاصيله غير المذكورة في الملف كما هي.

بأيّ حالة تُضاف المنتجات المستورَدة؟ تُضاف منشورةً (ظاهرة في المتجر) ومتوفّرةً في المخزون. وتكون مؤهّلةً للدفع عند الاستلام افتراضياً على الباقات التي تشمله (الاحترافية/متكامل، وأثناء التجربة المجانية)؛ أمّا على الباقة المجانية «الأساسية» فلا يتوفّر الدفع عند الاستلام. عدّل أيّاً من ذلك بعد الاستيراد من صفحة المنتج.

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

هل أحذف صفّ العناوين من ملف صدّرته سابقاً؟ لا حاجة. يتعرّف المتجر على صفّ العناوين تلقائياً ويتجاهله، فلن يُحسَب منتجاً.