استيراد وتصدير ملف CSV للعقد

يمكنك استخدام ملف CSV (القيم المفصولة بفواصل) لاستيراد العقود من تطبيق اشتراكات تابع لجهة خارجية إلى تطبيق Shopify Subscriptions، أو لتصدير العقود من تطبيق Shopify Subscriptions.

لمعرفة المزيد حول كيفية استخدام ملفات CSV، راجع فتح ملف CSV وتعديله.

تنزيل ملف CSV نموذجي

يمكنك تنزيل وعرض ملف CSV نموذجي للعقد لاستخدامه كقالب.

اعتبارات متعلقة بملف CSV للعقد

قبل استخدام ملف CSV للعقد لاستيراد العقود، راجع الاعتبارات التالية.

تنسيق ملف CSV

لكي يتم استيراد ملف CSV للعقد الخاص بك بشكل صحيح، تحقق من استيفائه للمعايير التالية:

  • يجب أن يكون السطر الأول من ملف CSV للعقد الخاص بك عبارة عن رؤوس أعمدة كما هو محدد في جدول وصف ملف CSV للعقد.
  • يجب فصل كل عمود بفاصلة.
  • يمكن أن يصل حجم ملف CSV إلى 10 ميغابايت كحد أقصى.

فهم عمود المقبض

يُستخدم المقبض للتعرف على كل عقد بشكل فريد. تُستخدم المقابض لإدارة البيانات بالطرق التالية:

  • تجميع العقود ذات البنود المتعددة: يتم تجميع العقود التي تحتوي على بنود متعددة بواسطة مقبض مشترك.
  • منع العقود المكررة: يتم تجاهل العقود المكررة عند الاستيراد. إذا تم استيراد صف بنفس المقبض بنجاح في وقت سابق، فسيتم تخطي هذا الصف في عملية الاستيراد الجديدة. تساعد هذه الآلية في تجنب تكرار البيانات.

العقود ذات البنود المتعددة

تتطلب العقود التي تتضمن بنودًا متعددة صفًا منفصلاً لكل بند، ويتم تجميعها معًا باستخدام عمود handle.

على سبيل المثال، إذا كان العقد يحتوي على ثلاثة بنود، فيجب إضافة كل بند في صف منفصل. يحتوي الصف الأول على جميع معلومات العقد، ويحتوي الصفان التاليان فقط على القيم في الأعمدة التالية:

  • handle
  • line_variant_id
  • line_quantity
  • line_current_price
  • اختياري: line_selling_plan_id
  • اختياري: line_selling_plan_name

يجب أن يكون المُعرِّف متطابقًا في جميع الأعمدة الثلاثة. ويجب أن تكون كافة الأعمدة الأخرى في الصفين الثاني والثالث فارغة. يمكنك تنزيل قالب CSV النموذجي لمراجعة مثال على عقد يحتوي على عناصر سطر متعددة.

وصف ملف CSV

تندرج المعلومات المُستخدمة في ملف CSV للعقود ضمن الفئات التالية:

  • اسم العقد
  • معلومات العميل والفوترة
  • طريقة ومعلومات التسليم
  • العناصر المضمّنة في الاشتراك

يجب إضافة جميع الأعمدة إلى ملف CSV حتى يتم الاستيراد بشكل صحيح، وتُعد جميع الحقول مطلوبة ما لم يُذكر خلاف ذلك.

