商品ExcelをCSVに変換してみた。Codexで50行を処理し、15行を保留した理由
仕入先から届く商品Excelを、ECに登録するためのCSVへ移す。列を並べ替えるだけに見える仕事でも、品番の先頭ゼロや価格の数式まで扱うと、確認することが増えます。
Dignowaでは、書式の違う架空のExcelを2冊作り、Codexで変換処理を実装・実行しました。入力は合計50行。35行をCSVの候補として出力し、15行を理由付きで保留しました。
この記事はDignowa編集部による実験報告です。実装と実行はCodexが担当しました。実在のECには接続しておらず、出力したのは今回の検証用に決めた8列のCSVです。
手作業での商品データ加工は、公開事例にもある
サイボウズが公開する東急の導入事例には、取引先の商品情報をExcelで受け取り、手作業でCSVにしてシステムへ取り込んでいたことが記載されています。今回扱う仕事の出典は、この東急の公式導入事例です。
東急はDignowaの顧客ではありません。今回のファイルと処理は、この業務課題を参考に独自に作ったものです。公開事例にある導入効果を、今回の成果としては扱いません。
まず、列の順番が違うExcelを2冊作った
A社のファイルは3行目に見出しがあり、「品番、商品名、販売価格」の順です。B社は5行目が見出しで、「掲載、商品コード、詳細」から始まります。それぞれに25行の商品データを入れました。
品番は4桁の文字列、価格は1円以上の整数というルールにしました。同じ「0001」でも仕入先が違えば別商品として扱い、出力する識別子は「A-0001」「B-0001」に分けます。税込・税抜の区分は保持し、金額の換算はしていません。

入力には、価格の空欄、品番の重複、非公開の商品、説明文の改行も入れました。すべてこちらで条件を決めて作ったダミーデータです。
最初の処理は、1行も変換できずに止まった
最初に実行したコードは、Excelを読み終える前にエラーになりました。読み取り専用で開いたシートの「最終行」を使って処理範囲を決めていたのですが、今回作ったファイルでは、その値を取得できなかったためです。
Codexが行を順番に読み取る方法へ修正すると、50行を取り出せました。失敗したコードも残し、同じ入力でエラーを再現しています。これは比較のために仕込んだ不具合ではなく、今回の実装で実際に起きた失敗です。
openpyxlの公式資料にも、読み取り専用モードでシートの使用範囲情報に注意が必要なことが説明されています。Excelファイルであることだけを前提に、最終行が必ず取得できると思い込んでいました。
「0002」に見えても、中身は数値の2だった
A社の品番セルの一つには、数値の2を入れて表示形式を「0000」にしました。見た目は0002ですが、保存された値は2です。今回の処理は、これを文字列の「0002」と同じものとして採用せず、元の品番を確認する行として保留しました。
価格には「=700+80」という数式も入れました。計算済みの値だけ読むと780が取れますが、数式そのものを読むと、固定の価格ではないことが分かります。今回は数式の価格を保留するルールにしました。この780が間違っていた、という結果ではありません。
同じ仕入先で品番「0010」が2行あった箇所も、両方を保留しています。先に出た行を採用するだけでは、どちらの価格を使うのか決められないためです。
出力できた35行と、保留した15行
35行の候補は、商品識別子、仕入先ID、元の品番、商品名、価格、税区分、説明、公開区分の8列にそろいました。このうち33行は元データが公開、2行は非公開です。非公開の2行は、CSVでも非公開を示す0のまま残しています。
保留した15行には、数値セルの品番、数式の価格、必須項目の空欄、重複、価格や公開区分の不備などが含まれます。元のファイル名・行番号・保留理由を一覧にし、どの行を確認すればよいか分かる形にしました。
出力後はCSVを別の読み取り処理で開き、35行すべての8項目を期待値と照合しました。保留した15行も、行番号と理由を照合しています。件数だけが一致した、という確認ではありません。
カンマでつなぐだけでは、説明文の改行を扱えなかった
比較用に、値を単純にカンマでつなぐ処理も実行しました。これは意図的に不十分な方法と比べた検証です。商品説明にカンマや改行が入ると、8列の商品データとして正しく読み戻せなくなりました。
完成版ではPython標準のCSV出力機能を使いました。カンマ、改行、ダブルクォートを含む説明文も、元と同じ文字列に読み戻せています。
文字コードも試しました。UTF-8では出力できた「€」が、CP932では表せずに停止しました。その際、文字を消したCSVや途中までのCSVは残していません。取込先がCP932しか受け付けない場合は、この文字の扱いを別途決める必要があります。
Codexが作った部分と、実行に使った道具
Codexが変換ルールをコードにし、実行結果を見て修正しました。Excelの読み取りにはPythonのopenpyxl、CSVの作成には標準のcsv、出力の照合にはpandasを使っています。生成AIを使った開発ですが、商品ごとの判定は決めたルールをプログラムで実行しています。
同じ入力で再実行した場合は、保存済みの結果を使い、追加のCSVは0件でした。入力が変わった場合や、保存したCSVを書き換えた場合には停止します。古い結果をそのまま上書きせず、違いを確認するための処理です。
CLIは計7回実行し、項目の照合などを含む28の検査を通過しました。エラーで止まるべき条件も含めた検査数であり、28種類の業務を試したという意味ではありません。
ECに登録する前に、まだ確かめることがある
今回確認したのは、2書式50行を決めたルールで変換するところまでです。実際のECの取込形式、画像の登録、既存商品への上書き、登録後の表示は確認していません。Excelアプリ本体での表示・再計算も未検証です。
また、CSVの品番を文字列として出力しても、Excelで直接開く際の自動判定までは制御できません。先頭ゼロを保持できたという結果は、今回の読み取り方法で確認したものです。
実務で進めるなら、次は利用中のECから取込見本を取り出し、その列名と文字コードに合わせます。少数の商品を非公開で試し、価格・税区分・画像・更新対象を管理画面で照合する工程が必要です。今回の35行を、そのまま登録成功とは数えていません。
入力・出力と実行記録
実験結果の一覧には、35行の候補と15行の保留理由を掲載しています。A社の入力Excel、B社の入力Excel、生成したCSVも確認できます。全件が架空データです。
コード・入力・実行記録のZIPと検査結果JSONを用意しました。失敗した最初のコード、文字コードで停止した記録、意図的に不十分なCSVとの比較も含めています。