ヤフオク売上CSVの文字化け・列ズレを Chrome 拡張で 1 クリック整形 ─ 売上金管理ページに直接ボタンを追加
ヤフオクの売上金管理ページ(salesmanagement.yahoo.co.jp/list)では、月次の取引明細を CSV でダウンロードできます。経理作業や税理士提出のための一次データとして毎月この CSV を扱っている方も多いはずです。
ところが、この CSV は そのまま Excel で開くと文字化け・列ズレが起こりやすい という、地味だけれど無視できない問題があります。毎月「Excel で開く → 文字化け → 文字コードを変えて開き直す → それでも列がズレている」という手順を踏んでいる方は、おそらく多数派です。
この記事では、なぜヤフオクの売上 CSV が Excel で素直に開けないのかを整理し、Chrome 拡張機能 AucKit の v0.2.98 で追加された「売上金管理ページに直接ボタンを埋め込む」アプローチを紹介します。
なぜヤフオクの売上 CSV は Excel で文字化けするのか
ヤフオクからダウンロードできる売上 CSV ファイルは、技術的には標準的な仕様で書かれています。
- 文字コード: UTF-8(BOM なし)
- 改行コード: CRLF
- 区切り: カンマ
- 引用符: ダブルクォート
UTF-8 は世界的に最も使われている文字コードで、Web 上のテキストはほぼ全てこの形式です。
問題は、日本語版の Microsoft Excel が「BOM なしの UTF-8」を正しく判定できない ことにあります。Excel は CSV ファイルを開くとき、ファイル先頭の数バイトを見て文字コードを推測しますが、BOM(Byte Order Mark)というマーカーが先頭に無いと、日本語 Windows 環境では Shift_JIS だと誤判定します。結果、UTF-8 で書かれた日本語が Shift_JIS として読み取られ、化け文字の羅列になります。
「縺ゅz縺?縺?」のような表示を見たことがある方は、まさにこの現象に遭遇しています。
列ズレの原因は「セル内改行」
文字化けを乗り越えても、もう一つの壁があります。商品名や取引メッセージにセル内改行が含まれていると、列がバラバラに崩れる ことです。
CSV の仕様では、フィールド内に改行を含める場合はそのフィールド全体をダブルクォートで囲みます。ヤフオクの CSV もそれに従っています。
ただし、Excel の「CSV を直接ダブルクリックで開く」モードでは、このダブルクォートで囲まれた改行を「行の区切り」と誤読することがあります。1 行のはずの取引データが 2 行や 3 行に分割され、続く列が次の行に流れ込み、表全体が崩れて読めなくなります。
Excel の「データ取り込み」を使えば回避できるが…
Excel には「データ」タブの「テキストまたは CSV から」というインポート機能があり、ここから文字コードと区切りを指定して読み込めば、文字化けも列ズレも回避できます。
これは確かに動作します。ただ、毎月この手順を踏むのは手間ですし、複数のスタッフが担当する場合は「正しい開き方」の手順書を共有しないと、誰かが必ずダブルクリックで開いて崩れた CSV を見ることになります。
そもそも、売上の確認は毎月必ず発生する定型作業です。この程度の操作で毎回つまずく状況自体を、仕組みで解消したい という発想が、AucKit の売上 CSV 整形機能の出発点でした。
解決策の選択肢
ヤフオクの売上 CSV を扱いやすくする手段は、いくつかあります。
(1) Excel のインポート機能を毎回使う
文字コード「UTF-8」を指定して取り込めば、文字化けも列ズレも回避できます。手順が決まっているという利点はありますが、毎月の繰り返しでは手間です。
(2) Web ツール(無料)で整形する
AucKit の売上CSV整形ツール では、CSV をブラウザにドロップするだけで、文字化けせず月次集計済みの帳簿形式で表示できます。インボイス対応や、税理士に渡すための CSV ファイル(3 ファイル zip)としてのダウンロードもできます。
この Web ツール自体の使い方や、表示される項目の詳細については、ヤフオク売上CSVを税理士に渡せる帳簿に整える で別途解説しています。
(3) Chrome 拡張機能で売上金管理ページに直接組み込む(v0.2.98 で追加)
Web ツールの動線をさらに短縮したのが、Chrome 拡張機能 AucKit の v0.2.98 で追加された 売上 CSV 整形ボタン です。
以降では、この拡張機能版の動きと、Web ツール版との違いを解説します。
拡張機能版の動き ─ 売上金管理ページに直接ボタンを埋め込み
ヤフオクの売上金管理ページを開くと、画面に「A AucKitでCSV整形」というボタンが追加されます。位置は、ヤフオク純正の「CSV ダウンロード」リンクの隣です。
このボタンをクリックすると、ヤフオクの画面の上に モーダルウィンドウ が開き、その中に整形済みの売上明細・月次集計・現金振込・キャンセル分が表示されます。別タブを開く必要も、CSV ファイルをダウンロードして別のツールに読み込ませる必要もありません。
モーダル内には、Web ツール版と同じ表示が出ます。
- 月次集計(売上合計・決済金額合計・落札システム利用料・販売手数料・送料)
- 売上明細(取扱日・商品名・落札価格・送料・手数料・差引金額)
- 現金振込(銀行振込で受け取った分)
- キャンセル(キャンセル・返金された取引)
事業者名(個人事業主名・屋号・法人名)を入力すれば、印刷時のヘッダーに表示されます。一度入力した事業者名はブラウザの保存領域に記録され、次回からはそのまま復元されるので、毎月入力する必要はありません。
Web ツール版との違い
| 項目 | Web ツール版 | 拡張機能版(v0.2.98) |
|---|---|---|
| 入力 | CSV ファイルをドラッグ&ドロップ | 売上金管理ページのボタンをクリック |
| 別タブ | 必要(tools/sales-report/ を開く) | 不要(ヤフオク画面内で完結) |
| ダウンロード | あり | あり(モーダル内から) |
| 印刷 / PDF | あり | あり |
機能としては同じ整形結果ですが、「ヤフオクを開いていて売上を確認したくなった瞬間、その場で見られる」 という動線の違いがあります。Web ツール版が「ファイルを処理するための場所」なのに対し、拡張機能版は「いつもの作業の中にある機能」になります。
印刷 / PDF / CSV ダウンロード
モーダル内には次の3つのアクションがあります。
- 印刷 / PDF 保存: A4 縦の帳簿風レイアウトで印刷できます。事業者名・期間・月次集計・売上明細・現金振込・キャンセルが 1 つの帳簿として出力されます。
- 整形CSV をダウンロード: 文字コードを Shift_JIS に変換した CSV ファイルを 3 ファイル(売上明細・現金振込・キャンセル)まとめて zip でダウンロードできます。これなら Excel で素直に開けます。
- モーダルを閉じる: 確認だけしたい場合は、そのまま閉じれば元の売上金管理ページに戻ります。
設定画面で ON/OFF 可能
拡張機能の設定画面の「マイオク・出品画面」カテゴリに 「売上金CSV整形ボタン」 という項目が追加されています。デフォルトは ON ですが、不要であれば OFF にできます。
OFF にした場合、売上金管理ページからボタンが消え、ヤフオク純正の表示のみになります。
まとめ
ヤフオクの売上 CSV は、技術的には標準的な UTF-8 CSV ですが、日本語版 Excel との相性問題で「ダブルクリックで開いて文字化けする」「セル内改行で列がズレる」というトラブルが起きがちです。
毎月発生する経理作業で、この種の「仕様を知っていれば回避できるけれど面倒」な操作を繰り返すのは時間の使い方として惜しいです。
Web ツール版に加えて、v0.2.98 で Chrome 拡張機能の AucKit から、売上金管理ページに直接整形ボタンを組み込めるようになりました。ヤフオクの売上を確認するたびに、別タブで CSV を開き直して文字化けと戦っている方は、ぜひお試しください。
AucKit を Chrome ウェブストアからインストール