معاہدے کی CSV کو امپورٹ اور ایکسپورٹ کرنا

آپ فریق ثالث سبسکرپشن ایپ سے معاہدے Shopify Subscriptions ایپ میں امپورٹ کرنے یا Shopify Subscriptions ایپ سے معاہدے ایکسپورٹ کرنے کے لیے CSV (کوما سے الگ کردہ ویلیو) فائل استعمال کر سکتے ہیں۔

CSV فائل استعمال کرنے کے طریقے کے بارے میں مزید جاننے کے لیے، CSV فائل کھولنا اور اس میں ترمیم کرنا دیکھیں۔

نمونے کی CSV فائل ڈاؤن لوڈ کریں

آپ بطور ٹیمپلیٹ استعمال کرنے کے لیے نمونے کی معاہدہ CSV فائل ڈاؤن لوڈ کر کے دیکھ سکتے ہیں۔

معاہدے کی CSV فائل کے لیے تحفظات

معاہدے امپورٹ کرنے کے لیے معاہدہ CSV فائل استعمال کرنے سے پہلے، درج ذیل تحفظات کا جائزہ لیں۔

CSV فائل کی فارمیٹنگ

آپ کی معاہدہ CSV فائل کے درست طریقے سے امپورٹ ہونے کے لیے، تصدیق کریں کہ یہ درج ذیل معیار پر پورا اترتی ہے:

  • آپ کی معاہدہ CSV فائل کی پہلی لائن کالم کے ہیڈر ہونی چاہیے جیسا کہ معاہدہ CSV کی تفصیل کے ٹیبل میں مخصوص کیا گیا ہے۔
  • ہر کالم کو کوما سے الگ کیا جانا لازمی ہے۔
  • CSV فائل کا زیادہ سے زیادہ سائز 10 MB ہو سکتا ہے۔

ہینڈل کے کالم کو سمجھنا

ہینڈل کا استعمال ہر معاہدے کی منفرد شناخت کرنے کے لیے کیا جاتا ہے۔ ہینڈل کو درج ذیل طریقوں سے ڈیٹا مینیج کرنے کے لیے استعمال کیا جاتا ہے:

  • متعدد لائن آئٹم والے معاہدوں کی گروپ بندی: متعدد لائن آئٹم والے معاہدوں کو ایک مشترکہ ہینڈل کے ذریعے گروپ کیا جاتا ہے۔
  • نقلی معاہدوں کی روک تھام: امپورٹ پر نقلی معاہدوں کو نظر انداز کر دیا جاتا ہے۔ اگر اسی ہینڈل والی قطار پہلے کامیابی سے امپورٹ ہو چکی ہو، تو نئی امپورٹ کے عمل میں اس قطار کو چھوڑ دیا جاتا ہے۔ یہ طریقہ کار ڈیٹا کی نقل سے بچنے میں مدد کرتا ہے۔

متعدد لائن آئٹم والے معاہدے

متعدد لائن آئٹم پر مشتمل معاہدوں کے لیے ہر لائن آئٹم کی الگ قطار درکار ہوتی ہے، اور انہیں 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 (Coordinated Universal Time) میں ہے، اور اسے YYYY-MM-DDTHH:MM:SSZ کے طور پر فارمیٹ کیا جانا چاہیے۔
مثال کے طور پر، UTC (Coordinated Universal Time) کے ٹائم زون میں 7 ستمبر 2019 کو دوپہر 3:50 بجے کی نمائندگی 2019-09-07T15:50:00Z کے طور پر کی گئی ہے۔
آئندہ بلنگ کی تاریخ کی ویلیو کو CSV فائل امپورٹ ہونے کی تاریخ اور وقت کے کم از کم 24 گھنٹے بعد کی تاریخ اور وقت پر سیٹ ہونا چاہیے۔
customer_idکسٹمر ID۔ یہ ID آپ کے Shopify admin میں موجودہ کسٹمر کی ID سے مماثل ہونی چاہیے، اور یہ نمبر کی ایک سٹرنگ ہونی چاہیے۔ مثال کے طور پر 6320530986896۔
currency_codeمعاہدے کا کرنسی کوڈ۔ یہ کرنسی کوڈ آپ کے سٹور میں فعال کسی کرنسی سے مماثل ہونا لازمی ہے۔
statusمعاہدے کا سٹیٹس۔ معاہدے کا سٹیٹس درج ذیل میں سے ایک ہو سکتا ہے:
  • فعال
  • موقوف
cadence_intervalسبسکرپشن کی ڈیلیوری کی فریکوئنسی۔ معاہدے کا کیڈینس کا وقفہ (cadence interval) درج ذیل میں سے ایک ہو سکتا ہے:
  • ہفتہ
  • مہینہ
  • سال
