キャムマックス(クラウドERP)へのCSV取込でつまずくポイント — UTF-8前提・雛型ダウンロード・マスタ取込の順番
公開:
キャムマックスに受注データやマスタをCSVで取り込もうとしたら、エラーで弾かれた。あるいは取り込めたはずなのに、商品コードの先頭の「0」が消えていて別の商品として登録されていた——。クラウドERPへのCSV取込を扱っていると、こうしたつまずきはよく起こります。
この記事では、キャムマックスへのCSV取込でつまずくポイントを、文字コードの前提・雛型の入手方法・マスタと伝票の順番・エラーリストの読み方の4つに分けて整理します。特に最初の文字コードは、国内の販売管理パッケージを長く使ってきた方ほど引っかかりやすいところです。
なお、この記事で製品の仕様として書いているのは、キャムマックスの公式マニュアル(support.cammacs.jp)で確認できる範囲に限っています。画面名や項目はバージョン・契約内容によって変わることがあるため、実際の操作は必ずお使いの環境のマニュアルで確認してください。
つまずき1: 「とりあえずShift_JIS」が通用しない
まず、他の販売管理ソフトからの乗り換え・併用でいちばん引っかかりやすいのがここです。
国内の販売管理パッケージは、日本語を含むCSVをShift_JIS(ANSI)で受け渡す前提のものが少なくありません。そのため受注業務が長い方ほど「日本語のCSVはShift_JISで出しておけば安全」という手が身についています。
ところがキャムマックスの公式マニュアルは、取込用ファイルの保存について**「Excelを名前をつけて保存 > 形式はCSV UTF-8を指定して保存」**と案内しています。つまり、いつもの癖でShift_JISのまま渡すと、得意先名や商品名の日本語が文字化けする可能性があります。
- 症状: 数字や英字は入っているのに、日本語の項目だけが「?」や見慣れない文字の並びになる
- 見分け方: 文字化けは取り込んだ後の画面で気づくことが多いので、まず1件だけ取り込んで日本語が正しく表示されるかを確かめるのが確実です
- 併用している場合の注意: 基幹側はShift_JIS、キャムマックスはUTF-8、というように取込先ごとに求められる文字コードが違うことがあります。「自社の標準はこれ」と決め打ちせず、取込先ごとに文字コードを指定して出力できる状態にしておくのが安全です
文字コードそのものの基本は基幹システムへのCSV取込でよくあるエラーと対処法(文字コード・列順・0落ち)でも整理しています。
つまずき2: 列の並びを推測して作らない — 雛型は本体から取れる
CSV取込のエラーで多いのは、そもそも列の並びが取込側の期待と違っているケースです。これは推測で作ろうとするから起きます。キャムマックスには、推測しなくて済む入手経路が2つ用意されています。
(a) 取込画面の「雛形ダウンロード」を使う
公式マニュアルによると、取込画面には**「雛形ダウンロード」**ボタンがあり、取込用に項目の並びが整備されたCSVファイルを取得できます。受注のように、マスタメンテ以外の取込レイアウトが必要な場面ではこれが基本になります。
(b) 既存データを1件だけExcelでダウンロードして雛型にする(マスタの場合)
マスタを取り込む場合、公式マニュアルは次の手順を推奨しています。
- マスタの一覧画面で対象データを検索する
- CSVボタン横のドロップダウンからEXCELを選んでダウンロードする
- ダウンロードしたファイルを開き、シート全体の書式を「文字列」に変更して上書き保存する
- そのExcel上で取込データを編集する
名前をつけて保存> 形式はCSV UTF-8を指定して保存する
公式マニュアルには「ダウンロードしたデータの項目は取込レイアウトと同一の並びとなっています」と明記されています。つまり、すでに登録されている1件が、そのまま正しい列の並びの見本になるということです。列名や順番を仕様書から書き起こす必要はありません。
この方式にはもう1つ利点があります。手順3の「シート全体の書式を文字列にする」は、公式マニュアルによればExcel特有の動作で値が変わってしまうのを防ぐためのもので、例として**「0001000」が「1000」に変換されてしまう**ことが挙げられています。いわゆる0落ち(先頭ゼロの脱落)です。得意先コード・商品コードで起きると、コードそのものが別物になるため、次の「つまずき3」のマスタ不一致に直結します。エラーにならず静かにコードだけが変わるのが厄介な点なので、雛型を開いた直後に書式を文字列にしておくのが効きます。
なお公式マニュアルでは、データの間に行全体が空白の行を作らないことと、ファイルの1行目に項目タイトルがある場合は取込時に**「先頭行を無視」**を選ぶことも案内されています。雛型をそのまま使うと1行目は見出しになるので、この指定を忘れると見出し行がデータとして取り込まれてしまいます。
つまずき3: マスタが先、伝票が後
受注データのような伝票を取り込むとき、順番を間違えると必ず詰まります。原則は**「マスタ(得意先・商品など)が先、伝票が後」**です。
キャムマックスの受注登録では、公式マニュアルの説明どおり、得意先コードや商品コードを選ぶとマスタに登録された情報をもとに他の入力項目が補完されます。裏を返すと、伝票側で指定したコードがマスタ側に無ければ、その行は成立しません。取り込む前に、注文書に出てくる取引先・商品がすべてマスタに登録されているかを確認してください。
FAXで届く注文書には、そもそも自社のコードが書かれていないのが普通です。取引先は自分たちの呼び名・自分たちの品番で書いてくるため、「注文書に書かれた品名 → 自社の商品コード」への変換は、CSVを作る側で済ませておく必要があります。
- よくある不一致: 取引先名の表記ゆれ(「株式会社」の有無、全角/半角)、新商品のマスタ未登録、コード体系を変えたときの更新漏れ
- 人が見れば同じ取引先でも、コードが1文字違えば別物として扱われます
- この突き合わせを特定の担当者の記憶に頼っていると、その人が休んだ日に受注が止まります。品目マスタ(品番と商品名・別名の対応表)を最新に保つことが、取込エラーを減らす一番効く準備です
属人化の解き方は「あの人しか読めないFAX」— 受注業務の属人化を解く順番でも扱っています。
つまずき4: エラーが出たら「エラーリスト」を読む
キャムマックスの取込は、いきなり登録されるのではなく、チェックを挟む2段構えになっています。公式マニュアルによる流れは次のとおりです。
| 手順 | 操作 | 起きること |
|---|---|---|
| 1 | ファイルを選択する | 取り込むファイルを指定 |
| 2 | アップロードボタン(↑)をクリック | データチェックが行われる |
| 3 | エラーがなければ「登録」をクリック | ここで初めて登録される |
| 4 | エラーが検知された場合 | 「エラーリストダウンロード」で内容を確認し、修正して再実施 |
ポイントは、チェックで止まった段階ではまだ登録されていないことです。エラーが出ても慌てて別の方法を探さず、エラーリストを読んで原因を1つずつ潰すのが最短ルートになります。公式マニュアルによれば、エラーリストは先頭列にエラー内容が出力されるため、どの行のどこを直せばよいかを行単位で追えます。
進め方のコツは、まず1件だけで通してから、まとめて取り込むことです。いきなり数百行を投入すると、同じ原因のエラーが何十行も並んで根っこが見えにくくなります。1件通れば、形式が同じである限り残りも同じように通ります。
つまずきを減らす進め方
ここまでを、実際の作業順に並べると次のようになります。
| 手順 | やること |
|---|---|
| 1 | 取り込むのがマスタか伝票かを決め、マスタなら既存1件のExcelダウンロード、それ以外は取込画面の「雛形ダウンロード」で雛型を用意する |
| 2 | 雛型を開いたらすぐシート全体の書式を「文字列」にする(0落ち防止) |
| 3 | 得意先・商品などのマスタを先に整え、注文書の品名から自社コードへ変換できる状態にする |
| 4 | 1件だけ入れたファイルをCSV UTF-8で保存し、アップロード→チェック→登録まで通す。日本語が化けていないかも画面で確認する |
| 5 | 通ったら同じ形式でまとめて取り込む。以後、列構成と文字コードは変えない |
同じ「CSV取込」でも、ソフトごとに作法はかなり違います。国内パッケージ側の事情は弥生販売へのCSV取込でエラーが出る本当の原因や楽楽販売(ラクス)のCSVインポートでエラーが出る原因と対処、共通する落とし穴は販売管理ソフトへのCSV取込でつまずくポイントでも解説しています。複数のシステムを併用している方は、「どのシステムに、どの文字コードで、どの列順で渡すか」を1枚の表にして残しておくと、担当者が変わっても崩れません。
手前味噌の紹介
この記事を書いているのは、注文書特化サービス注文書係(ちゅうもんしょがかり)の運営者です。FAX・手書きの注文書をアップロードするとAIが下書きを作り、担当者は自信のない項目だけを確認して確定します。転記にかかる時間を1/10程度に圧縮することを狙ったサービスです。
その先のCSV出力では、文字コード(UTF-8 / Shift_JIS)と列順・列名を取込先の形式に合わせて一度登録しておけば、次回から同じ形式で出力されます。この記事のつまずき1で挙げた「基幹はShift_JIS、クラウドERPはUTF-8」という併用時の使い分けも、出力設定として持っておけば毎回考えずに済みます。品目マスタとの突き合わせにも対応しているため、注文書に書かれた品名から自社の商品コードへの変換もその場で確認できます。
取込のたびに文字化けや0落ちと格闘している方は、無料トライアル(30枚または14日間、クレジットカード登録不要)で、実際にお使いの帳票との相性を確かめてみてください。