معاہدے کی 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 فائل میں تمام کالم شامل کیے جانے چاہئیں، اور تمام فیلڈ درکار ہیں جب تک کہ بصورت دیگر بیان نہ کیا گیا ہو۔
| کالم | تفصیل |
|---|---|
| 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 میں شامل کرنے کی ضرورت ہے۔
- اگر آپ کی تھرڈ پارٹی سبسکرپشن ایپ میں ایکسپورٹ کا فیچر نہیں ہے، یا اگر ایکسپورٹ کردہ ڈیٹا میں تمام مطلوبہ ڈیٹا شامل نہیں ہے، تو سپورٹ کے لیے ایپ کے ڈیولپر سے رابطہ کریں۔
اقدامات:
اپنے Shopify ایڈمن سے، ایپ > Subscriptions پر جائیں۔
کانٹریکٹ پر کلک کریں۔
امپورٹ پر کلک کریں۔
فائل شامل کریں پر کلک کریں، اور پھر وہ CSV فائل منتخب کریں جسے آپ امپورٹ کرنا چاہتے ہیں۔
فائل اپ لوڈ کریں پر کلک کریں۔
آپ کی CSV فائل اپ لوڈ ہونے کے بعد، آپ کو اپنے Shopify سٹور کو سیٹ اپ کرنے کے لیے استعمال ہونے والے ای میل اکاؤنٹ پر Shopify کی جانب سے ایک تصدیقی ای میل موصول ہو گی۔ کسی بھی امپورٹ کے مسئلے کو حل کرنے میں مدد کے لیے عام امپورٹ کی خرابیوں کے حل پڑھیں۔
CSV فائل استعمال کر کے کانٹریکٹ ایکسپورٹ کریں
آپ اپنے ریکارڈ کے لیے یا کسی دوسرے Shopify سٹور میں امپورٹ کرنے کے لیے اپنے کانٹریکٹ ایکسپورٹ کر سکتے ہیں جہاں آپ نے Shopify Subscriptions ایپ انسٹال کی ہے۔
اقدامات:
اپنے Shopify ایڈمن سے، ایپ > Subscriptions پر جائیں۔
کانٹریکٹ پر کلک کریں۔
ایکسپورٹ پر کلک کریں۔