請求書ソフトに CSV で帳票を取り込むときは、ソフトの画面からサンプルの CSV を取り出し、その形のまま値だけを入れます。当社はこれを守らずに、2026 年に 2 回、見積書の取り込みに失敗しました。この記事では、2 回の失敗の原因と、今決めている作り方を紹介します。
当社は、見積書と請求書をマネーフォワード クラウド請求書で作っています。お客様ごとの見積書を AI と一緒に作り、CSV にまとめて取り込む流れです。
1 回目は、一般的な CSV の形で作ったので取り込めませんでした
2026 年 5 月 20 日、お客様にお出しする見積書を、一般的な CSV の形で作って取り込もうとしました。ソフトが決めた 1 列目の番号の列が無い CSV です。取り込みは失敗しました。
このソフトの取り込み用の CSV は、ソフトが決めた形でないと受け付けません。当社が使っている見積書の形(品目を縦に並べる形)では、次の決まりがありました。
| 決まり | 中身 |
|---|---|
| 1 列目 | 「csv_type(変更不可)」という列。サンプルに入っている番号を、そのまま全部の行に入れる |
| 列の数 | 33 列。空の列も省かない |
| 行の種類 | 2 列目の「行形式」で、見積書の行と品目の行を分ける。1 枚の見積書は、見積書の行 1 行と品目の行 1 行以上 |
| 日付 | 「2026/05/20」のように、スラッシュで区切る |
| 品目の税率 | 「10%」「軽8%」「8%」「5%」「免税」「非課税」「不課税」のどれか |
公式の説明では、1 列目には、見積書は 3 から、納品書・請求書・領収書は 4 から始まる数字が入ります。この数字は、編集せずに使うものとされています。この列の無い CSV は、何を書いても取り込めません。
この日のうちに、取り込める形をすべて書き出した社内の資料を作りました。列ごとの意味、見積書の行と品目の行で埋める列、サンプルの中身です。
2 回目は、見出しの行だけ別のファイルから写して、改行コードが混ざりました
2026 年 9 月 24 日、別のお客様の見積書を取り込もうとして、「CSV ファイルの読み込みに失敗しました」と表示されました。
原因は、目に見えない改行コードでした。見出しの行(列の名前の行)だけを、前に作ったファイルから写して付けていました。写した見出しの行は CRLF、作った中身の行は LF という、別の改行コードになっていました。1 つのファイルの中で改行コードが混ざると、読み込めません。
1 回目(2026 年 5 月)
- 一般的な CSV の形で作った
- 1 列目の番号の列が無かった
- サンプルと並べれば、違いが目で分かる
2 回目(2026 年 9 月)
- 見出しの行だけ別のファイルから写した
- 見出しは CRLF、中身は LF で改行コードが混ざった
- ファイルを開いても、目では違いが見えない
当社の社内の資料(取り込みの形の記録)から作成
2 回目の方が気づきにくい失敗です。表計算ソフトやテキストの画面で開いても、改行コードの違いは見えません。改行コードの意味は、用語集の改行コードにまとめています。
今は、前に取り込めた CSV を写し、値だけを替えています
2 回の失敗のあと、社内の資料に、前に取り込めた CSV を丸ごと写して値だけを替える、という決まりを足しました。今の作り方は次のとおりです。
- 元を用意する前に取り込めた CSV か、ソフトの画面から取り出したサンプルの CSV を、ファイルごと写す
- 値だけを替える見出しの行と 1 列目の番号は触らず、取引先・件名・日付・品目・単価・数量だけを書き替える
- 数を確かめる全部の行が 33 列か、見積書の行が 1 行と品目の行が 1 行以上あるかを数える
- 改行を確かめる改行コードが 1 種類にそろっているかを確かめる
- 取り込んで見る取り込んだあと、ソフトの画面で金額と取引先を確かめる
1 つ目の「ファイルごと写す」が、2 回の失敗の両方を防ぎます。サンプルや前に取り込めたファイルには、正しい列・正しい番号・そろった改行コードが入っています。そこに新しく足すのは、値だけです。
最後の「画面で確かめる」も外せません。公式の説明では、小計・消費税・合計金額・品目の金額の列は、CSV に入れても画面には反映されないとされています。CSV に書いた合計が合っていても、それがそのまま見積書に載るわけではありません。見積書の金額は、取り込んだあとの画面で確かめるのが確実です。
公式の説明と照らして、ほかにも気をつけていること
| 気をつけること | 公式の説明 | 書くときの扱い |
|---|---|---|
| サンプルの CSV | 画面の「CSV一括追加」からダウンロードする。旧形式のテンプレートはアップロードできない | 古いファイルを使うときは、新しいサンプルと見出しを見比べる |
| 取引先の名前 | 登録してある取引先の名前と一致すると、その取引先に結び付く | 登録してある名前と一字一句同じに書く |
| 取引先の情報の上書き | 結び付いたとき、CSV の住所や担当者の情報で、登録済みの情報が上書きされる | 住所や担当者の欄は、登録済みの情報と同じにするか、空ける |
| 文字の数 | 項目ごとに文字数の目安がある。超えると、取り込めても画面で直せない | 件名や備考を長くしない |
| 取り込んだあと | 取り込んだ人に、結果のメールが届く | メールで結果を確かめてから、画面を開く |
取引先の情報の上書きは、気づかずに起きると困る点です。見積書の CSV に古い住所を書いたまま取り込むと、登録してある取引先の住所まで古いものに変わります。
CSV で帳票を取り込む前に確かめること
- ソフトの画面から、今のサンプルの CSV を取り出した(または、前に取り込めた CSV を写した)
- 見出しの行と 1 列目の番号を変えていない
- 全部の行の列の数が、サンプルと同じ
- 日付と税率の書き方が、決まりどおり
- 改行コードが 1 種類にそろっている
- 文字コードが、サンプルと同じ
- 取引先の名前が、登録してある名前と同じ
- 取り込んだあと、画面で金額と取引先を確かめる
CSV は、ソフトとソフトの間でデータを受け渡す形式です。形が少し違うだけで、受け取る側は読めません。CSV の一般的な扱いは、用語集のCSV・CSV インポート・文字コードにまとめています。当社のAI伴走支援では、見積書や請求書の下書きを AI に任せる作業も、確かめ方と一緒に設定します。



