商品マスタ取込バッチ(基幹→新・日次)

概要: 人の画面操作を伴わない日次(夜間)バッチ処理です。基幹システムが保持する商品本体情報を、CSV連携により新システムへ直接取り込みます(旬報店は経由しません。取込経路は要確認事項を含みます)。

商品本体データのマスタ(正本)は基幹システムとします。基幹システムが保持する項目は、商品コード(SKU)、商品名、容量、定価、廃番フラグです。取込ファイルには、これらに加えてJANコードとブランド分類も含まれます。なお、旬報店の商品コードは経営集計用に集約・再採番されているため、番手ごとの正データとしては使用しません。

本バッチでは、商品コード product_code(HINCD)をキーとして既存レコードを検索します。未登録の場合は商品本体を新規登録し、登録済みの場合は基幹システムの値で更新します(既存レコードの削除は行いません)。香り、商品説明、商品画像、診断用属性、サロンごとの取扱可否、店舗の販売価格は、本取込処理では更新しません。香り、商品説明、商品画像、診断用属性の更新は、管理画面上では行わず、保守運用チーム(i3DESIGN、プレイド)への依頼により反映します。処理の失敗や遅延はインフラの自動監視で検知し、メールおよびSlackで同保守運用チームへ通知します。管理画面上には失敗記録(エラー履歴)画面を設けません。

基本情報
機能ID FN-MS-003 機能名 商品マスタ取込バッチ(基幹→新・日次)
大分類 バッチ・連携 中分類 基幹連携
区分 処理(バッチ)(専用画面なし)
実行 日次・夜間の片方向バッチ(CSV連携/開始時刻は未確認)
画面 専用画面はなし。取り込んだ商品本体は、コタ管理画面の商品マスタ管理(一覧・定価表示)で確認する(一覧への反映タイミングは未確認)。

1. 対象範囲

本取込処理の対象範囲と対象外事項
対象 本取込処理での扱い
商品本体 基幹システムのCSVを受け取り、商品コードをキーとして新規登録、または既存データの更新(商品名、容量、定価、廃番フラグ、JANコード、ブランド分類)を行う(既存レコードの削除は行わない)。
失敗と遅延 インフラの自動監視で検知し、メールおよびSlackで保守運用チーム(i3DESIGN、プレイド)へ通知する。管理画面に失敗記録(エラー履歴)画面は設けない。なお、美容室で発生した異常は、コタ本部の窓口経由で保守運用チームへ連絡する。
香り、説明、画像、診断用属性 本取込では更新しない。更新が必要な場合は保守運用チーム(i3DESIGN、プレイド)へ依頼して対応する(管理画面の編集機能は設けない)。
サロンごとの取扱可否 本取込では更新しない。美容室管理画面にてサロンごとに手動で設定する。取扱フラグがオフの製品はカウンセリングの自動選定対象から除外し、取扱のある製品を優先して提案する。
店舗の販売価格 本取込では更新しない。美容室管理画面で設定された価格を維持する。

2. 処理フロー

白は確定済みの処理、 赤は未確認事項、 橙は条件分岐を示します。縦列が担当領域、横段が処理順序を表し、矢印の色は緑が「はい」、赤が「いいえ」を意味します。

基幹システム
取込バッチ
商品マスタ
監視・保守
画面

1 夜間バッチ起動(下段へ進む)

夜間にバッチが起動する。

開始時刻は未確認。

旬報店は経由しない。

2 商品CSVの連携(基幹システム → 取込バッチ)

基幹システムが商品CSVを出力・連携する。

取込バッチが商品CSVを受信する。

取込経路(基幹直接で確定か)およびファイルの配置方法は未確認。

全件連携か差分連携かは未確認。

3 商品コードによる既存レコード検索

取込バッチが受信した各レコードを商品コードで検索する。

商品マスタが同一商品コードのレコード有無を返却する。

4 新規登録判定(未登録なら新規登録、登録済みなら下段の更新処理へ)

その商品コードは未登録か。

はい

商品マスタへ商品コード、商品名、容量、定価、廃番フラグ、JANコード、ブランド分類を新規登録する。

いいえ

5 既存レコードの更新(登録済みの場合。全レコード処理完了まで 3〜5 を繰り返す)

取込バッチが商品本体を基幹システムの値で更新する。

商品マスタが該当項目を基幹システムの値で上書き更新する。

廃番レコードを削除するか保持するかは未確認。

全レコード処理完了まで 3〜5 を繰り返す。

6 取込対象外項目の維持(新規・更新いずれの場合も以下は更新しない)

香り、説明、画像、診断用属性、取扱可否、店舗の販売価格は更新しない。

【取込処理外】別運用・他画面での設定(フロー対象外)

保守運用チームが依頼を受けて、香り、説明、画像、診断用属性を更新する。

