ייבוא וייצוא של קובץ 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 כדי שהייבוא יתבצע כראוי, וכל השדות הם שדות חובה אלא אם צוין אחרת.
| עמודה | תיאור |
|---|---|
| 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 לעריכה או לדריסה של חוזים קיימים. הייבוא יתעלם מכפילויות של חוזים קיימים.
ייבוא חוזים מאפליקציית מנויים של צד שלישי
ייתכן שתוכל לייבא חוזים מאפליקציית מנויים של צד שלישי. יש לקחת בחשבון את ההתנהגויות הבאות בעת ייבוא מאפליקציה של צד שלישי:
- אם יישום המנויים של צד שלישי שלך אינו משולב ב-Shopify Checkout, לא תוכל לייבא את החוזים שלך.
- אינך יכול לייבא נתונים ישירות מהיישום של צד שלישי שלך. כדי לייבא, עליך להוסיף את נתוני החוזה מיישום הצד השלישי לקובץ CSV התואם ליישום Shopify Subscriptions בפורמט הנכון.
- אם ביישום המנויים של צד שלישי שלך אין תכונת ייצוא, או אם הנתונים המיוצאים אינם כוללים את כל הנתונים הנדרשים, צור קשר עם מפתח היישום לקבלת תמיכה.
שלבים:
מלוח המנהל של Shopify, עבור אל אפליקציות > Subscriptions.
לחץ על חוזים.
לחץ על ייבוא.
לחץ על הוסף קובץ ולאחר מכן בחר את קובץ ה-CSV שברצונך לייבא.
לחץ על העלה קובץ.
לאחר העלאת קובץ ה-CSV שלך, תקבל הודעת אישור בדוא"ל מ-Shopify לחשבון הדוא"ל ששימש להגדרת חנות Shopify שלך. קרא על פתרונות לשגיאות ייבוא נפוצות כדי לעזור לפתור בעיות ייבוא.
ייצוא חוזים באמצעות קובץ CSV
באפשרותך לייצא את החוזים שלך לצורך הרישומים שלך או כדי לייבא אותם לחנות Shopify אחרת שבה מותקן היישום Shopify Subscriptions.
שלבים:
מלוח המנהל של Shopify, עבור אל אפליקציות > Subscriptions.
לחץ על חוזים.
לחץ על ייצוא.