تصدير واستيراد البيانات

يتيح لكم Gem Logic تصدير واستيراد البيانات بشكل جماعي باستخدام ملفات CSV وتنسيقات أخرى. هذا مفيد لترحيل البيانات من نظام آخر، أو إجراء تحديثات جماعية، أو إنشاء تقارير.

شاهد أيضا

ترحيل البيانات من نظام آخر للحصول على دليل خطوة بخطوة حول ترحيل بياناتكم من نظام آخر إلى Gem Logic.

إجراءات التصدير والاستيراد متاحة من قائمة Actions في معظم طرق عرض القوائم.

تصدير البيانات

لتصدير البيانات، انتقل إلى طريقة عرض القائمة للسجلات التي ترغب في تصديرها (مثل المنتجات أو جهات الاتصال أو الطلبات) وانقر على قائمة الإجراءات. اختر أيقونة التنزيل لفتح نافذة التصدير.

يمكنكم الاختيار بين عدة صيغ للتصدير:

  • إكسل (.xlsx)

  • PDF (.pdf)

  • CSV - صيغة الاتحاد الأوروبي (مفصولة بفاصلة منقوطة)

  • CSV - صيغة الولايات المتحدة (مفصولة بفاصلة)

يحتوي الملف المُصدَّر على جميع السجلات التي تطابق عوامل التصفية الحالية لديكم. قوموا بتطبيق عوامل التصفية قبل التصدير لتضييق نطاق البيانات.

سجل التصدير

يتم تسجيل كل عملية تصدير. يمكنكم عرض عمليات التصدير السابقة من الإجراءات ‣ سجل التصدير في طريقة عرض القائمة المقابلة. من هناك يمكنكم إعادة تنزيل الملفات المُصدَّرة سابقاً.

استيراد البيانات

لاستيراد البيانات، انتقل إلى طريقة عرض القائمة وانقر على الإجراءات ‣ استيراد. يفتح هذا نافذة الاستيراد حيث يمكنكم رفع ملف CSV.

تنزيل نموذج فارغ

قبل الاستيراد، قوموا بتنزيل نموذج CSV فارغ من نافذة الاستيراد. النموذج متوفر بصيغتَين:

  • صيغة الولايات المتحدة (مفصولة بفاصلة)

  • صيغة الاتحاد الأوروبي (مفصولة بفاصلة منقوطة)

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

قوموا بملء بياناتكم ابتداءً من الصف الثالث. يمكنكم حذف الأعمدة التي لا تحتاجونها وإعادة ترتيبها حسب الحاجة.

إنشاء سجلات جديدة

لإنشاء سجلات جديدة، اتركوا عمود id فارغاً. سيقوم Gem Logic بتعيين معرِّف تلقائياً لكل سجل جديد عند الاستيراد.

تحديث السجلات الموجودة

لتحديث السجلات الموجودة، ضمِّنوا عمود id مع معرِّف قاعدة البيانات الصحيح للسجل الذي تريدون تحديثه. يمكنكم الحصول على هذه المعرِّفات عن طريق تصدير البيانات الموجودة أولاً.

عندما يحتوي عمود id على قيمة تطابق سجلاً موجوداً، سيقوم Gem Logic بتحديث ذلك السجل بالقيم من صف CSV بدلاً من إنشاء سجل جديد.

نصيحة

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

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

يتم تسجيل كل عملية استيراد. يمكنكم عرض عمليات الاستيراد السابقة من الإجراءات ‣ سجل الاستيراد في طريقة عرض القائمة المقابلة. يعرض كل إدخال استيراد الحالة ويتيح لكم تنزيل الملف الأصلي أو تقرير يحتوي على أي أخطاء حدثت.

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

يتبع استيراد المنتجات نفس سير العمل العام كالاستيرادات الأخرى — قوموا بتنزيل نموذج CSV فارغ (صيغة الولايات المتحدة المفصولة بفاصلة أو صيغة الاتحاد الأوروبي المفصولة بفاصلة منقوطة)، املأوا صفوفكم، ثم ارفعوا الملف من Stock ‣ المنتجات ‣ الإجراءات ‣ استيراد.

