דלגו לתוכן

ייבוא CSV

מילון המסחר האלקטרוני

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

קובץ לדוגמה לפני קובץ מלא

ספק כלי מטבח שולח רשימה הכוללת מספר פריט, שם בעברית, קוטר, כמות בקרטון ומספר קרטונים זמינים. החנות מוכרת מחבתות בודדות וזקוקה ליתרה ביחידות. אם בעמודת זמינות מופיע המספר חמש, ייתכן שמדובר בחמישה קרטונים של שש מחבתות כל אחד. בקשו מהספק להסביר שורה אחת מפריט שכולם מכירים והשוו אותה למוצר שעל המדף. בעמודה שכותרתה „גודל” עשוי להופיע בחלק מהמקרים קוטר המחבת ובמקרים אחרים גודל האריזה. שם העמודה הוא נקודת התחלה לבירור, לא הוכחה למשמעות הנתונים.

צרו קובץ עבודה קטן הכולל פריט קיים לעדכון, פריט חדש וגרסה שדומה לפריט אחר. הוסיפו רשומה עם מק״ט שמתחיל באפס, שם עם פסיק ותיאור בעברית שמכיל מירכאות. פריטים פשוטים מדי אינם מגלים מה קורה כאשר תוכן אמיתי פוגש את קורא הקובץ. שמרו עותק מקורי של הקובץ שהתקבל לפני פתיחתו בגיליון. תוכנה משרדית עלולה להמיר קוד ארוך למספר, תאריך לטיפוס אחר או מק״ט עם אפס מוביל לערך מקוצר. אם הערך כבר הומר ונשמר, שינוי העיצוב של התא לא תמיד יחזיר את המידע שאבד.

מפריד, גרשיים וקידוד

קובץ CSV נפוץ משתמש בפסיק להפרדת שדות. קיימים גם קבצים שמכונים באותו שם ומשתמשים במפריד אחר. אם כל השורה מופיעה בתצוגה המקדימה בעמודה אחת, בדקו את המפריד שהוגדר לפני שמנסים לחלק את הטקסט ידנית. בשם מוצר כמו „מחבת, סדרה מקצועית” הפסיק הוא חלק מהשם. בפורמט המשתמש בפסיקים, שדה כזה יכול להיות עטוף במירכאות כדי שהקורא ידע להשאיר אותו יחד. גם שדה שמכיל מעבר שורה או מירכאות עשוי לדרוש טיפול בהתאם לכללים שבהם הקובץ נכתב ונקרא.

עברית משובשת יכולה להצביע על חוסר התאמה בקידוד. צפו בשם היצרן ובתיאור המוצר בתצוגה המקדימה וגם בעמוד הציבורי אחרי קליטת המדגם. אם המק״ט נראה תקין והעברית הפכה לרצף סימנים, העובדה שהייבוא הסתיים אינה מעידה שהוא הצליח מבחינה עסקית. בדקו גם ערכים מעורבים, למשל מספר דגם באותיות לטיניות לצד תיאור בעברית. שמרו את הגדרות הקידוד והמפריד בצמוד לשם הספק. כאשר מתקבל קובץ בחודש הבא, אפשר לבדוק אם המבנה השתנה במקום להסתמך על הבחירה האחרונה שנשארה במסך.

לפי מה מעדכנים מוצר קיים?

שם מוצר עשוי להשתנות בין קבצים גם כשהמחבת נשארה זהה. ספק שהוסיף לשם את המילים „ציפוי חדש” לא בהכרח יצר דגם חדש. בחנות שבה המק״ט יציב, הוא מועמד מתאים למפתח התאמה. אם קודים ייחודיים רק בתוך כל ספק, ייתכן שצריך להתחשב גם בזהות הספק. ודאו שהמפתח מזהה את רמת הרשומה הנכונה. קוד של משפחת מחבתות אינו מספיק לעדכון יתרה של מחבת בקוטר עשרים ושמונה סנטימטרים אם לאותה משפחה יש עוד שלושה קטרים.

