📥 データインポート
ガイド付きの5ステップウィザードを使用して、既存のデータをLKG for Billingにインポートします。CSV、Excel、XML、JSON形式のソースファイルに対応しています。ソースの列をシステムのフィールドにマッピングし、データをプレビューしてからコミットします。
インテグレーション → データインポート に移動します。
インポート一覧
データインポートページには、これまでのすべてのインポートジョブとそのステータス・結果が一覧表示されます。
| 列 | 説明 |
|---|---|
| インポート番号 | 自動生成されるインポートジョブID |
| エンティティタイプ | インポートするデータの種類（取引先、商品、請求書など） |
| ソース | 使用されたファイル形式 |
| ステータス | キュー登録済み、実行中、完了、一部完了、失敗、キャンセル済み |
| レコード数 | 合計、成功、失敗のレコード数 |
| 日付 | インポートを開始した日時 |
| 操作 | 詳細表示、再実行 |
新規インポートの開始
+ 新規インポート をクリックすると、5ステップのウィザードが開きます。
ステップ1 — ソースの選択
| フィールド | 説明 |
|---|---|
| ソース形式 | CSV、Excel（.xlsx）、XML、またはJSON |
| エンティティタイプ | インポートするデータの種類 — 対応する種類は以下を参照 |
| マッピングテンプレート | 以前のインポートで保存したフィールドマッピングを再利用できます（任意） |
対応エンティティタイプ
| エンティティ | 説明 |
|---|---|
| 取引先 | 顧客と仕入先 |
| 商品 | 製品とサービス |
| 請求書 | 売上請求書 |
| 仕入 | 仕入伝票 |
| 支払い | 支払い記録 |
| 元帳 | 会計元帳の仕訳 |
| バンドル | 複数のエンティティタイプを1回のインポートでまとめて処理 |
ステップ2 — ファイルのアップロードと重複排除
ソースファイルをアップロードし、重複の処理方法を設定します。
重複排除キー
どのフィールドで重複レコードを識別するかを選択します。
| キー | 用途 |
|---|---|
| GSTIN | GST番号を持つ取引先 |
| 電話番号 | 電話番号を持つ取引先 |
| メールアドレス | メールアドレスを持つ取引先 |
| 商品コード | 商品コードを持つ商品 |
| 名称 | 名称で照合（大文字・小文字を区別しない） |
ドライラン
ドライラン を有効にすると、データベースにデータをコミットせずにインポートを検証・プレビューできます。最初の本番インポートの前に実行することを推奨します。
ステップ3 — フィールドマッピング
システムはソースファイルのヘッダーを解析し、システムフィールドへのマッピングを自動的に提案します。
| インジケーター | 意味 |
|---|---|
| 🟢 緑（90%以上） | 高信頼度の自動マッピング |
| 🟡 黄（70%以上） | 中程度の信頼度 — 提案されたマッピングを確認してください |
| 🔴 赤（70%未満） | 低信頼度 — 手動でのマッピングが必要 |
- 自動検出されたマッピングは、ドロップダウンから正しい対象フィールドを選択することで上書きできます
- インポート不要な列は 無視 に設定できます
- ソースに含まれていない必須フィールドはエラーとして強調表示されます
マッピングテンプレートの保存
テンプレートとして保存 をクリックすると、同じファイル形式の今後のインポートのために現在のマッピングを保存できます。
ステップ4 — データのプレビュー
データがどのようにインポートされるかを行単位でプレビューして確認します。
| インジケーター | 意味 |
|---|---|
| 🟢 緑 | 行は正常にインポートされます |
| 🟡 黄 | 行に警告があります（警告付きでインポートされます） |
| 🔴 赤 | 行にエラーがあり、スキップされます |
行を展開すると、詳細なフィールド値と具体的なエラー・警告メッセージを確認できます。
エラーが多い場合は、戻る をクリックしてフィールドマッピングに戻り、続行する前に設定を修正してください。
ステップ5 — 実行と監視
コミット をクリックしてインポートを開始します。ウィザードにはリアルタイムの進捗が表示されます。
- 完了率を示すプログレスバー
- 処理済み、成功、失敗のレコード数のリアルタイム表示
インポートステータス
| ステータス | 説明 |
|---|---|
| キュー登録済み | インポートはスケジュール済みだが、まだ開始されていない |
| 実行中 | インポートがレコードを実際に処理中 |
| 完了 | すべてのレコードが正常に処理された |
| 一部完了 | 一部のレコードは成功したが、一部は失敗した |
| 失敗 | インポートが失敗した — エラーの詳細を確認してください |
| キャンセル済み | インポートが実行途中でキャンセルされた |
キャンセル をクリックすると、実行中のインポートを停止できます。すでに処理されたレコードは保持されます。
インポート詳細の表示
一覧からインポートをクリックすると、次の内容を確認できます。
- レコードごとの詳細な結果
- 失敗した行のエラーメッセージ
- サマリー統計