Appearance
テンプレート明細インポート（CSV）
📋 概要
コアラ家計簿では、外部ファイルから明細データをインポートして、過去の記録をまとめて取り込めます。現在、以下の方法に対応しています。
- テンプレートファイル：標準フォーマットの CSV を取り込み
- WeChat：WeChat から書き出した明細ファイルを取り込み
- Alipay：Alipay から書き出した明細ファイルを取り込み
- Pixiu：Pixiu から書き出した CSV を取り込み
- iCost：iCost から書き出した Excel を取り込み
📁 対応ファイル形式
- CSV（
.csv）：Alipay、Pixiu、テンプレート - Excel（
.xlsx/.xls）：WeChat、iCost
🚀 クイックスタート
手順 1：インポート画面を開く
- コアラ家計簿を開く
- 画面下の 「設定」 をタップ
- 設定画面で 「明細インポート」 を探す
- 明細インポート画面に入る
手順 2：インポート元を選ぶ
インポート画面で、明細の出所（インポート元）を選びます。
- テンプレート：標準フォーマットの CSV
- WeChat：WeChat から書き出したファイル
- Alipay：Alipay から書き出したファイル
- Pixiu：Pixiu から書き出したファイル
- iCost：iCost から書き出したファイル
⚠️ 重要：インポート元を間違えると解析に失敗したり、項目がずれて取り込まれることがあります。
手順 3：ファイルを選択
- 「ファイルパス」 をタップ
- ファイル選択画面で、取り込みたいファイルを選ぶ
- ファイル名が表示されていることを確認
📝 注意：
- ファイルは端末内に保存されている必要があります（ファイルアプリから参照できる場所）
- ファイル形式（CSV / Excel）が正しいことを確認してください
- ファイルが破損している場合は再書き出しをお試しください
手順 4：帳本（Ledger）を関連付ける
- 「関連付け帳本」 をタップ
- 取り込み先の帳本を選ぶ
💡 ヒント：帳本が 1 つしかない場合、自動的に既定の帳本が選ばれることがあります。
手順 5：解析（プレビューへ）
- 右上の 「解析」 をタップ
- 解析が完了するとプレビュー画面に移動します
⚠️ 解析に失敗する場合：
- ファイル形式が正しいか
- インポート元の選択が正しいか
- ファイルが破損していないか
- 再書き出ししたファイルで再度お試しください
手順 6：プレビューと編集
プレビュー画面では以下ができます。
- 明細を日付ごとに確認
- 1 件ずつ編集（カテゴリ、金額、日時、口座、タグ、メモなど）
- 長押しで無効な明細を削除
- 無効な明細をまとめてスキップ
📝 推奨：取り込み前に必ずプレビューで内容を確認し、必要ならカテゴリや口座を調整してください。
手順 7：インポート実行
- 内容を確認したら 「インポート」 をタップ
- 完了まで待つ
📝 テンプレート CSV フォーマット
テンプレートで取り込む場合は、以下の形式で CSV を用意してください。
CSV の条件
- 文字コード：UTF-8 または GBK
- 区切り：カンマ
, - ヘッダー：1 行目はヘッダー必須
標準フォーマット例
csv
日期,类型,金额,分类,账户,备注,标签
2024-01-01,支出,100.00,餐饮,现金,午餐,工作餐
2024-01-02,收入,5000.00,工资,银行卡,月薪,フィールド説明
| フィールド | 説明 | 必須 | 例 |
|---|---|---|---|
| 取引日 | 明細の日付（形式：yyyy/MM/dd） | ✅ | 2026/01/01 |
| 収支種別 | 支出 / 収入 | ✅ | 支出 / 收入 |
| 親カテゴリ | 1 階層目のカテゴリ名 | ✅ | 伙食 |
| 子カテゴリ | 2 階層目のカテゴリ名（親の配下） | ✅ | 早餐 |
| 入金額 | 収入の場合に使用する金額 | ✅ | 100.00 |
| 出金額 | 支出の場合に使用する金額 | ✅ | 15 |
| 口座 | 口座名（コアラ家計簿内の既存口座名を推奨） | ✅ | 默认账户 |
| メモ | 明細メモ | ❌ | 午餐 |
| タグ | タグ名（複数はカンマ区切り） | ❌ | 工作餐,聚餐 |
テンプレートをダウンロード
- インポート画面で 「テンプレートをダウンロード」 をタップ
- サンプル CSV がダウンロードされます
- その形式を参考にご自身のデータを作成してください
⚠️ 注意事項
1. データ形式
- 日付：
YYYY/MM/DD（例：2026/01/01） - 金額：数値（小数可、例：
100.00） - 収支種別：
支出または收入 - カテゴリ/口座：未作成の場合、インポート時に自動作成されることがあります
2. 取り込み前の検証
インポート前に、コアラ家計簿がデータを自動チェックします。
- ✅ 有効：取り込み可能
- ⚠️ 無効：形式不正のため修正が必要
- ❌ スキップ：無効をスキップして有効のみ取り込み可能
3. 重複データ
- 取り込み前に重複がないか確認することをおすすめします
4. 大量データ
- 1,000 件以上など大量の場合は分割して取り込み推奨
- 取り込み中はアプリを前面にしておいてください
- 取り込み後、必要に応じて手動同期を実行してください
🔧 よくある質問
Q1：解析に失敗します
以下を確認してください。
- ファイル形式（CSV / Excel）が正しい
- インポート元の選択が正しい
- ファイルが破損していない
- 文字コードが適切（UTF-8 推奨）
Q2：取り込まれたデータが一部欠けています
考えられる原因：
- 形式不正の行がスキップされた
- カテゴリ/口座が存在しない（作成が必要）
- プレビュー画面で「無効な明細」を確認してください
Q3：画像はインポートできますか？
現時点では対応していません。
Q4：インポート後に修正できますか？
可能です。取り込み後は明細一覧から編集・削除できます。
Q5：複数ファイルをまとめて取り込めますか？
現時点では 1 回につき 1 ファイルのみです。複数ある場合は 1 つずつ取り込んでください。
📚 関連ガイド
最終更新：2026 年 1 月