cadence_interval_countمجموعی وقت کے وقفے کے اندر سبسکرپشن کی ڈیلیوری کی فریکوئنسی۔ مثال کے طور پر، ہر مہینے کے لیے کیڈینس کے وقفے کی گنتی 1 ہے، اور ہر دو ہفتے کے لیے کیڈینس کا وقفہ 2 ہے۔
customer_payment_method_idمعاہدے کے لیے کسٹمر کی طرف سے استعمال کیے گئے ادائیگی کے طریقے کی ID۔ یہ ID ایک منفرد الفانیومیرک (alphanumeric) کوڈ ہے۔ مثال کے طور پر، 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پک اپ کے طریقہ کار کے لیے مقام کی ID۔
یہ فیلڈ صرف لوکل پک اپ کے طریقہ کار کے ساتھ سبسکرپشنز کے لیے درکار ہے۔
line_variant_idسبسکرپشن میں شامل ہر لائن آئٹم کے لیے ID -- مثال کے طور پر 53154087005812۔
اگر سبسکرپشن میں متعدد لائن آئٹمز شامل ہیں، تو ہر لائن آئٹم کو منفرد ویرینٹ ID کے ساتھ ایک نئی لائن کے طور پر شامل کیا جانا چاہیے۔
line_quantityسبسکرپشن میں شامل ہر لائن آئٹم کی مقدار۔
اگر سبسکرپشن میں متعدد لائن آئٹمز شامل ہیں، تو شامل کی گئی مقدار اسی مخصوص آئٹم کے لیے ہونی چاہیے، نہ کہ شامل کردہ تمام آئٹمز کی کل مقدار۔
line_current_priceسبسکرپشن کے لائن آئٹم کی قیمت درست کرنسی فارمیٹ میں۔
line_selling_plan_idسبسکرپشن پلان کی ID -- مثال کے طور پر 3607724288۔
یہ فیلڈ اختیاری ہے۔
line_selling_plan_nameسبسکرپشن پلان کا نام۔
یہ فیلڈ اختیاری ہے۔

CSV فائل کا استعمال کر کے معاہدے امپورٹ کریں

آپ Shopify App Store کی کسی اہل تھرڈ پارٹی سبسکرپشن ایپ سے، یا کسی دوسرے سٹور پر موجود Shopify Subscriptions ایپ سے موجودہ معاہدے امپورٹ کرنے کے لیے CSV فائل استعمال کر سکتے ہیں۔

موجودہ معاہدوں میں ترمیم کرنے یا انہیں اوور رائٹ کرنے کے لیے CSV فائل کا استعمال نہیں کیا جا سکتا۔ موجودہ معاہدوں کی نقل کو امپورٹ کرتے وقت نظر انداز کر دیا جاتا ہے۔

تھرڈ پارٹی سبسکرپشن ایپ سے معاہدے امپورٹ کرنا

آپ کسی تھرڈ پارٹی سبسکرپشن ایپ سے معاہدے امپورٹ کرنے کے قابل ہو سکتے ہیں۔ تھرڈ پارٹی ایپ سے امپورٹ کرتے وقت درج ذیل باتوں کو مدنظر رکھیں:

  • اگر آپ کی تھرڈ پارٹی سبسکرپشن ایپ Shopify Checkout کے ساتھ مربوط نہیں ہے، تو آپ اپنے کانٹریکٹ امپورٹ نہیں کر سکتے۔
  • آپ اپنی تھرڈ پارٹی ایپ سے براہ راست ڈیٹا امپورٹ نہیں کر سکتے۔ امپورٹ کرنے کے لیے آپ کو اپنی تھرڈ پارٹی ایپ کا کانٹریکٹ ڈیٹا درست فارمیٹ میں Shopify Subscriptions ایپ کے موافق CSV میں شامل کرنے کی ضرورت ہے۔
  • اگر آپ کی تھرڈ پارٹی سبسکرپشن ایپ میں ایکسپورٹ کا فیچر نہیں ہے، یا اگر ایکسپورٹ کردہ ڈیٹا میں تمام مطلوبہ ڈیٹا شامل نہیں ہے، تو سپورٹ کے لیے ایپ کے ڈیولپر سے رابطہ کریں۔

اقدامات:

  1. اپنے Shopify ایڈمن سے، ایپ > Subscriptions پر جائیں۔

  2. کانٹریکٹ پر کلک کریں۔

  3. امپورٹ پر کلک کریں۔

  4. فائل شامل کریں پر کلک کریں، اور پھر وہ CSV فائل منتخب کریں جسے آپ امپورٹ کرنا چاہتے ہیں۔

  5. فائل اپ لوڈ کریں پر کلک کریں۔

آپ کی CSV فائل اپ لوڈ ہونے کے بعد، آپ کو اپنے Shopify سٹور کو سیٹ اپ کرنے کے لیے استعمال ہونے والے ای میل اکاؤنٹ پر Shopify کی جانب سے ایک تصدیقی ای میل موصول ہو گی۔ کسی بھی امپورٹ کے مسئلے کو حل کرنے میں مدد کے لیے عام امپورٹ کی خرابیوں کے حل پڑھیں۔

CSV فائل استعمال کر کے کانٹریکٹ ایکسپورٹ کریں

آپ اپنے ریکارڈ کے لیے یا کسی دوسرے Shopify سٹور میں امپورٹ کرنے کے لیے اپنے کانٹریکٹ ایکسپورٹ کر سکتے ہیں جہاں آپ نے Shopify Subscriptions ایپ انسٹال کی ہے۔

اقدامات:

  1. اپنے Shopify ایڈمن سے، ایپ > Subscriptions پر جائیں۔

  2. کانٹریکٹ پر کلک کریں۔

  3. ایکسپورٹ پر کلک کریں۔