サロン側が美容室管理画面で取扱可否と販売価格を手動設定する。

7 異常検知・通知判定(異常時は下段で通知、正常時は右から商品マスタ管理画面の確認へ)

失敗または遅延が発生したか。

いいえ

異常がなければ、商品マスタ管理での確認へ進む。

はい

インフラの自動監視で検知する。

保守運用チームがメールおよびSlackで通知を受信する。

エラー行のみスキップするか、ファイル全体をロールバックするかは未確認。

8 商品マスタ管理(一覧・定価表示)での取込結果確認

コタ管理画面の商品マスタ管理(一覧・定価表示)で、取り込んだ商品本体を確認する。

一覧への反映時刻は未確認。

店頭タブレットへの配信時刻は未確認。

【取込処理外】異常発生時の連絡フロー(フロー対象外)

保守運用チームが窓口からの連絡を受けて調査する。

失敗記録(エラー履歴)画面は設けない。

美容室で発生した異常はコタ本部の窓口で受け付ける。

3. 入出力と連携

入力・出力・連携仕様
入力 基幹システムから出力される商品CSV。対象項目は商品コード(SKU / product_code / HINCD)、商品名、容量、定価、廃番フラグ、JANコード、ブランド分類(商品画像はCSVに含まれない)。
出力 未登録の商品本体の新規登録、および登録済み商品本体の更新を行う。香り、商品説明、商品画像、診断用属性、サロンごとの取扱可否、店舗の販売価格は取込前の値を維持する。処理の失敗または遅延が発生した場合は、インフラの自動監視からメールおよびSlackで保守運用チームへ通知する(管理画面には失敗記録を表示しない)。
突合 既存レコードとの突合キーは商品コード product_code(HINCD)とする。
連携 外部連携先は基幹システムのみとし、旬報店へは本バッチから連携しない。データの書き込み先は新システムの商品マスタとする。定価履歴は cota_product_histories を価格切替日 apply_start_date で更新する(履歴データを同一CSVで連携するか、別ファイルで連携するかは未確認)。
操作画面 本バッチ専用の操作画面はない。取り込んだ商品本体はコタ管理画面の商品マスタ管理(一覧・定価表示)で確認する。なお、取扱可否および店舗価格の設定は本取込処理の対象外とする。

4. 条件分岐

条件ごとの処理内容
条件 バッチの扱い
商品コードが未登録 商品本体を新規登録する。
商品コードが登録済み 商品名、容量、定価、廃番フラグ、JANコード、ブランド分類を基幹システムの値で更新する。
香り、説明、画像、診断用属性 更新しない。保守運用チーム(i3DESIGN、プレイド)への依頼により更新する(管理画面の編集機能は設けない)。
サロンごとの取扱可否 更新しない。美容室管理画面でサロンごとに手動設定する。取扱フラグがオフの製品はカウンセリングの自動選定対象から除外する(廃番フラグが立った際に取扱フラグを自動でオフにするかは未確認)。
店舗の販売価格 更新しない。美容室管理画面で設定された価格を維持する。
廃番フラグが立っている 商品本体の項目値として反映する(レコードを残すか削除するかは未確認)。
定価が変更された場合 商品本体の定価を基幹システムの値で更新する(定価履歴の連携方法は未確認)。
容量が異なる場合 容量・番手ごとに別の商品コードとして取り込み、それぞれ独立した1レコードとして扱う(CSVに親コードの列が含まれるかは未確認)。
処理の失敗または遅延が発生した場合 インフラの自動監視で検知し、メールおよびSlackで保守運用チームへ通知する。管理画面に失敗記録画面は設けない(エラー行のみスキップするか、ファイル全体をロールバックするかは未確認)。
本バッチの実行外(別運用・他画面)で行う操作
対象 内容
商品マスタ管理(一覧・定価表示) コタ管理画面の商品マスタ管理(一覧・定価表示)にて、取り込んだ商品本体を確認する(一覧への反映タイミングは未確認)。
取扱可否 美容室管理画面にてサロンごとに手動で設定する(CSV連携の対象外)。取扱フラグがオフの製品はカウンセリングの自動選定対象から除外し、取扱のある製品を優先して提案する(廃番フラグが立った際に取扱フラグを自動でオフにするか、画面上で警告を表示してサロン側で解除するかは未確認)。
店舗の販売価格 美容室管理画面にて設定する(本取込処理では変更しない)。
商品画像 基幹CSVには含まれず、新システムの AWS S3 上で別途管理する。更新は保守運用チーム(i3DESIGN、プレイド)への依頼により行う(管理画面の編集機能は設けない)。
香り、説明、診断用属性 新システム側の付加情報として保持する(本取込処理では更新しない)。更新は保守運用チーム(i3DESIGN、プレイド)への依頼により行う。

6. 未確認事項