استيراد الطلبات عبر CSV

ليش تستخدم استيراد CSV؟

• إدارة جماعية: بدل ما تنشئ أو تعدّل كل طلب لحاله، تقدر تعالج دفعات كبيرة من الطلبات في رفع واحد.

• محايد لقنوات البيع: استورد وادِر الطلبات من أي قناة مبيعات عندك — المتاجر الإلكترونية، الأسواق، الطلبات الهاتفية، إلخ — وخَل Mayzing يتولى التنفيذ.

• تكامل سهل: أغلب أنظمة إدارة الطلبات تقدر تصدّر وتستورد البيانات بصيغة CSV، وهذا يخلي نقل البيانات بين المنصات شيء بسيط.

إذا عملك الفني لازم يطلع في مكان معيّن من القطعة بدل ما يكون في النص، تقدر تحقق هذا الشي إنك تجهّز عملك الفني بهذي الطريقة.

1. اذهب إلى لوحة تحكم Mayzing SXP - https://dashboard.mayzing.com

2. اذهب إلى تبويب Orders

   

3. اضغط على Fulfilment orders

   

4. اضغط على Import وسيظهر لك هذا المودال

   

5. لو كنت جاهز لاستيراد ملف Orders CSV انتقل مباشرة إلى الخطوة 9

6. لو ما جهزت ملف ‎.csv لسه، اضغط على Download Mayzing CSV template، هذا حيحمّل لك القالب اللي تحتاج تعبيه. تقدر كمان تحمّله من here.

7. عبّ المعلومات التالية لكل سطر.

   • order_reference (Required) - مُعرِّف للطلب الخارجي (مثلاً رقم الطلب من منصة تجارة إلكترونية ثانية). لو أكثر من سطر في الاستيراد له نفس Order Reference، تنجمع في طلب واحد.

   • store (Required) - اسم المتجر أو وصف يحدد مصدر المبيعات للطلب. نوصي تستخدم دومين المتجر (مثلاً www.mystore.com)

   • currency (Required) - العملة اللي حاب يتم تحصيل قيمة الطلب بها. القيم المسموحة USD, EUR وGBP.

   • retail_currency (Required) - العملة اللي تم بيع المنتج بها بصيغة ISO 4217؛ لازم تطابق القيمة العددية في حقل item_retail_total_price. تقدر تلاقي قائمة عملات البيع here

   • recipient_first_name (Optional) - الاسم الأول للمستلم

   • recipient_last_name (Required) - اسم عائلة المستلم

   • recipient_email (Required) - البريد الإلكتروني للمستلم. مع إنه اختياري، لازم توفر إما إيميل أو رقم جوال للطلب.

   • recipient_phone (Optional) - رقم جوال المستلم مع كود الدولة. مع إنه اختياري، لازم توفر إما إيميل أو رقم جوال للطلب.

   • shipping_address_country (Required) - الدولة اللي بيتم شحن المنتج لها، بصيغة ISO 3166. قائمة الدول اللي ندعمها موجودة here

   • shipping_address_state (Optional) - كود المنطقة اللي بيتم الشحن لها. هذا الكود لازم يكون كود مش اسم. تقدر تلاقي الأكواد في this article.

   • shipping_address_street_1 (Required) - أول سطر من عنوان الشحن

   • shipping_address_street_2 (Optional) - السطر الثاني (لو فيه) من عنوان الشحن

   • shipping_address_city (Required) - المدينة في عنوان الشحن

   • shipping_address_urbanization (Optional) - المنطقة أو الحي أو التطوير داخل المنطقة الجغرافية اللي بيتم الشحن لها. مثلاً URB FLAMINGO HILLS

   • shipping_address_post_code (Required) - الرمز البريدي / zip code لعنوان الشحن

   • shipping_address_company_name (Optional) - اسم شركة المستلم لو فيه

   • shipping_address_instructions (Optional) - أي ملاحظات خاصة للشحن (مثلاً ‘اتركه عند الباب’ إلخ.)

   • item_retail_total_price (Required) - السعر التجزئة لعنصر/عناصر هذا السطر، بالعملة المحددة في حقل retail_currency. مثلاً لو سعر التجزئة ‎$15.00 فالقيمة في هذا العمود تكون 1500، بدون رمز العملة. العملة تتحدد في الحقل الآخر. هذه المعلومة تُستخدم فقط على ملصق الشحن وما تأثر على المبلغ اللي تدفعه لتنفيذ الطلب.

   • item_name (Required) - اسم المنتج اللي تطلبه. لازم يطابق اسم منتج في Mayzing Product Data Sheet.

   • item_size (Required) - مقاس المنتج اللي تطلبه. لازم يطابق اسم منتج في Mayzing Product Data Sheet.

   • item_color (Required) - لون المنتج. لازم يطابق اسم منتج في Mayzing Product Data Sheet.

   • item_quantity (Required)- عدد القطع من هذا المنتج اللي تطلبها. لازم يكون رقم صحيح موجب (1 فما فوق).

   • item_design_1_print_area (Optional) - اسم مساحة الطباعة اللي راح تنحط عليها صورة التصميم الأولى (مثلاً ‘front’, ‘back’ إلخ.). لازم تطابق مساحة تصميم من Mayzing Product Data Sheet لنوع هذا العنصر. مع إنه اختياري، لازم توفر على الأقل مساحة طباعة واحدة ورابط تصميم واحد للطلب.

   • item_design_1_url (Optional) - رابط URL لصورة تُطبَّق على مساحة الطباعة الأولى. لازم يكون رابط كامل ومتاح للعامة. صيغة الصورة لازم تكون JPG/JPEG أو PNG. مع إنه اختياري، لازم توفر على الأقل مساحة طباعة واحدة ورابط تصميم واحد للطلب.

   • item_design_2_print_area (Optional) - اسم مساحة الطباعة اللي راح تنحط عليها صورة التصميم الثانية (مثلاً ‘front’, ‘back’ إلخ.). لازم تطابق مساحة تصميم من Mayzing Product Data Sheet لنوع هذا العنصر. ملاحظة: ما تحتاج تضيف أكثر من صورة تصميم إلا لو فعلاً تحتاج أكثر من تصميم. مع إنه اختياري، لازم توفر على الأقل مساحة طباعة واحدة ورابط تصميم واحد للطلب.

   • item_design_2_url (Optional) - رابط URL لصورة تُطبَّق على مساحة الطباعة الثانية. لازم يكون رابط كامل ومتاح للعامة. صيغة الصورة لازم تكون JPG/JPEG أو PNG. مع إنه اختياري، لازم توفر على الأقل مساحة طباعة واحدة ورابط تصميم واحد للطلب.

