EOS 取込管理
EOS 端末から届く発注データの取込バッチ・取込エラー・端末（デバイス）の状態を 1 画面で監視し、エラーの再処理や端末への遠隔操作までを行う管理画面です。
関連記事 取り込んだ EOS 受注をまとめて確認するには 受注 Hub の EOS モードを使います。 取込まわりの他経路は EDI 取込 / EC 取込 を参照してください。
この画面でできること
EOS 取込管理は、EOS 端末から届いた発注データの取込状況を監視し、エラーへの対処と端末の運用管理を行う画面です。3 つのタブで構成されています。
| タブ | 役割 |
|---|---|
| 取込バッチ | 取込のかたまり（バッチ）ごとの結果を一覧・詳細確認 |
| 取込エラー | 取り込めなかった明細を一覧し、再処理（リトライ）する |
| デバイス | EOS 端末の稼働状態を確認し、遠隔操作を送る |
画面URL: /app/eos-import-management
EOS とは、店舗の発注端末（Electronic Ordering System）から送られてくる発注データの仕組みです。チェーン店などの定例発注を端末経由で受け取り、受注に変換します。
誰が何のために使うか
| 担当 | 主な使い方 |
|---|---|
| 受注担当 | 取込バッチを確認し、取込件数・失敗件数を把握する |
| 取込運用担当 | 取込エラーを確認し、マスタ修正のうえ再処理する |
| 端末管理担当 | デバイスの稼働状態を監視し、必要に応じて遠隔操作する |
共通の操作
- 各タブ上部に絞り込み（フィルタ）バーがあり、条件を入れて「検索」、解除は「リセット」で行います
- 一覧の行をクリックすると詳細ダイアログが開きます
- 一覧下部の「前へ／次へ」でページ送りができます（1 ページ 20 件）
1. 取込バッチ
取込のまとまりを一覧表示するタブです。
絞り込み
| 項目 | 内容 |
|---|---|
| From Date / To Date | 取込日時の期間 |
| Status | 完了／一部エラー／失敗／処理中／キュー待ち |
一覧の列
| 列 | 内容 |
|---|---|
| 取込日時 | バッチの取込日時 |
| ファイル名 | 取込元ファイル名 |
| 合計／成功／失敗／スキップ | 件数の内訳 |
| ステータス | バッチ全体の処理結果 |
ステータスの意味
| ステータス | 意味 |
|---|---|
| 完了（Completed） | すべて正常に取り込めた |
| 一部エラー（Partial Error） | 一部の明細が失敗した |
| 失敗（Failed） | 取込が失敗した |
| 処理中（Processing）／キュー待ち（Queued） | 取込実行中／待機中 |
バッチ詳細
行をクリックすると、バッチの概況・件数・作成された受注（Sales Order）へのリンク・エラー明細が表示されます。作成済み受注のリンクから、対象の受注を直接開けます。
2. 取込エラー
取り込めなかった明細を一覧し、原因確認と再処理を行うタブです。
絞り込み
| 項目 | 内容 |
|---|---|
| Batch | バッチ名で絞り込み |
| Error Type | バリデーション／マッピング／重複／システム |
| Retry Status | 未対応（Pending）／再処理済（Retried）／解決済（Resolved） |
一覧の列
外部注文番号・チェーン名・店舗コード・店舗名・エラー種別・エラー内容・再処理ステータスが表示されます。
エラー詳細と再処理
行をクリックすると、エラーの詳細・エラーメッセージ・元の発注データ（Raw Order Data） が表示されます。
- ダイアログ下部の「Retry（再処理）」ボタンで、対象明細を取り込み直せます
- 再処理が成功すると一覧が更新されます
- すでに受注が存在する場合は「既に ｛受注番号｝ として存在します」と案内され、二重作成を防ぎます
- すでに「解決済」の明細では再処理ボタンは表示されません
再処理の前に、原因（品番マッピング不足・店舗マスタ不足など）を解消しておくと、再処理が一度で通ります。
3. デバイス
EOS 端末（デバイス）の稼働状態を監視・操作するタブです。
絞り込み
| 項目 | 内容 |
|---|---|
| Status | オンライン／オフライン／エラー |
一覧の列
デバイス名・顧客・設置場所・バージョン・最終ハートビート（生存確認）・状態が表示されます。
| 状態 | 意味 |
|---|---|
| オンライン（Online） | 端末が正常に通信している |
| オフライン（Offline） | 通信が途絶えている |
| エラー（Error） | 端末側でエラーが発生している |
デバイス詳細と遠隔操作
行をクリックすると、端末の情報（デバイス ID・顧客・設置場所・バージョン・最終ハートビート・最終成功・保留キュー件数）が表示され、次の遠隔操作を送れます。
| 操作 | 内容 |
|---|---|
| Sync Now | 端末に即時同期を指示 |
| Refresh Config | 設定の再読み込みを指示 |
| Upload Logs | 端末ログのアップロードを指示 |
| Check Update | アップデートの確認を指示 |
操作は端末の処理キューに登録（queued）され、結果がダイアログ内に表示されます。
活用のヒント
- バッチ → エラーの順で確認：まず取込バッチで「一部エラー」「失敗」のバッチを見つけ、取込エラータブで明細を掘り下げると効率的です
- 再処理前にマスタを整える：エラー種別が「マッピング」なら品番マッピング、「バリデーション」なら店舗・品目マスタを先に整えてから Retry します
- オフライン端末は遠隔操作で確認：デバイスタブで「オフライン」を見つけたら、最終ハートビートを確認し、復帰後に「Sync Now」を送って溜まった発注を流します
よくある質問
Q: 再処理（Retry）したのに取り込まれません
エラーの原因（品番未登録・店舗コード未登録など）が解消されていない可能性があります。エラー詳細の「Raw Order Data」で実際の値を確認し、対応するマスタを整えてから再処理してください。
Q: 「既に ｛受注番号｝ として存在します」と出ます
その発注はすでに受注として作成済みです。重複作成を避けるため再処理は行われません。表示された受注番号で内容を確認してください。
Q: デバイスがずっとオフラインです
端末の電源・ネットワークを確認のうえ、復帰後にデバイス詳細から「Sync Now」を送って保留キューを流してください。改善しない場合は端末管理者に連絡します。