PunchOut セッションフロー

目的

PunchOutは「接続 → 閲覧 → 持ち帰り」の3ステップで完結します。このドキュメントでは、各ステップで何が起きているかを業務担当者向けに説明します。

登場人物

役割	ステップでの行動
K001（依頼者）	ステップ1で接続を開始し、ステップ2でカタログを閲覧し、ステップ3でJ2に商品を持ち帰る
J2システム	各ステップで認証・記録・受け渡しを担う
サプライヤーサイト	ステップ2でK001にカタログを提供し、ステップ3で選択内容をJ2に送信する

3ステップの業務フロー

flowchart LR
    subgraph STEP1["ステップ1：接続"]
        S1A["K001がPunchOutボタン\nをクリック"]
        S1B["J2がサプライヤーに\n接続要求を送信"]
        S1C["サプライヤーが\n接続を受け入れ\nURLを返す"]
        S1A --> S1B --> S1C
    end

    subgraph STEP2["ステップ2：閲覧"]
        S2A["K001がサプライヤー\nサイトにログイン\n（自動処理）"]
        S2B["商品を検索・閲覧"]
        S2C["商品をカートに追加"]
        S2A --> S2B --> S2C
    end

    subgraph STEP3["ステップ3：持ち帰り"]
        S3A["K001が「注文」ボタン\nをクリック"]
        S3B["サプライヤーがカート内容を\nJ2に送信"]
        S3C["J2のカートに\n商品が追加される"]
        S3D["購買履歴に記録"]
        S3A --> S3B --> S3C --> S3D
    end

    STEP1 --> STEP2 --> STEP3

各ステップの詳細

ステップ1：接続（約数秒）

K001がPunchOutボタンをクリックすると、J2はバックグラウンドでサプライヤーに「このバイヤーの接続を許可してほしい」という要求を送ります。

サプライヤーが許可を返すと、J2はK001のブラウザをサプライヤーサイトの専用URLへ自動的にリダイレクトします。K001は手動でログインする必要はありません。J2が認証情報を自動で送信します。

J2は接続の認証情報を最大1時間保持します。K001がサプライヤーサイトに到達するとサプライヤーがJ2に確認（ハンドシェイク）を行い、数秒以内に完了します。

ステップ2：閲覧（K001が操作）

K001はサプライヤーサイトの通常の画面でカタログを閲覧します。サプライヤー独自の検索機能・フィルター・比較機能をそのまま使えます。

K001がカートに商品を追加している間、J2は待機状態です。J2とサプライヤーサイトは独立したウィンドウで動作しています。

このステップでのJ2はセッション管理に関与しません。閲覧可能な時間はサプライヤー側のセッションポリシーに依存します（サプライヤーにより異なります）。セッションが切れた場合はサプライヤーサイトから通知されます。

ステップ3：持ち帰り（約数秒）

K001がサプライヤーサイトで「注文」または「チェックアウト」をクリックすると、サプライヤーがカートの内容（商品コード・数量・価格・単位など）をJ2に自動送信します。

J2はこの情報を受け取り：

J2のカートに商品を追加する
購買履歴として記録する（後から履歴検索・再注文が可能）
サプライヤーサイトのウィンドウを閉じてJ2に戻す

以降は通常の購買依頼フロー（承認・発注）に進みます。

セッション有効期限のしくみ

1時間はK001がサプライヤーサイトで閲覧できる時間ではありません。J2が接続の認証情報を保持する期間（ハンドシェイク完了まで）です。ハンドシェイクはK001がサプライヤーサイトに到達した数秒以内に完了します。その後のサプライヤーサイトでの閲覧時間はサプライヤー側が管理するため、サプライヤーごとに異なります。

flowchart LR
    A["J2がセッション作成\n（1時間カウント開始）"] --> B["K001がサプライヤーサイトに到達"]
    B --> C["サプライヤーがJ2に確認\n（このセッションは有効か？）"]
    C --> D["J2がOKを返す\nセッションを無効化"]
    D --> E["K001がサプライヤーサイトで閲覧\n（時間制限はサプライヤー側が管理）"]

    style A fill:#ffe0b2
    style D fill:#ffe0b2
    style E fill:#c8e6c9

フェーズ	時間管理
J2セッション作成 → サプライヤー確認（ハンドシェイク）	J2管理 — 最大1時間
サプライヤー確認完了 → K001がサプライヤーサイトで閲覧	サプライヤー管理 — サプライヤーごとに異なる

補足: 1時間ルールはすべてのサプライヤーに同一のルールで適用されます（J2のコードで固定）。ただしサプライヤーサイトでの滞在可能時間はサプライヤー各社のセッションポリシーに依存します。

購買履歴について

PunchOut経由で選んだ商品はすべてJ2のPunchOut購買履歴に保存されます。

履歴から以下の操作が可能です：

商品名・品番でキーワード検索
注文日・納品日・検収日などの日付範囲で絞り込み
過去に選んだ商品をカートに再追加

Business Rules

1時間はJ2の接続認証情報の保持期間 — すべてのサプライヤーに同一ルールで適用。実際のハンドシェイクは数秒で完了するため、通常はこの上限に達しません。
サプライヤーサイトでの閲覧時間はサプライヤー次第 — ハンドシェイク完了後はJ2が関与しません。サプライヤーごとにセッションポリシーが異なります。
J2のセッションは1回限り有効。 同じ接続コードを使い回せません。再度PunchOutボタンをクリックすれば新しいセッションが始まります。
カートへの反映は自動。 ステップ3完了後、K001が手動で入力する必要はありません。
購買履歴は自動保存。 完了したすべてのPunchOut取引が履歴に記録されます。

Edge Cases

ステップ2の途中でブラウザを閉じた場合: セッションが無効になります。PunchOutボタンを再度クリックして最初からやり直してください。
同じサプライヤーに複数回PunchOutした場合: それぞれ独立したセッションとして扱われます。1つ前の接続情報は再利用できません。
ステップ3でエラーが発生した場合: サプライヤー側の商品情報が変更されているか、J2側の商品マッピングに問題がある可能性があります。購買担当者（K002）またはBuyer Adminに確認してください。

ステージング環境のURL

画面	URL
CatalogMall（PunchOut起点）	`https://j2.staging.jienie.com/eProcurement/CatalogMall`
PunchOut購買履歴	`https://j2.staging.jienie.com/eProcurement/CatalogMall/PunchoutHistory`