وصف الأعمدة في ملف CSV للعقد.
العمودالوصف
Handleالمُعرِّفات هي مُعرِّفات فريدة لكل عقد. على سبيل المثال، red-shirt. يمكن أن تحتوي المُعرِّفات على أحرف وأرقام، وعادةً ما تكون سلسلة مجمّعة من الأحرف أو الأرقام أو كليهما. يجب أن يكون لكل عقد مُعرِّف فريد.
upcoming_billing_dateتاريخ الفوترة القادم للعقد.
الوقت بالتوقيت العالمي المنسق (UTC)، ويجب تنسيقه على النحو التالي YYYY-MM-DDTHH:MM:SSZ.
على سبيل المثال، يتم تمثيل الساعة 3:50 مساءً في 7 سبتمبر 2019 بالمنطقة الزمنية للتوقيت العالمي المنسق (UTC) على النحو التالي 2019-09-07T15:50:00Z.
يجب تعيين قيمة تاريخ الفوترة القادم إلى تاريخ ووقت لا يقلان عن 24 ساعة بعد تاريخ ووقت استيراد ملف CSV.
customer_idمُعرّف العميل. يجب أن يتطابق المُعرّف مع مُعرّف عميل حالي في Shopify admin لديك، ويجب أن يكون سلسلة من الأرقام. على سبيل المثال 6320530986896.
currency_codeرمز عملة العقد. يجب أن يتطابق رمز العملة مع عملة نشطة في متجرك.
statusحالة العقد. يمكن أن يكون للعقود إحدى الحالات التالية:
  • نشط
  • متوقف مؤقتًا
cadence_intervalوتيرة تسليم الاشتراك. يمكن أن يتضمن العقد إحدى فترات التكرار التالية:
  • أسبوع
  • شهر
  • سنة
cadence_interval_countوتيرة تسليم الاشتراك ضمن الفترة الزمنية الإجمالية. على سبيل المثال، يبلغ عدد فترات التكرار لكل شهر 1، وفترة التكرار لكل أسبوعين هي 2.
customer_payment_method_idمُعرّف طريقة الدفع التي يستخدمها العميل للعقد. هذا المُعرّف هو رمز أبجدي رقمي فريد. على سبيل المثال، 24e8c839c47ef47d30ad28346d130e74.
delivery_priceسعر التسليم بـ تنسيق العملة الصحيح.
delivery_method_type طريقة تسليم الاشتراك. يجب أن تكون طريقة التسليم إحدى الأنواع التالية:
  • الشحن
  • التوصيل المحلي
  • الاستلام
  • لا شيء
delivery_address_first_nameالاسم الأول للمستلم في عنوان التسليم. هذا الحقل مطلوب لطريقتي الشحن والتوصيل المحلي فقط.
delivery_address_last_nameالاسم الأخير للمستلم في عنوان التسليم.
هذا الحقل مطلوب فقط لطريقتي الشحن والتوصيل المحلي.
delivery_address_address1السطر الأول من عنوان التسليم.
هذا الحقل مطلوب فقط لطريقتي الشحن والتوصيل المحلي.
delivery_address_address2السطر الثاني من عنوان التسليم.
هذا الحقل مطلوب فقط إذا كان العنوان يحتوي على حقل ثانٍ، وكانت طريقة التسليم هي الشحن أو التوصيل المحلي.
delivery_address_cityالمدينة في عنوان التسليم.
هذا الحقل مطلوب فقط لطريقتي الشحن والتوصيل المحلي.
delivery_address_province_codeرمز أيزو (ISO) الخاص بالمقاطعة أو الولاية في عنوان التسليم.
هذا الحقل مطلوب فقط لطريقتي الشحن والتوصيل المحلي.
delivery_address_country_codeرمز أيزو (ISO) الخاص بالبلد في عنوان التسليم.
هذا الحقل مطلوب فقط لطريقتي الشحن والتوصيل المحلي.
delivery_address_companyاسم الشركة في عنوان التسليم.
هذا الحقل مطلوب فقط إذا كان الطلب لنشاط تجاري، وكانت طريقة التسليم هي الشحن أو التوصيل المحلي.
delivery_address_zipالرمز البريدي لعنوان التسليم.
هذا الحقل مطلوب فقط لطريقتي الشحن والتوصيل المحلي.
delivery_address_phoneرقم الهاتف في عنوان التسليم -- على سبيل المثال +1 (613) 555-5555.
هذا الحقل مطلوب فقط لطريقتي الشحن والتوصيل المحلي.
delivery_local_delivery_phoneرقم الهاتف في عنوان التسليم.
هذا الحقل مطلوب للاشتراكات التي تستخدم طريقة التوصيل المحلي.
delivery_local_delivery_instructionsتعليمات التوصيل المحلي.
لا يلزم تضمين هذا الحقل إلا عند توفير تعليمات للاشتراكات التي تستخدم طريقة التوصيل المحلي.
delivery_pickup_method_location_idمُعرّف الموقع لطريقة الاستلام.
هذا الحقل مطلوب فقط للاشتراكات التي تستخدم طريقة الاستلام المحلي.
line_variant_idمُعرّف كل بند (line item) مضمّن في الاشتراك -- على سبيل المثال 53154087005812.
إذا كانت هناك بنود متعددة مضمّنة في الاشتراك، فيجب إضافة كل بند كسطر جديد باستخدام مُعرّف المتغير (variant ID) الفريد.
line_quantityكمية كل بند مضمّن في الاشتراك.
إذا كانت هناك بنود متعددة مضمّنة في الاشتراك، فيجب أن تكون الكمية المضافة خاصة بهذا البند المعين، وليس إجمالي كمية جميع العناصر المضمّنة.
line_current_priceسعر عنصر سطر الاشتراك بـ تنسيق العملة الصحيح.
line_selling_plan_idمُعرّف خطة الاشتراك -- على سبيل المثال 3607724288.
هذا الحقل اختياري.
line_selling_plan_nameاسم خطة الاشتراك.
هذا الحقل اختياري.

