בלוג

פיצול CSV של קטלוג המוצרים ב־freee Sales לקבצים של 999 רשומות

ייבוא מוצרים ב־freee Sales מוגבל ל־1,000 שורות כולל הכותרת. כך מפצלים ל־999 רשומות נתונים לקובץ, משכפלים כותרת ושומרים על אפסים מובילים בקודי המוצרים.

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

לפיצול CSV של קטלוג המוצרים ב־freee Sales (freee販売), פתחו את CSV Splitter בממשק האנגלי, הגדירו את Maximum data rows per output file ל־999, והפעילו את האפשרות לחזור על הרשומה הראשונה ככותרת בכל קובץ. כך כל קובץ יכיל לכל היותר 999 רשומות מוצרים ושורת כותרת אחת — בסך הכול 1,000 רשומות CSV.

המגבלה אינה חלה על כל סוגי ייבוא ה־CSV של freee. היא מיועדת לייבוא מידע על מוצרים ב־freee Sales. לפי התיעוד הרשמי של ייבוא וייצוא, הגבול הוא 1,000 שורות כולל הכותרת. לייצוא אין אותה מגבלת שורות, לכן לא תמיד ניתן לייבא מחדש קובץ מיוצא גדול כחלק אחד. ההוראות נבדקו ב־21 בנובמבר 2026.

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

מגדירים 999 שורות נתונים ואת הכותרת בנפרד

שמרו את קובץ ה־CSV המקורי והכינו את הנתונים לפי התבנית הרשמית העדכנית והגדרות השדות. המפצל אינו מתרגם שמות עמודות ואינו משנה ערכים לפורמט הדרוש ל־freee.

  1. בחרו קובץ מקומי באמצעות CSV / TSV file to split.
  2. ב־Delimiter בחרו Comma (CSV). פתחו תצוגה מקדימה ובדקו את התווים ביפנית ואת חלוקת העמודות. אם הטקסט משובש, בחרו את Input encoding המתאים לקובץ.
  3. ב־Split by בחרו Maximum number of data rows והזינו 999 ב־Maximum data rows per output file.
  4. הפעילו את Repeat the first record as a header in each output file. שורת הכותרת אינה נכללת ב־999 רשומות הנתונים.
  5. אם אין צורך לשנות קידוד UTF-8, הגדירו ב־Output encoding את Same as input (preserve BOM). אם תבנית היעד דורשת זאת, ניתן לבחור UTF-8 (with BOM); סימון BOM אינו חובה בכל מצב. ב־Output record separator בחרו Same as input (preserve mixed line endings).
  6. ב־Save method בחרו Download one file at a time ולחצו Validate and split.
  7. שמרו כל חלק באמצעות Save this CSV. ודאו שההורדה הסתיימה לפני לחיצה על Confirm download and continue. בדקו גם את הקובץ האחרון ואת סיכום התוצאות.

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

דוגמה: 1,001 מוצרים בדויים מתחלקים ל־999 ול־2 רשומות

נניח שקובץ CSV מכיל 1,001 מוצרים בדויים. הדוגמה הבאה מציגה רק את שלוש הרשומות הראשונות, לא קובץ ייבוא שלם. לנתונים אמיתיים השתמשו בתבנית הרשמית המעודכנת.

名称,帳票・明細への表示名称,コード,販売単価
サンプル商品0001,サンプル商品0001,0001,100
サンプル商品0002,サンプル商品0002,0002,100
サンプル商品0003,サンプル商品0003,0003,100

העמודות ביפנית מציינות שם, שם שמוצג במסמכים, קוד ומחיר מכירה ליחידה. אם הקודים נעים בין 0001 ל־1001, חלוקת products.csv תניב:

קובץ רשומות נתונים כולל כותרת קודי מוצרים
products_part_000001.csv 999 1,000 0001–0999
products_part_000002.csv 2 3 1000–1001

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

בדיקת אפסים מובילים ועמודות ריקות בנפרד

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

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

בודקים תצוגה מקדימה ב־freee לפני הייבוא

ב־freee Sales היכנסו ל־商品一覧 (רשימת מוצרים), בחרו ・・・ → CSVインポート (ייבוא CSV) ואז プレビュー画面へ (תצוגה מקדימה). בדקו את כמות הרשומות, הקודים, השמות והערכים שעומדים להשתנות. אם יש שגיאה, תקנו את המקור ופצלו מחדש; אל תערבבו קבצים ישנים וחדשים.

הנתונים בדוגמה בדויים, וייבוא אמיתי ב־freee Sales לא נבדק. התיעוד הרשמי הוא המקור הקובע לגבי עמודות חובה, הרשאות והגבלות ערכים. בדקו את תוצאות הייבוא בפועל. CSV Splitter של iXam אינו מוצר רשמי של freee ואינו מעיד על שותפות.