テンプレート明細インポート（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：帳簿を関連付ける
- 「関連帳簿」 をタップ
- 取り込み先の帳簿を選ぶ
💡 ヒント：帳簿が 1 つしかない場合、自動的に既定の帳簿が選ばれることがあります。
手順 5：解析（プレビューへ）
- 右上の 「解析」 をタップ
- 解析が完了するとプレビュー画面に移動します
⚠️ 解析に失敗する場合：
- ファイル形式が正しいか
- インポート元の選択が正しいか
- ファイルが破損していないか
- 再書き出ししたファイルで再度お試しください
手順 6：プレビューと編集
プレビュー画面では以下ができます。
- 明細を日付ごとに確認
- 1 件ずつ編集（カテゴリ、金額、日時、口座、タグ、メモなど）
- 任意の明細を長押しすると複数選択モードに入り、下部の操作バー（全選択/削除）でまとめて削除できます
- 「インポート」時に無効なデータがある場合、「有効なデータのみ取り込む」か「戻って修正する」を選べます
📝 推奨：取り込み前に必ずプレビューで内容を確認し、必要ならカテゴリや口座を調整してください。
手順 7：インポート実行
- 内容を確認したら 「インポート」 をタップ
- 完了まで待つ
📝 テンプレート CSV フォーマット
テンプレートで取り込む場合は、以下の形式で CSV を用意してください。
CSV の条件
- 文字コード：UTF-8 または GBK
- 区切り：カンマ
, - ヘッダー：1 行目はヘッダー必須
標準フォーマット例
csv
取引日,取引分類,収支大分類,収支小分類,入金額,出金額,口座,タグ,備考
2026/01/01,支出,食費,昼食,,15.00,デフォルト口座,社食,同僚と食事
2026/01/05,収入,給料,月給,5000.00,,銀行カード,,月給フィールド説明
| フィールド | 説明 | 必須 | 例 |
|---|---|---|---|
| 取引日 | 明細の日付（形式：yyyy/MM/dd、yyyy-MM-dd も可） | ✅ | 2026/01/01 |
| 収支種別 | 支出 / 収入 | ✅ | 支出 / 収入 |
| 親カテゴリ | 1 階層目のカテゴリ名 | ❌ | 食費 |
| 子カテゴリ | 2 階層目のカテゴリ名（親の配下） | ❌ | 朝食 |
| 入金額 | 収入の場合に使用する金額 | ✅ | 100.00 |
| 出金額 | 支出の場合に使用する金額 | ✅ | 15 |
| 口座 | 口座名（コアラ家計簿内の既存口座名を推奨） | ❌ | デフォルト口座 |
| メモ | 明細メモ | ❌ | 昼食 |
| タグ | タグ名（複数はカンマ区切り） | ❌ | 社食,会食 |
テンプレートをダウンロード
- インポート画面で 「テンプレートをダウンロード」 をタップ
- 現在の App 言語でヘッダーのみの CSV テンプレートが生成され、システムの共有/保存画面が開きます
- テンプレートにヘッダーに沿ってデータを入力し、インポート画面に戻ってそのファイルを選択してインポートします
⚠️ 注意事項
1. データ形式
- 日付：
YYYY/MM/DDに対応（例：2026/01/01）、YYYY-MM-DDも可 - 金額：数値（小数可、例：
100.00） - 収支種別：
支出または収入（中国語の支出/收入も可） - カテゴリ/口座：App に存在しないカテゴリ/口座はインポート時に自動作成されます（よく使う口座は事前に作成しておくことをおすすめします。不自然な名前の口座が生成されるのを防げます）
2. 取り込み前の検証
インポート前に、コアラ家計簿がデータを自動チェックします。
- ✅ 有効：取り込み可能
- ⚠️ 無効：形式不正のため修正が必要
- ❌ スキップ：無効をスキップして有効のみ取り込み可能
3. 重複データ
- 取り込み前に重複がないか確認することをおすすめします
4. 大量データ
- 1,000 件以上など大量の場合は分割して取り込み推奨
- 取り込み中はアプリを前面にしておいてください
- 取り込み後、必要に応じて手動同期を実行してください
💡 ヒント：無料ユーザーはすべての帳簿の明細総数が 300 件まで、会員は無制限です。データ量が多い場合は、インポート前に残りの記帳可能件数をご確認ください。
🔧 よくある質問
Q1：解析に失敗します
以下を確認してください。
- ファイル形式（CSV / Excel）が正しい
- インポート元の選択が正しい
- ファイルが破損していない
- 文字コードが適切（UTF-8 推奨）
Q2：取り込まれたデータが一部欠けています
考えられる原因：
- 形式不正の行がスキップされた
- カテゴリ/口座が存在しない（作成が必要）
- プレビュー画面で「無効な明細」を確認してください
Q3：画像はインポートできますか？
現時点では対応していません。
Q4：インポート後に修正できますか？
可能です。取り込み後は明細一覧から編集・削除できます。
Q5：複数ファイルをまとめて取り込めますか？
現時点では 1 回につき 1 ファイルのみです。複数ある場合は 1 つずつ取り込んでください。
📚 関連ガイド
💡 ヒント
- 取り込み前に既存データをバックアップしておくことをおすすめします
- 取り込み後にデータが正しいか確認してください
- ご不明な点があれば「フィードバック」機能から開発者にお問い合わせください
最終更新：2026 年 9 月