EDI取込（内示・かんばん・受注）

概要

EDI取込（EDI Import）は、得意先から届く CSV/Excelファイル を取り込み、ERPNext上の受注データ（内示・かんばん・確定注文）に変換する機能です。

画面URL:

• EDI取込: /app/edi-import
• 取込ログ閲覧: /app/edi-import-log-view

---

EDIの種別

種別	対象DocType	用途
Forecast（内示）	Daily Forecast	顧客からの将来需要予測データ
Kanban（かんばん）	Kanban Receipt	かんばん方式出荷の納入指示
Order（受注）	Sales Order	確定注文データ

---

事前設定

1. マッピングプロファイル（EDI Mapping Profile）

顧客ごとにCSV/Excelの列構成が異なるため、マッピングプロファイル を事前に登録します。

フィールド	説明
プロファイル名	識別名（例: 「○○スーパー 内示フォーマット」）
顧客	対象の顧客
EDI種別	Forecast / Kanban / Order
列マッピング	CSVの列番号 → フィールド名の対応表

マッピング可能なフィールド:

フィールド名	説明	必須
customer_item_cd	得意先品番	✅
quantity	数量	✅
delivery_date / forecast_date	納期 / 内示日	✅
rate	単価	-
customer_order_no	注文番号（Sales Order用）	-
factory	工場コード	-
receiving_warehouse	入庫先倉庫	-

2. 顧客品目マッピング（Customer Item Mapping）

得意先品番と社内品番の対応表です。EDI取込時に自動変換されます。

フィールド	説明
顧客	対象の顧客
customer_item_cd	得意先品番
item_code	社内品番（ERPNext Item）

3. バリデーションルール（EDI Validation Rule）

品目別のバリデーションルールを定義できます（数量上限、日付範囲など）。

---

操作手順

Step 1: ファイルアップロード

1. /app/edi-import を開く
2. 「ファイルを選択」でCSV/Excelファイルをアップロード
3. 顧客を選択（マッピングプロファイルが自動選択される場合あり）
4. EDI種別を選択（Forecast / Kanban / Order）
5. 「アップロード」をクリック

アップロード時の処理:

• ファイルをパースしてEDI Import Logを作成
• 各行をマッピングプロファイルに基づいて変換
• 自動バリデーションを実行（品番、数量、日付のチェック）

Step 2: バリデーション結果の確認

アップロード後、各行にステータスが付与されます：

ステータス	意味	アクション
Success	正常	そのまま確定可能
Warning	警告あり	確認の上、確定可能
Error	エラーあり	修正が必要
Duplicate	重複検出	削除 or 合算が必要

バリデーション項目:

チェック項目	内容
品番マッピング	customer_item_cd が Customer Item Mapping に存在するか
数量	数値として有効か、上限超過がないか
日付	有効な日付か、過去日の警告、遠い未来の警告
重複	同一品目・同一日の既存データとの重複
差分検知	前回取込との数量増減を検出（内示の場合）

Step 3: エラー修正と重複処理

エラー行の修正

• マスタデータ不足（品番未登録）の場合 → マスタを追加してから「再検証」で修復
• 「再検証」ボタンで、マスタ追加後にエラーが解消されたか確認

重複行の処理

重複が検出された場合、3つの操作が可能です：

操作	説明
削除	選択行を Deleted に変更（他の重複行を再検証）
合算	選択行の数量を次の重複行に加算し、選択行を Merged に
取消	削除/合算操作を元に戻す

Step 4: 確定（Commit）

1. バリデーション結果を確認（Error行がないこと）
2. 「確定」ボタンをクリック
3. 確認ダイアログで「はい」を選択

確定時の処理:

EDI種別	作成されるDocType	詳細
Forecast	Daily Forecast	品目×日付ごとに1レコード作成（既存があれば更新）
Kanban	Kanban Receipt	かんばん受領レコードを作成
Order	Sales Order	注文番号でグルーピングし、SO + SOI として作成

Sales Order 固有の処理:

• customer_order_no でグルーピングし、1注文 = 1 Sales Order として作成
• 複数品目が同一注文番号の場合、1つのSOに複数 Sales Order Item が作成される
• 既存SOとの重複チェック（upsert_key による判定）

Step 5: ファイル保管

確定時に、元のEDIファイルが private/files/edi/ ディレクトリに自動保存されます。ファイル名は {顧客}_{日付}_{EDI種別}_{元ファイル名} 形式です。

---

差分検知（内示の場合）

EDI取込時に、前回取込との差分が自動検出されます：

差分種別	検出条件	表示
数量増加	今回数量 > 前回数量	⬆ 増加量を表示
数量減少	今回数量 < 前回数量	⬇ 減少量を表示
新規追加	前回データなし	🆕
注文変動	SO確定済みの品目の内示変更	⚠

差分情報は demand_change_history_ui（内示変動履歴）画面で時系列に確認できます。

---

取込ログ閲覧

/app/edi-import-log-view で過去の取込ログを一覧・検索できます：

表示項目	説明
ログ名	自動採番されたログID
顧客	取込元の顧客
EDI種別	Forecast / Kanban / Order
ステータス	Validated / Committed / Partial Error
取込日時	ファイルアップロード日時
行数	Success / Warning / Error の件数

---

Tips

• 定期取込: 同じ顧客からの定期ファイルはマッピングプロファイルが自動で適用されるため、2回目以降は顧客選択だけでOK
• 再検証: マスタ追加後に「再検証」を使えば、ファイルを再アップロードする必要なくエラーを解消できます
• 大量データ: 数千行のCSVも一括処理可能です
• ファイル保管: 確定済みファイルは private/files/edi/ に自動保管されるため、監査対応にも活用できます