> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uselim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 他社会計ソフトからの移行

> freee、マネーフォワード、弥生会計などから lim へ仕訳と開始残高を移行する手順。

# 他社会計ソフトからの移行

lim は `freee会計`、`MoneyForward クラウド会計`、`弥生会計`、`勘定奉行`、`QuickBooks`、`Xero` の CSV を取り込めます。大量の過去仕訳を移したい場合は、Web の CSV インポート画面よりも `lim import` を使うほうが安全です。

## 対応フォーマット

| ソース                 | 仕訳CSV | 開始残高              | 推奨方法 |
| ------------------- | ----- | ----------------- | ---- |
| freee会計             | 対応    | freee形式B/S CSVに対応 | CLI  |
| MoneyForward クラウド会計 | 対応    | 別CSVを推奨           | CLI  |
| 弥生会計                | 対応    | 別CSVを推奨           | CLI  |
| 勘定奉行                | 対応    | 別CSVを推奨           | CLI  |
| QuickBooks          | 対応    | 別CSVを推奨           | CLI  |
| Xero                | 対応    | 別CSVを推奨           | CLI  |

<Info>
  Web のプレビューは実装上 `freee` と `MoneyForward` の日本語仕訳CSVが中心です。`弥生会計`、
  `勘定奉行`、`QuickBooks`、`Xero` は CLI のほうが確実です。
</Info>

## 移行前のチェックリスト

* 移行元でエクスポート対象期間を確定する
* 移行元のバックアップを保存する
* 仕訳CSVと、必要なら貸借対照表または開始残高CSVを別々に出力する
* lim 側で会社を作成し、期首日を確認する
* 勘定科目名の揺れが大きい場合は、事前に lim 側の科目を調整する

<Warning>
  `freee会計` の仕訳帳 CSV だけでは、資本金や開業費などの開始残高設定を完全には再現できません。
  `freee` から移行する場合は、仕訳CSVに加えて貸借対照表または開始残高CSVも用意してください。
</Warning>

## 推奨手順

<Steps>
  <Step title="移行元からCSVを出力する">
    まずは移行元で `仕訳帳CSV` を出力します。開始残高を別管理している製品は、残高用CSVも合わせて保存してください。

    * `freee会計`: 仕訳帳CSVを出力し、必要に応じて `開始残高（freee形式）` または `貸借対照表` CSVも出力します。
    * `MoneyForward クラウド会計`: 仕訳帳CSVを出力します。開始残高は別途一覧を保存しておくのが安全です。
    * `弥生会計` / `勘定奉行` / `QuickBooks` / `Xero`: 仕訳エクスポート機能から CSV を出力します。

    文字コードが `Shift_JIS` の場合でも lim 側で自動判定します。Excel で開いて再保存すると列名が変わることがあるため、できれば未加工のCSVをそのまま使ってください。
  </Step>

  <Step title="dry-run で検証する">
    まずは検証だけ実行します。

    ```bash theme={null}
    lim import ./exports/journal.csv --dry-run
    ```

    ここで以下を確認します。

    * 形式が正しく自動判定されているか
    * 仕訳件数が想定どおりか
    * 未マッチ科目がどれくらいあるか
    * パースエラーや日付ずれがないか
  </Step>

  <Step title="未マッチ科目を解消する">
    科目名が lim 側と一致しない場合、CLI は既存科目への割当、新規科目作成、スキップを選べます。

    ```bash theme={null}
    lim import ./exports/journal.csv
    ```

    一度確定した割当は `~/.lim/account-mappings/<company-id>.json` に保存されるため、2回目以降の移行は速くなります。
  </Step>

  <Step title="開始残高を取り込む">
    期首残高が必要な場合は、仕訳とは別に開始残高を登録します。

    ```bash theme={null}
    lim import --opening-balance ./exports/balance-sheet.csv
    ```

    `freee` の貸借対照表CSVは自動認識されます。その他の製品では、最低限 `勘定科目 / 借方残高 / 貸方残高` が分かるCSVを用意してください。
  </Step>

  <Step title="移行後に健全性を確認する">
    最後にヘルスチェックと帳票確認を行います。

    ```bash theme={null}
    lim import --health-check
    lim reports tb
    ```

    試算表で、移行元の期末残高と借貸一致を確認してください。
  </Step>
</Steps>

## Web で取り込む場合

ブラウザから `CSV インポート` 画面を開き、CSV をドラッグ&ドロップすると、先にプレビューしてからインポートできます。

* 科目が自動マッチしない仕訳はスキップされます
* 複雑な複合仕訳や科目調整が多い場合は CLI を使ってください
* 1 回の取り込みは内部的にチャンク分割されます

## よく使うオプション

```bash theme={null}
# 期間を絞る
lim import ./exports/journal.csv --from 2025-04-01 --to 2026-03-31

# バッチ単位でロールバック
lim import --undo <batch-id>
```

<Tip>
  lim
  はインポート時にソース由来の識別情報から重複判定を行います。同じCSVを再投入しても、既存仕訳は重複スキップされます。
</Tip>

## 製品別の注意点

### freee会計

* 新旧どちらの仕訳CSV形式にも対応しています
* `仕訳ID` がある場合は重複判定に利用されます
* 開始残高は `freee` 形式の残高CSVか B/S CSV を別途取り込んでください

### MoneyForward クラウド会計

* `取引No` と `MF仕訳タイプ` を含むCSVを自動判定します
* 複合仕訳は `取引No` 単位でまとめて取り込みます

### 弥生会計・勘定奉行・QuickBooks・Xero

* 仕訳CSV自体は対応しています
* Web プレビューより CLI 取り込みを前提にしてください

## 次のステップ

<CardGroup cols={2}>
  <Card title="勘定科目管理" icon="list-tree" href="/ja/guides/chart-of-accounts">
    移行後の科目整理と名称統一。
  </Card>

  <Card title="銀行照合" icon="building-columns" href="/ja/guides/bank-reconciliation">
    口座残高と入出金の突合。
  </Card>

  <Card title="財務諸表" icon="chart-line" href="/ja/guides/financial-reports">
    試算表、損益計算書、貸借対照表で検証。
  </Card>

  <Card title="電子帳簿保存法対応" icon="folder-open" href="/ja/guides/document-management">
    書類保存と証憑管理を整備。
  </Card>
</CardGroup>