تفصيلان خاصان بالمنتجات:

  • يتم مطابقة المنتجات الموجودة بواسطة ``item_sku`` وليس بواسطة ``id``. إذا كان item_sku لصف موجوداً بالفعل في Gem Logic، يتم تحديث ذلك المنتج بالقيم من الصف. الصفوف التي تحتوي على item_sku جديد أو فارغ تُنشئ منتجاً جديداً (يتم إنشاء SKU تلقائياً عندما يُترك الحقل فارغاً).

  • صفوف العناوين الأولى في نموذج المنتج محجوزة ويجب عدم تعديلها أو حذفها. يمكنكم حذف الأعمدة التي لا تحتاجونها وإعادة ترتيبها بحرية.

بعد التحميل، تكون حالة كل عملية استيراد مرئية من Actions ‣ Import history، حيث يمكنكم أيضاً تنزيل تقرير الأخطاء للصفوف التي فشلت.

قواعد التسعير في استيراد المنتجات

عند استيراد المنتجات، يتم تعيين التسعير لكل قناة بيع من خلال ثلاثة أعمدة تعمل معاً كثلاثية:

  • price — المبلغ المستخدم في القاعدة (ليس دائماً سعر البيع النهائي)

  • pricing_rule — كيفية حساب سعر البيع من price

  • sales_channel_price — قناة البيع التي ينطبق عليها هذا السعر

يمكنكم تعيين ما يصل إلى 5 ثلاثيات لكل منتج (price، price_2price_5، كل منها مع pricing_rule_* و``sales_channel_price_*`` مطابقين). يتم تجاهل الثلاثيات الفارغة.

القيم المسموح بها لـ pricing_rule

يجب أن يكون عمود pricing_rule واحدة من هذه القيم الأربع — أي قيمة أخرى سترفض الصف:

  • fixed_price — سعر البيع يساوي price كما هو

  • cost_multiplier — سعر البيع هو cost × price (حيث cost هو مجموع تكاليف المعادن والأحجار الكريمة والمكونات للمنتج)

  • price_per_carat — سعر البيع هو price × الوزن الإجمالي بالقيراط للأحجار الكريمة في المنتج

  • cost_based — سعر البيع يساوي تكلفة المنتج؛ يتم تجاهل price

كيفية تطبيق الثلاثية

  • إذا كان price معيّناً و``sales_channel_price`` فارغاً، يتم تطبيق القاعدة والمبلغ على جميع قنوات البيع لذلك المنتج.

  • إذا كان كل من price و``sales_channel_price`` معيّنين، يتم تطبيق القاعدة والمبلغ على تلك قناة البيع فقط. استخدموا الثلاثيات الثانية والثالثة للقنوات الإضافية.

  • إذا كان price فارغاً، لا يتم إجراء أي تغييرات في التسعير لتلك الثلاثية — حتى لو ملأتم pricing_rule أو sales_channel_price.

إعادة الاستيراد لتحديث الأسعار

عند إعادة استيراد المنتجات الموجودة:

  • pricing_rule الفارغ يعيّن القاعدة دائماً إلى fixed_price، سواء للمنتجات الجديدة أو عند تحديث المنتجات الموجودة. إذا كنتم تريدون الاحتفاظ بقاعدة مختلفة (مثل cost_multiplier أو price_per_carat)، املأوا تلك القيمة في عمود pricing_rule.

بعد الاستيراد، يعيد Gem Logic حساب سعر البيع تلقائياً لكل قناة بيع بناءً على القاعدة، لذا لستم بحاجة إلى ملء عمود السعر العادي أيضاً.

أنواع السجلات المدعومة

أنواع السجلات التالية تدعم التصدير والاستيراد:

  • السمات

  • العلامات التجارية

  • الفئات

  • الشهادات

  • المجموعات

  • جهات الاتصال

  • مشتريات العملاء

  • عناوين البريد الإلكتروني

  • قوالب البريد الإلكتروني

  • بطاقات الهدايا

  • الفواتير والإشعارات الدائنة الواردة

  • المواد

  • المذكرات وبنود المذكرات

  • الفواتير والإشعارات الدائنة الصادرة

  • المنتجات

  • مشاريع

  • عروض الأسعار وبنود عروض الأسعار

  • الإصلاحات وبنود الإصلاحات

  • المبيعات وبنود المبيعات

  • شحنات

  • المخازن

  • طلبات الموردين

  • مهام

  • المعاملات