住所キャプチャーおよび表示の実装
オーダーを作成、変更、および履行するには、顧客の住所が必要です。 店員は顧客の有効な住所を取得し、 スターリング Store Engagement、住所を適切な形式で表示することができる。 このセクションでは、住所キャプチャーおよび表示を実装し、国ベースの住所キャプチャー・フォームおよびテンプレートをサポートするために使用される API、外部プログラム、サービス、およびその他のコンポーネントについて説明します。
解決方法
- 住所をキャプチャーする際に、顧客の国と郵便番号がキャプチャーされていない場合、それらは現在のストアのデフォルトの国と郵便番号として扱われます。
- ただし、顧客が別の国の住所を提供することを希望する場合、ストア担当者は 「国/地域」 リストから国を選択できます。
国のリストにデータを取り込むために、
CodeTypeがCOUNTRYに設定されてgetCommonCodeListAPI が呼び出されます。 getRegionListAPI は、入力基準を満たす地域のリストを返します。 この API は、 「都道府県選択に使用する地域スキーマ」 ルールから地域スキーマを判別し、エンティティーのPersonInfoエレメント内のState属性によって使用される地域のリストを返します。- ストア担当者が国を選択すると、該当する住所キャプチャー・フィールドが表示され、
getRegionListAPI を使用して対応する都道府県・州のリストが取得されます。 地域が取得されない場合、リストはテキスト・フィールドで置き換えられます。 - 都道府県と市区町村は、有効な郵便番号が指定されている場合に、
getRegionListAPI を使用して自動的に入力されます。
アドレスの検証
顧客の住所は、オーダーに保存する前に確認されます。 verifyAddress API が呼び出され、住所が確認されます。 次にこの API は、ユーザーによって指定された入力の妥当性検査を行う YCDVerifyAddressWithAVSUE 外部プログラムを呼び出します。
すべての属性が有効で、住所が正しく確認された場合、IsAddressVerified フラグが適宜更新されます。 アプリケーションは、ユーザー出口を使用してアドレス検査システム (AVS) と対話し、適切な値を verifyAddress API に返します。
VERIFIED。 画面が閉じられ、住所が確認済みとしてマークされます。FAILED。verifyAddressAPI によって返されたエラー理由が画面に表示され、ストア担当者が解決できるようになります。 ストア担当者が 「適用」を選択すると、住所は有効であると想定され、検証済みとして返されます。AVS_DOWN。 画面は閉じられ、住所は未検証としてマークされますが、有効と見なされます。
複数の住所が返された場合、または ProceedWithSingleAVSResult 属性が値 Nで返された場合、画面は複数の住所選択モードに切り替わります。ここで、ストア担当者には、元の住所とともに結果のリストが表示されます。このリストから、担当者は住所を選択できます。
getCommonCodeList。CodeTypeがCOUNTRYである国のリストをフェッチします。getRegionList。 選択した国および地域スキーマに基づいて、Region Schema To Use For State Selectionルールから都道府県・州のリストを取り出します。 また、郵便番号に基づいて都道府県と市区町村をフェッチします。verifyAddress。 アドレス検証システム (AVS) に対して入力アドレスを検証します。
アドレス・キャプチャー UI コンポーネント
アドレス・キャプチャ共有コンポーネントは、 Sterling Store Engagement のアドレスをキャプチャするために app-common-module に作成されます。 このコンポーネントを使用して、オーダー取得時に顧客の住所を追加または変更できます。
デフォルトでは、米国およびカナダ用の住所キャプチャー・テンプレートがサポートされています。 他の国の住所キャプチャー・テンプレートを追加したり、住所フィールドを国にマップしたりすることができます。 アドレス・キャプチャの実装の拡張については、 アドレス・キャプチャの拡張を参照のこと。