8. بعد ما تكمّل ملف CSV، احفظ المستند. لو تحفظه على ماك، لازم تختار Save as UTF8 CSV. تذكّر وين حفظته على جهازك. مهم جداً - لازم تشيل بيانات الـ placeholder من قالب CSV اللي نوفره. غير كذا، هذي الطلبات برضه راح تنضاف في جدول الطلبات عندك

9. اسحب الملف وأسقطه في هذا الصندوق، أو اضغط زر browse عشان تختار الملف من جهازك

   

10. لو الملف صالح، راح تشوف تنبيه فوق الصندوق يقول لك إن الـ CSV جاهز للاستيراد

    

11. اضغط Import CSV عشان تبدأ عملية الاستيراد

12. لو تمت العملية بنجاح، راح تشوف رسالة تأكيد تظهر لك

    

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

14. بعد ما يكتمل الاستيراد، راح تشوف إن الطلبات انضافت الآن في جدول الطلبات عندك. في هذه المرحلة تكون حالة الطلبات “غير مدفوعة”.

    

15. لو حاب تلغي الطلب، اضغط على الثلاث نقاط، راح يطلع لك زر cancel order، اضغط عليه عشان تلغي الطلب. راح يطلع لك صندوق تأكيد يسألك إذا فعلاً تبغى تلغي الطلب. لو ألغيت، حالة الطلب بتتغيّر إلى Cancelled، وبيكون لازم تستورده مرة ثانية.

    

16. لو أكدت الإلغاء، راح تشوف رسالة تأكيد تظهر لك

17. اضغط على زر الدفع إذا كنت جاهز تدفع قيمة الطلب.

18. راح تشوف التحديث في جدول الطلبات عندك يبيّن حالة Fulfilment Orders