استيراد العقود باستخدام ملف CSV

يمكنك استخدام ملف CSV لاستيراد العقود الحالية من تطبيق اشتراك خارجي مؤهل من Shopify App Store، أو من تطبيق Shopify Subscriptions في متجر آخر.

لا يمكن استخدام ملف CSV لتعديل العقود الحالية أو الكتابة فوقها. يتم تجاهل النُسخ المكررة من العقود الحالية عند الاستيراد.

استيراد العقود من تطبيق اشتراكات خارجي

قد تتمكن من استيراد العقود من تطبيق اشتراك خارجي. ضع في اعتبارك السلوكيات التالية عند الاستيراد من تطبيق خارجي:

  • إذا لم يكن تطبيق الاشتراكات التابع لجهة خارجية مدمجًا مع Shopify Checkout، فلن تتمكن من استيراد عقودك.
  • لا يمكنك استيراد البيانات مباشرة من تطبيقك التابع لجهة خارجية. تحتاج إلى إضافة بيانات العقد من تطبيقك التابع لجهة خارجية إلى ملف CSV متوافق مع تطبيق Shopify Subscriptions بالتنسيق الصحيح لاستيرادها.
  • إذا كان تطبيق الاشتراكات التابع لجهة خارجية لا يحتوي على ميزة التصدير، أو إذا كانت البيانات المُصدَّرة لا تتضمن جميع البيانات المطلوبة، فـ تواصل مع مطوّر التطبيق للحصول على الدعم.

الخطوات:

  1. من مسؤول Shopify، انتقل إلى التطبيقات > Subscriptions.

  2. انقر على العقود.

  3. انقر على استيراد.

  4. انقر على إضافة ملف، ثم حدد ملف CSV الذي تريد استيراده.

  5. انقر على رفع ملف.

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

تصدير العقود باستخدام ملف CSV

يمكنك تصدير عقودك للاحتفاظ بها في سجلاتك، أو لاستيرادها إلى متجر Shopify آخر قمت بتثبيت تطبيق Shopify Subscriptions عليه.

الخطوات:

  1. من مسؤول Shopify، انتقل إلى التطبيقات > Subscriptions.

  2. انقر على العقود.

  3. انقر على تصدير.