商奉行(奉行シリーズ)の汎用データ受入でCSV取込エラーが出る原因と対処(必須項目・マスタコード・伝票)
公開:
商奉行の「汎用データ受入」でCSVを取り込もうとしたら、エラーで弾かれた。あるいはエラーは出ないのに、受け入れた伝票を開くと取引先や区分がおかしい——奉行シリーズへのCSV取込でこうしたつまずきに遭遇した方は少なくないはずです。
この記事では、商奉行(奉行シリーズ)の汎用データ受入でCSV取込エラーが出やすい原因を、必須項目・マスタコード・データ形式・伝票のまとまりの4つに分けて整理します。いずれも「データの中身は合っているのに、奉行が期待する形と一致していない」ために起きるもので、原因の当たりがつけば対処はそれほど難しくありません。なお、画面名や項目区分の細部はお使いのバージョン(商奉行i8/iシリーズ、商蔵奉行クラウド等)で異なることがあるため、最終的な確認は同梱のマニュアルや受入記号一覧表で行ってください。
前提: 汎用データ受入は「自社のCSVを奉行の形式に合わせる」仕組み
奉行シリーズの汎用データ受入には、大きく2つの受け入れ方があります。1つは奉行が定める「OBC受入形式」に合わせる方法、もう1つは自社のCSVの列と奉行の項目を1つずつ関連付けて取り込む方法です。OBC(オービックビジネスコンサルタント)の公式手順では、受け入れたい内容の汎用データを一度出力して、それを雛形として加工する進め方が案内されています。
どちらの方法でも共通しているのは、CSV側の1列1列を、奉行のどの項目に対応させるかを決めておく必要があるという点です。FAXや手書きの注文書を手入力・OCRでCSVにする場合、この「対応付け」の前提が崩れているとエラーになります。以下、崩れやすい4か所を順に見ていきます。
原因1: 必須項目(受入記号◎)が空欄・未設定になっている
奉行の汎用データ受入では、項目ごとに「必須かどうか」が決められています。OBCが公開している受入記号一覧表では、項目の区分が記号で示されており、必須の項目が空欄のまま取り込もうとするとエラーになります。
- 症状: 「必須項目が記述されていません」といった趣旨のエラーで取込が止まる
- よくある原因: 受注伝票なら日付・取引先・商品・数量・金額など、伝票を成立させるのに欠かせない項目のどれかが空になっている
- 特にFAX由来で起きやすいのは、注文書に金額が書かれておらず単価・金額欄が空のまま、あるいは日付が「7/23」のように年が省略されていて日付として埋まっていない、というパターンです
対処の基本は、取り込む前に「どの項目が必須か」を受入記号一覧表で確認し、CSV側でその列がすべて埋まっているかを点検することです。必須項目に一件でも空欄があると、その行だけでなく取込全体が止まることもあるため、出力の段階で空欄を残さない運用にしておくと安全です。
原因2: 奉行のマスタに存在しないコードを指定している
奉行シリーズでは、取引先・商品・区分(売上区分・税区分など)をあらかじめマスタとして登録しておき、CSV側はそのコードや名称を参照する形が一般的です。CSVに書かれたコードが奉行側のマスタに存在しないと、値としては正しく見えても取込エラーになったり、意図しない相手に紐づいたりします。
- 症状: 「該当するコードがありません」といった趣旨のエラー、または取引先・商品が空欄や別のものとして受け入れられてしまう
- よくある原因: 取引先名の表記ゆれ(「株式会社」の有無、全角/半角の違い)、新規取引先・新商品のマスタ未登録、コード体系を変えたときの更新漏れ
- 対処: CSVを作る前に、取引先・商品マスタとの突き合わせ(名寄せ)を行う。注文書に新しい取引先・商品が登場したら、CSV作成より先にマスタ登録を済ませておくと取込時のエラーが減ります
原因3: 文字コード・区切り形式・項目のずれ
中身のコードや値が正しくても、ファイルとしての「形」が奉行の想定とずれているとエラーになります。ここでつまずくのは主に次の3点です。
- 文字コード: 国内の販売・会計ソフトはCSVの文字コードとしてShift_JIS(CP932)を前提にしているものが一般的です。ExcelでCSV UTF-8として保存したファイルをそのまま渡すと、日本語の取引先名・商品名が文字化けしたり、機種依存文字(「①」「㈱」など)や半角カナでエラーになることがあります
- 区切り形式: 汎用データ受入では、CSV(カンマ区切り)かテキスト(タブ区切り)かを取込側の設定と合わせる必要があります。商品名や住所にカンマが含まれているのに囲み文字(ダブルクォート)で括られていないと、列がずれて別の項目に値が入ってしまいます
- 列順・列数: 関連付けの設定とCSVの列の並び・数が食い違うと、金額の列に数量が入るといったずれが起きます。ヘッダー行の有無の指定を間違えると、見出しの文字を1件目のデータとして読んでしまうこともあります
これらは「取り込んでみて初めてエラーで分かる」ことが多く、注文書を読み取った直後の段階では気づきにくいのが実務上の悩みどころです。
原因4: 伝票としてのまとまり(伝票番号・明細行)が崩れている
受注伝票のように「1枚の伝票に複数の明細行がぶら下がる」データは、行ごとの値が正しくても、伝票としてのまとまり方が崩れているとうまく受け入れられないことがあります。
- 同じ伝票に属する明細のはずなのに、伝票番号や日付・取引先が行ごとに微妙に違っていて、別々の伝票として分割されてしまう
- 逆に、別の注文なのに伝票番号が重複していて、1つの伝票にまとめられてしまう
- 明細行だけあってヘッダー相当の情報が欠けている、または集計(伝票合計)がCSV側の明細合計と合わない
FAXの注文書を複数枚まとめて手入力・OCRする際は、どの明細がどの伝票のものかという「くくり」が崩れやすくなります。取り込む前に、伝票番号ごとに明細が正しくまとまっているか、1件だけサンプルで受け入れて中身を確認しておくと、まとめて取り込んでからの手戻りを防ぎやすくなります。
まとめて確認するチェックリスト
商奉行の汎用データ受入にCSVを渡す前に、次の4点を確認しておくとエラーの多くを未然に防げます。
| 確認項目 | チェックポイント |
|---|---|
| 必須項目 | 受入記号一覧表で必須とされた項目が、CSVの全行で埋まっているか |
| マスタコード | 取引先・商品・区分のコードや名称が、奉行側のマスタに登録済みか |
| 文字コード・区切り | Shift_JIS(CP932)で保存され、カンマ区切り/タブ区切りが設定と一致しているか |
| 伝票のまとまり | 伝票番号ごとに明細が正しくくくられ、列順・列数が関連付け設定と合っているか |
いずれも、細かい仕様はお使いの奉行のバージョンによって変わることがあります。実際の項目区分や受入形式は、同梱のマニュアル・受入記号一覧表で必ず確認してください。
手前味噌の紹介
この記事を書いているのは、注文書特化サービス注文書係(ちゅうもんしょがかり)の運営者です。FAX・手書きの注文書をアップロードするとAIが下書きを作り、担当者は自信のない項目だけを確認して確定します。その先のCSV出力では、文字コード(Shift_JIS/UTF-8)・列順・列名を自社の基幹システムに合わせて一度登録しておけば、次回から同じ形式で出力されるので、取込のたびに形を手直しする手間を減らせます。
品目マスタとの突き合わせにも対応しているため、取引先名や商品コードの表記ゆれによる取込エラーも起きにくくなります。汎用データ受入に渡すCSVを毎回作り直している方は、無料トライアル(30枚または14日間、クレジットカード登録不要)で、実際にお使いの帳票との相性を確かめてみてください。