Koala Docs

Appearance

Pixiu 明細インポート ​

📋 概要 ​

本ガイドでは、Pixiu から書き出した明細（CSV）を コアラ家計簿 にインポートする手順を説明します。

コアラ家計簿は現在、Pixiu の CSV エクスポート（CSV のみ）に対応しています。

📱 手順 1：Pixiu で明細をエクスポート ​

Pixiu はバージョンによってメニュー名が多少異なりますが、流れは共通です。「データ書き出し/明細書き出し」から期間を選び、CSV で保存します。

手順 1：エクスポート画面を開く ​

  1. Pixiu を開く
  2. 「我的」 を開く
  3. 「数据导出」/「导出账单」（表記は異なる場合あり）を探す

手順 2：期間を選択 ​

  1. 期間（例：直近 1 か月 / 直近 3 か月など）を選ぶ
  2. 確定してエクスポートを開始

💡 ヒント：

  • 1 回のエクスポートは 3 か月以内をおすすめします（ファイルが大きいと解析が遅くなることがあります）。
  • データ量が多い場合は複数回に分けてエクスポートし、分割してインポートしてください。

手順 3：CSV で保存 ​

  1. 形式は CSV を選択
  2. 端末内に保存（共有 → ファイルに保存 など）
  3. 保存先を覚えておく

📱 手順 2：コアラ家計簿にインポート ​

手順 1：インポート画面を開く ​

  1. コアラ家計簿を開く
  2. 「設定」 → 「明細インポート」

手順 2：インポート元を選択 ​

  1. 「インポート元」 をタップ
  2. 「Pixiu」 を選択

⚠️ 重要：必ず Pixiu を選択してください。選択を間違えると検証に失敗したり、列の読み取りがずれることがあります。

手順 3：ファイルを選択 ​

  1. 「ファイルパス」 をタップ
  2. Pixiu から書き出した CSV を選択
  3. ファイル名が表示されることを確認

手順 4：帳本（Ledger）を関連付け ​

  1. 「関連付け帳本」 をタップ
  2. 取り込み先の帳本を選択

手順 5：解析 → プレビュー ​

  1. 右上の 「解析」 をタップ
  2. 成功するとプレビュー画面へ移動
  3. 1 件ずつ編集/削除、または無効な明細をまとめてスキップできます

手順 6：インポート実行 ​

  1. 内容を確認したら 「インポート」 をタップ
  2. 完了まで待つ

📋 Pixiu CSV の形式（参考） ​

コアラ家計簿の検証ポイント：

  • 1 行目はヘッダー必須
  • ヘッダー列数は 10 列
  • 区切りはカンマ ,（標準 CSV）

列定義（順番） ​

列意味説明
1日付yyyy-MM-dd / yyyy/MM/dd に対応。年は 2016 以上が必要（それ以外は無効）
2親カテゴリコアラ家計簿の親カテゴリ名と照合
3取引種別「支出」または「收入」を含む必要あり。「收入」を含む場合は収入として取り込み、それ以外は支出として取り込み
4子カテゴリコアラ家計簿の子カテゴリ名と照合
5入金額収入金額（- が付いていても可。取り込み時に符号は除去されます）
6出金額支出金額（- が付いていても可。取り込み時に符号は除去されます）
7通貨コードCNY / USD など。空の場合は取り込み先帳本の通貨を使用
8口座口座名（名称で照合。存在しない場合は取り込み時に作成されることがあります）
9タグ複数タグはカンマ区切り（,）。中国語カンマ ， も対応
10メモメモ本文

コアラ家計簿への取り込み（概要） ​

  • 日付 → 日付
  • 取引種別 → 収入/支出
  • 親 + 子カテゴリ → カテゴリ（未一致の場合は「不完全」としてプレビューで修正が必要）
  • 入金/出金 → 金額（収入/支出で参照列が決まります）
  • 口座 → 口座
  • タグ → タグ（名称で照合/作成して紐付け）
  • メモ → メモ
  • 通貨コード → 通貨（一致しない場合は帳本通貨にフォールバック）

⚠️ 注意事項 ​

  1. 自動重複排除なし：同じファイルを二重に取り込むと重複明細が作成されます。取り込み範囲の重複に注意してください。
  2. カテゴリ一致：親 + 子の名称で一致させます。未一致の場合はプレビューで修正してから取り込んでください。
  3. 口座の有効性：口座名が空、または記号のみの場合は無効として扱われ、補完が必要になることがあります。
  4. 文字化け：CSV は UTF-8/GBK に対応しています。文字化けする場合は UTF-8 で再書き出し、または文字コード変換してから取り込んでください。

🔧 よくある質問 ​

Q1：「ヘッダーの列数が不正」と表示されます ​

CSV の 1 行目が 10 列 になっているか確認してください。よくある原因：

  1. Pixiu 以外の CSV を使っている（列数が違う）
  2. Excel/WPS で編集して区切りが増え、列数が変わった
  3. 互換性のない形式で保存した（例：セミコロン区切り）

Q2：金額が 0 になる／おかしい ​

確認：

  1. 「取引種別」列に「支出/收入」のキーワードが含まれているか（入金/出金のどちらを読むかが決まります）
  2. 対応する金額列が数値になっているか（- があっても可）

Q3：カテゴリが一致しません ​

プレビューで 1 件ずつ正しいカテゴリを選択してください。もしくはコアラ家計簿側に Pixiu と同名のカテゴリを事前に作成してから再解析してください。

最終更新：2026 年 5 月