ייבוא וייצוא של קובץ CSV של חוזה

אפשר להשתמש בקובץ CSV (ערכים מופרדים בפסיקים) כדי לייבא חוזים מאפליקציית מינויים של צד שלישי לאפליקציה Shopify Subscriptions או לייצא חוזים מהאפליקציה Shopify Subscriptions.

למידע נוסף על אופן השימוש בקובצי 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 (זמן אוניברסלי מתואם), וחייב להיות מעוצב כ-YYYY-MM-DDTHH:MM:SSZ.
לדוגמה, השעה 15:50 ב-7 בספטמבר 2019 באזור הזמן UTC (זמן אוניברסלי מתואם) מיוצגת כ-2019-09-07T15:50:00Z.
יש להגדיר את ערך תאריך החיוב הקרוב לתאריך ולשעה של לפחות 24 שעות לאחר התאריך והשעה שבהם קובץ ה-CSV מיובא.
customer_idמזהה הלקוח. המזהה חייב להתאים למזהה של לקוח קיים במנהל Shopify, וצריך להיות מחרוזת של מספרים. לדוגמה, 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המזהה עבור כל פריט שורה שנכלל במנוי – לדוגמה 53154087005812.
אם נכללים פריטי שורה מרובים במנוי, יש להוסיף כל פריט שורה כשורה חדשה עם מזהה הגרסה הייחודי.
line_quantityהכמות עבור כל פריט שורה שנכלל במנוי.
אם נכללים פריטי שורה מרובים במנוי, הכמות שנוספה צריכה להיות עבור אותו פריט ספציפי, ולא הכמות הכוללת של כל הפריטים שנכללו.
line_current_priceהמחיר של פריט השורה של המנוי בפורמט המטבע הנכון.
line_selling_plan_idהמזהה של מסלול המנוי – לדוגמה 3607724288.
שדה זה הוא אופציונלי.
line_selling_plan_nameהשם של מסלול המנוי.
שדה זה הוא אופציונלי.

ייבוא חוזים באמצעות קובץ CSV

אפשר להשתמש בקובץ CSV כדי לייבא חוזים קיימים מאפליקציית צד שלישי נתמכת למנויים מ-Shopify App Store, או מאפליקציית Shopify Subscriptions בחנות אחרת.

לא ניתן להשתמש בקובץ CSV לעריכה או לדריסה של חוזים קיימים. הייבוא יתעלם מכפילויות של חוזים קיימים.

ייבוא חוזים מאפליקציית מנויים של צד שלישי

ייתכן שתוכל לייבא חוזים מאפליקציית מנויים של צד שלישי. יש לקחת בחשבון את ההתנהגויות הבאות בעת ייבוא מאפליקציה של צד שלישי:

שלבים:

  1. מלוח המנהל של Shopify, עבור אל אפליקציות > Subscriptions.

  2. לחץ על חוזים.

  3. לחץ על ייבוא.

  4. לחץ על הוסף קובץ ולאחר מכן בחר את קובץ ה-CSV שברצונך לייבא.

  5. לחץ על העלה קובץ.

לאחר העלאת קובץ ה-CSV שלך, תקבל הודעת אישור בדוא"ל מ-Shopify לחשבון הדוא"ל ששימש להגדרת חנות Shopify שלך. קרא על פתרונות לשגיאות ייבוא נפוצות כדי לעזור לפתור בעיות ייבוא.

ייצוא חוזים באמצעות קובץ CSV

באפשרותך לייצא את החוזים שלך לצורך הרישומים שלך או כדי לייבא אותם לחנות Shopify אחרת שבה מותקן היישום Shopify Subscriptions.

שלבים:

  1. מלוח המנהל של Shopify, עבור אל אפליקציות > Subscriptions.

  2. לחץ על חוזים.

  3. לחץ על ייצוא.