レガシー・プラットフォーム

住所の確認

オンラインで編集

オーダー取得やオーダー住所の変更など、住所確認が必要となる、さまざまなシナリオがあります。 このアプリケーションでは、オーダーの住所を確認し、適切なアクションを取るようにユーザーに通知する警告を発行するために住所確認エージェントを提供しています。

解決方法

以下のセクションでは、API、外部プログラム、サービス、およびその他のコンポーネントについて説明します。

住所を取得または変更している時、verifyAddress API は住所情報を取得し、住所確認システム (AVS) を使用して事前にその住所情報の確認を試行します。 AVS との通信は、YCDVerifyAddressWithAVSUE 外部プログラムによって処理されます。 確認プロセスのステータスが返されます。 使用可能な値は、以下のとおりです。
  • UE_MISSING - 外部プログラム YCDVerifyAddressWithAVSUE の実装が見つかりませんでした。
  • AVS_DOWN - 住所確認システムが応答しませんでした。
  • FAILED - この住所は住所確認システムで確認できませんでした。
  • VERIFIED - この住所は住所確認システムで確認されました。

オーダー作成時に、 IsAddressVerified 属性が N に設定され、入力として createOrder API に渡された場合、住所確認システムは住所を検証します。 YCDVerifyAddressWithAVSUE 外部プログラムが住所の無効を示した場合、オーダーはタイプ YCD_VERIFY_ADDRESS で保留されます。 住所確認が保留の状態になったオーダーは、スケジュールもリリースもできません。

住所確認エージェントは、住所確認保留の状態にあるオーダーをピックアップします。 確認する必要がある、オーダー内の各住所について、エージェントは、verifyAddress API を呼び出します。この API は YCDVerifyAddressWithAVSUE 外部プログラムを呼び出して、AVS と対話します。

AVS が、すべての住所が有効であることを確認すると、エージェントはオーダー上の保留を削除します。

住所が無効の場合、エージェントは保留を拒否します。 住所が無効の場合、AVS は、可能であれば、可能性のある類似一致を複数返します。 エージェントは、AVS によって住所が無効であると示された場合と同じように、この状況を処理します。つまり、オーダーにある保留を拒否して、警告を発行します。 エージェントは、住所が手動で変更されない限り、オーダーの再処理を行いません。

AVS がオンラインでない場合、オーダーから保留を削除してオーダーを処理するか、またはオーダーを拒否して後でエージェントにより再処理できるように、エージェントを構成することができます。

図1： 住所確認エージェント

住所確認エージェント

住所確認エージェントの詳細は、以下のとおりです。

表 1. 属性
属性 値
基本トランザクション ID PROCESS_ORDER_HOLD_TYPE
基本伝票種別 0001 (販売オーダー)
基本プロセス・タイプ (Base Process Type) ORDER_FULFILLMENT
抽象化トランザクション いいえ
呼び出される API verifyAddress
表 2. 重要なパラメーター
パラメーター 説明
アクション このフィールドはアプリケーションが内部で使用します。 有効な値は Get のみです。 このフィールドは変更しないでください。
バッファーに入れるレコード数 オプションです。 一度に取得して処理するレコードの数。 ブランクの場合、または 0 (ゼロ) として指定された場合、デフォルトは 5000になります。
CollectPendingJobs

このパラメーターが N に設定されている場合、エージェントは、この時間トリガー・トランザクションで保留中のジョブの情報を収集しません。 この保留中のジョブの情報は、System Management Console でのエージェントのモニタリングに使用されます。

デフォルトでは、 CollectPendingJobs は Yに設定されています。 特定の時間トリガー・トランザクションが多数の getPendingJobs 照会を実行しており、オーバーヘッド・コストが高すぎる場合は、これを N に設定すると役立ちます。
次回のタスク・キュー間隔

住所を再度処理するまで待機する時間数。 この値は、MUST_VERIFY_ADDRESS ルールと一緒に使用されます。 設定しない場合、デフォルト値は現在の時刻から 5 時間です。

追跡対象の統計

ありません。

保留中のジョブの数

住所の確認が必要なオーダーの数。

テーブル3。 住所検証エージェントによって発生したイベント
トランザクション/イベント キー・データ 公開されるデータ テンプレートがサポートされるか 
VERIFY_ADDRESS_FAILED
 
OrderHeaderKey,
OrderNo
 
VERIFY_ADDRESS.0001
.VERIFY_ADDRESS_
FAILED.001.xml
 はい

YCD_VerifyAddressFailedAlert_1.0 サービスが呼び出され、タイプ YCD_VERIFY_ADDRESS の警告が発行されます。 これらの警告によって、確認が失敗した住所がユーザーに通知されるので、ユーザーは保留を解決することができます。

ユーザーは、警告を開いて詳細を表示できます。 getExceptionDetails API が呼び出され、警告の詳細が表示されます。 getCompleteOrderDetails API が呼び出され、オーダーの未確認の住所のリストが取得されます。 リンクが表示され、必要に応じてオーダー住所を更新できるようになります。

実装

住所確認機能を使用するには、以下の手順を実行する必要があります。
  1. 住所確認を行うエンタープライズについては、YCD_VERIFY_ADDRESS 保留タイプを実装するようにしてください。 住所確認保留タイプを実装するには、以下の手順を行います。
    1. 「アプリケーション・マネージャー」-> 「分散 Order Managementを起動し、住所確認を行うエンタープライズをロードします。
    2. 「分散 Order Management -> <「ドキュメント固有」> -> <「ドキュメント・タイプ」> -> 「フルフィルメント」 -> 「保留タイプ」に移動します。
    3. 「作成」アイコンをクリックし、以下の詳細情報を指定して住所確認保留タイプを作成します。
      • 「保留タイプ」フィールドに、YCD_VERIFY_ADDRESS を入力します。
      • 「保留作成」タブで、次のオプションを選択します。
        • ドラフト・オーダー確認時
        • オーダー作成時
      • 「保留解決」タブで、作成した保留を処理する時間トリガー・トランザクションとして「住所確認」を選択します。
      • 「保留効果」タブでは、この保留上のオーダーに対して処理を行わないようにするトランザクションを指定できます。
    4. 「保存」をクリックします。 保留タイプが保存されます。
    注: この手順で言及されている属性は重要です。 さらに、ビジネス・ニーズに基づいて、保留タイプに関する他の属性を指定できます。
  2. AVS を使用して住所を確認するために、YCDVerifyAddressWithAVSUE 外部プログラムを実装します。
  3. 次のように、住所確認エージェントを構成します。 AVSがオンラインでないときのエージェントの動作を設定するには、 組織と参加者のモデリングの概念を参照してください。
  4. 住所の再処理をエージェントが待機する時間を構成します。 確認できなかった住所の再処理をエージェントが再試行するまでの待機時間は、Applications Manager で構成することができます。 エージェントのクライテリアパラメータの設定については、 組織と参加者のモデリングの概念を参照してください。

エンド・ユーザーへの影響

ユーザーはアドレスを確認し、必要に応じて更新して、オーダーが正しい住所にディスパッチされ、請求されるようにすることができます。