הגדירו מדיניות לכל מקרה שבו אין התאמה. בקובץ קטלוג ראשוני, יצירת מוצר חדש יכולה להיות המטרה. בקובץ מלאי יומי, קוד לא מוכר עשוי להצביע על טעות או על מוצר שעדיין לא הוכן למכירה. יצירת עמוד ציבורי ריק עם שם חלקי ויתרה בלבד עלולה להפיק תוצאה גרועה יותר מהשהיית השורה לבירור. בקשו דוח שמפריד בין רשומות חדשות, רשומות שהתעדכנו ורשומות שלא נקלטו. כך תוכלו לבדוק במהירות מדוע קובץ שהיה אמור לעדכן מאה מוצרים יצר תשעים ותשעה חדשים.

מה פירוש תא ריק?

תא ריק בעמודת המשקל יכול להיות „אין לי עדכון”, „המידע אינו ידוע” או „נא למחוק את הערך הקיים”. אלה משמעויות שונות ויש לבחור אחת לכל מסלול ייבוא. אם קובץ הספק נועד לעדכן רק מלאי, אל תתנו לעמודת תיאור ריקה למחוק תיאור בעברית שהחנות כתבה בעצמה. בנו מיפוי שבו מעדכנים רק את השדות שהקובץ אחראי להם. בדקו בנפרד ערך אפס, תא ריק ועמודה שחסרה לגמרי. כמות אפס יכולה להיות עדכון קריטי שצריך להפסיק מכירה, ובעמודה חסרה ייתכן שפשוט אין מידע חדש.

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

איך בודקים ייבוא שנקטע?

חיבור יכול להיסגר לאחר קליטת חלק מהשורות. בדוח התקדמות בדקו אילו רשומות הושלמו ומה קורה אם מריצים את אותו קובץ שוב. אם הנתון מייצג יתרה סופית של שלושים יחידות, הרצה חוזרת אמורה להשאיר שלושים יחידות. אם מדובר בתוספת משלוח של שלושים יחידות, הפעלה חוזרת עלולה להוסיף אותן שוב. לפני חידוש עבודה חלקית צריך להבין איזה סוג עדכון הופעל. שמרו מזהה קובץ או אצווה ודוח שורות כדי שתהיה דרך להבחין בין חידוש אותה עבודה לבין משלוח אמיתי חדש.

בדיקת התוצאה באתר

פתחו שלושה מוצרים מהמדגם וחפשו אותם כפי שקונה היה מחפש. בחרו קוטר, בדקו זמינות והוסיפו לעגלה. ודאו שהעדכון גרם לשינוי המתוכנן גם במסננים ובמסמכי העבודה. מוצר יכול להיקלט בעמוד הנכון אך להיעלם ממסנן קוטר כי הנתון הוזן כטקסט הכולל יחידת מידה במקום מספר. בדקו גם מוצר שלא נכלל בקובץ כדי לוודא שהפעולה השאירה את המידע שלו במצב המתוכנן. ההשוואה הזאת תופסת טעויות שמספר השורות שנקלטו אינו יכול לגלות.

בסיום שמרו יחד את קובץ המקור, תיאור המיפוי, תוצאות המדגם וסיכום הקליטה המלאה. כתבו אילו חריגים דורשים מענה מהספק ומי יבדוק את הקובץ הבא. אם מחר מופיעה מחבת בקוטר שגוי, תוכלו לשחזר האם השגיאה הייתה בנתון המקורי, בהמרה או בהגדרת השדה בחנות. כך ייבוא הקטלוג הופך לתהליך שאפשר לתחזק גם כשמתחלף עובד וגם כשהספק משנה את התוכנה שמפיקה את הקובץ.

שאלה שימושית לפני שמאשרים אוטומציה קבועה היא מה יקרה ביום שבו הספק יוסיף עמודה חדשה באמצע הקובץ. אם ההתאמה מתבצעת לפי סדר העמודות, שדה חדש עלול להזיז את כל הערכים שאחריו. אם ההתאמה מתבצעת לפי שמות, שינוי קל בכותרת יכול לגרום לכך ששדה חשוב לא ייקרא. בקשו להדגים את שני המצבים במדגם קטן והגדירו הודעה ברורה כאשר המבנה שונה מהמצופה. עדיף לקבל בקשה לבדיקה מאשר לגלות בסוף היום שעמודת הכמות נקראה בטעות כעמודת הקוטר.