マネーフォワード クラウド(請求書・債権管理)へのCSVインポートでエラーが出る原因と対処(項目番号の一致・前ゼロ落ち・必須項目)
公開:
受注した内容をCSVにまとめて、マネーフォワード クラウドに取り込もうとしたらエラーで止まる。あるいは「読み込んだ件数」と「取り込めなかった件数」が同じで、結局1件も入らない——請求や入金消込の締めが近いときほど、この手のつまずきは焦ります。
この記事では、マネーフォワード クラウドの請求書と債権管理へのCSVインポートでエラーが出る原因と対処を、公式サポートで確認できる範囲に絞って整理します。取り上げるのは、どのプロダクトに取り込むのかの切り分け・エラーの種類の読み分け・項目番号の一致・前ゼロ落ち・マスタとの突き合わせの5つです。
なお、マネーフォワード クラウドは会計・請求書・債権管理・掛け払いなどプロダクトが分かれており、同じ「CSVインポート」でも画面も項目も別物です。この記事は共通して効く準備に絞って書いています。プラン・プロダクトによって画面や項目名が変わるため、実際の手順はお使いのプロダクトのサポートで確認してください。
前提: まず「どのプロダクトに取り込むのか」を確かめる
意外につまずくのが、ここです。「マネーフォワード CSV インポート エラー」で検索すると、クラウド会計の仕訳インポート、クラウド請求書の帳票アップロード、クラウド債権管理のインポーター、掛け払いの取込手順が同じ検索結果に並びます。画面名が似ているため、別のプロダクトの手順を読んだまま作業していて合わない、ということが起こります。
受注業務から見ると、行き先はおおむね次のように分かれます。
| 取り込む先 | 主な用途 | CSVの単位 |
|---|---|---|
| クラウド請求書 | 請求書・見積書などの帳票を作る | 帳票1枚とその明細 |
| クラウド債権管理 | 請求データの管理・入金消込 | 得意先・請求・入金などの明細行 |
| クラウド会計 | 仕訳として記帳する | 仕訳1行 |
自分が作ろうとしているCSVが「帳票を作るためのもの」なのか「債権として管理するためのもの」なのかを先に決めてください。ここが曖昧なまま列を組むと、必須項目が違うため何度作り直しても通りません。
債権管理のエラーは「赤」と「オレンジ」で意味が違う
クラウド債権管理のインポートでは、エラーの色によって扱いが変わります。マネーフォワードの公式サポートによると、赤色のエラーはエラーログの内容をもとに取込設定やデータを修正して再度取り込む必要があるもの、オレンジ色のエラーはエラーログは出力されるものの、そのまま登録できるものとされています。
つまり、ログが出た＝全部やり直し、ではありません。まず色を見て「止まっているのか、通ったうえで注意されているのか」を切り分けると、締め前の手戻りがかなり減ります。以下ではこの2つを分けて見ていきます。
ポイント1: 1件も取り込めないなら「項目番号」と「前ゼロ」を疑う
読み込んだ件数と取り込めなかった件数が同じ、つまり全滅している場合、原因はデータの中身ではなく列の対応であることがほとんどです。公式サポートでは、この状況で確認すべきこととして次の2つが案内されています。
- 項目番号のズレ: 各インポーター取込設定の「項目番号」が、CSVの取込列とすべて一致しているかを確認する。一致していない場合は各インポーター画面の右上にある「取込設定」から取込項目を修正する
- 前ゼロ落ち: Excelで編集したデータの場合、CSVの前ゼロが落ちている可能性がある。特に得意先コードについて元データと相違ないかを確認する
前者は、CSVの1列目・2列目……が、取込設定側で何番の項目に割り当てられているかという対応関係です。出力側で列を1つ増やしたり、備考列を途中に差し込んだりすると、それ以降の列がすべて1つずつずれます。対処は、CSVの出力形式を「毎回まったく同じ列構成」に固定することです。注文書によって項目の有無が違うからといって列を可変にすると、行ごとに列数が変わって対応が破綻します。空欄でよいので、列としては常に出しておくのが安全です。
後者の前ゼロ落ちは、「00123」のような先頭が0のコードをExcelが数値として扱って「123」にしてしまう現象です。得意先コードが変われば、当然マスタと突き合いません。この2つは症状が同じ(全滅)なので、セットで確認してください。
ポイント2: CSVは「保存したら開かない」
前ゼロ落ちと並んで多いのが、ファイルの扱いによるつまずきです。公式サポートでは、エラーログすら出力されない場合の確認事項として次が挙げられています。
- Excelのデータは.xlsのままでは取り込めない。Excel上で「名前を付けて保存」から拡張子を「.csv(コンマ区切り)」にして保存する
- CSV保存したファイルは開かず、そのまま取り込む。CSV保存したファイルを再度Excelで開くと、前ゼロが落ちて数値が変化する場合がある
- ダブルクォーテーション(")が得意先名や備考などに含まれていると取り込めないことがあるため、該当行から削除する
- 取込ファイルが1,000KB以上ある場合は空白データが混在している可能性があるため、空白行の削除やデータの分割を検討する
3つ目まではCSVを扱う業務の共通の落とし穴で、基幹システムへのCSV取込でよくあるエラーと対処法でも取り上げています。特に2つ目は見落とされがちです。**「確認のためにもう一度開く」その操作自体がデータを壊します。**中身を確かめたいときは、Excelではなくテキストエディタで開いてください。
ポイント3: マスタに無いものは入らない — 存在しないデータと名称一致
オレンジ色のエラーとして案内されているものの中に、存在しないデータがあります。対処はマスターを確認するか、外部コードを登録することとされています。要するに、伝票側で指定した得意先や商品がマスタ側に無ければ、そのまま素直には入らないということです。
ここで受注業務側にとって重要なのが、クラウド請求書のCSVアップロードでは「取引先名称」を、登録済みの取引先と紐づけるために名前を一致させる必要があるという点です。コードではなく名称で突き合わせる場面があるということは、表記ゆれがそのまま不一致になるということでもあります。
- 「株式会社」と「(株)」の違い
- 全角と半角の違い(「ABC商事」と「ABC商事」)
- 前後に紛れ込んだスペース
- 支店名の有無
人が見れば同じ取引先でも、1文字違えば別物として扱われます。FAXで届く注文書には、そもそも自社の得意先コードは書かれていません。取引先は自分たちの呼び名や品番で書いてくるため、「注文書に書かれた名前・品名 → 自社のコードと正式名称」への変換は、CSVを作る側で済ませておく必要があります。この読み替えを担当者の記憶に頼っていると、担当が変わったときに一気に崩れます。解き方は「あの人しか読めないFAX」— 受注業務の属人化を解く順番で整理しています。
取込の順番も基本は同じで、マスタ(得意先・商品)が先、伝票が後です。新規取引先からの注文をいきなり請求データとして取り込もうとしても、突き合わせる先がありません。
ポイント4: 日付・金額0円・不正な文字
残りは、オレンジ色のエラーログとして公式に案内されている代表的なものです。いずれもデータの「形」の問題で、CSVを作る側で先回りできます。
| エラーの傾向 | 公式に案内されている対処 |
|---|---|
| 日付形式のエラー | 「取込設定」の「属性情報」を正しい形式に変更する |
| 金額が0円 | 1以上を入力するか、取込設定で0円を除外する設定にする |
| 空白の項目がある | データを入力するか、除外設定で対応する |
| 存在しないデータ | マスターを確認するか、外部コードを登録する |
| 取り込めない文字が含まれる | 該当の文字を削除するか、外部コード変換を利用する |
| 入金予定日のエラー | 請求締日より大きい値を入力する |
日付については、取込設定側の「属性情報」で形式を指定する仕組みなので、CSV側の日付表記を1つに統一しておくことが前提になります。「2026/7/1」「2026-07-01」「令和8年7月1日」が混在していると、どの形式を指定しても必ずどれかが外れます。手書きの注文書は日付の書き方が取引先ごとにバラバラなので、ここは特に効きます。日付・単位・全角半角の揃え方はFAX注文書をCSVにする前に整えたい「表記ゆれ」にまとめています。
「取り込めない文字」は、機種依存文字(「①」「㈱」など)や半角カナが典型です。得意先名にこれらが含まれていると、名称の一致にも影響します。
クラウド請求書側で特有の必須項目
帳票そのものをCSVから作る場合、クラウド請求書には固有の必須項目があります。公式サポートで案内されているのは次のとおりです。
- csv_type(変更不可): 見積書は「3」、その他は「4」から始まる数字
- 取引先名称: 登録済みの取引先と紐づける場合は名前を一致させる
- 品目消費税率: 「免税」「非課税」「不課税」「5%」「8%」「軽8%」「10%」のいずれか
- 個人事業主の場合は、品目の源泉徴収(「含む」または「含まない」)も必須
消費税率が決められた文字列のいずれかである、という点には注意してください。「10」や「0.1」ではなく「10%」と書く必要があるということで、自社の販売管理から出したCSVをそのまま流用すると、ここだけ形式が合わないことがあります。
また、サンプルCSVが「サンプルCSV」タブからダウンロードでき、品目の並びを「縦並び」「横並び」から選べます。ゼロから列を組み立てるより、このサンプルを雛型にして自社のデータを流し込むほうが確実です。アップロード結果は、アップロードしたユーザー宛に送信されるメールで確認する形になっています。
つまずきを減らす進め方
| 手順 | やること |
|---|---|
| 1 | どのプロダクト(請求書/債権管理/会計)に取り込むのかを決める |
| 2 | サンプルCSVをダウンロードし、それを雛型にして列構成を固定する |
| 3 | 得意先・商品のマスタを先に整え、注文書の呼び名からコード・正式名称に変換できる状態にする |
| 4 | まず1件だけ取り込み、エラーの色(赤/オレンジ)とログを確認する |
| 5 | 通ったら同じ形式でまとめて取り込む。以後、列構成は変えない(変えるなら取込設定も直す) |
いきなり全件を取り込むと、同じ原因のエラーが何十行も並んで根っこが見えにくくなります。1件通れば、形式が同じである限り再現します。
他社の販売管理ソフトを併用している場合は、弥生販売へのCSV取込でエラーが出る本当の原因や販売大臣(応研)のCSVインポートでエラーが出る原因と対処もあわせて参考にしてください。取込の作法は製品ごとに違います。
手前味噌の紹介
この記事を書いているのは、注文書特化サービス注文書係(ちゅうもんしょがかり)の運営者です。FAX・手書きの注文書をアップロードするとAIが下書きを作り、担当者は自信のない項目だけを確認して確定します。転記にかかる時間を1/10程度に圧縮することを狙ったサービスです。
その先のCSV出力では、列順・列名・文字コードを取込先の形式に合わせて一度登録しておけば、次回から同じ形式で出力されます。列構成が毎回同じに保たれるので、この記事のポイント1で挙げた「項目番号がずれて1件も入らない」つまずきは起こりにくくなります。品目マスタとの突き合わせにも対応しているため、注文書に書かれた品名から自社の商品コード・正式名称への変換もその場で確認できます。
締めのたびにエラーログと格闘している方は、無料トライアル(30枚または14日間、クレジットカード登録不要)で、実際にお使いの帳票との相性を確かめてみてください。いちばん読みにくい取引先の注文書から試していただくのが、相性を判断する近道です。