アカウント入力検証
Liferay DXP 2026.Q3+ リリース機能
アカウント入力検証は、注文が行われる前に購入アカウントを確認します。 Liferayは、すぐに使えるバリデーターとしてVIESバリデーターを提供しており、これはチェックアウト時にビジネスアカウントのEU VAT番号を欧州委員会のVAT情報交換システム(VIES)と照合して検証します。 設定手順については、 VIES バリデーターの有効化 を参照してください。
この機能は、アカウントエントリ検証および VIES バリデーター (LPD-89850) リリース機能フラグの背後にあり、デフォルトでは無効になっています。
VIESバリデーターは、請求先住所の国がバリデーターの設定済み国リストに含まれているビジネスアカウントを、アカウントの納税者番号をVAT番号として使用してチェックします。 その他のアカウントタイプや他国からの請求アカウントは、記録結果を残すことなくスキップされ、スキップされたアカウントは、あたかも承認されたかのようにチェックアウトが完了します。
注文処理における検証ゲート。 チェックは、ストアフロントのチェックアウトとデリバリーカートのヘッドレスチェックアウト (POST /o/headless-commerce-delivery-cart/v1.0/carts/{cartId}/checkout または /carts/by-externalReferenceCode/{externalReferenceCode}/checkout ) で実行されます。 小切手が不渡りになった場合、注文は確定されません。 注文ステータスの変更を含め、その他の操作ではチェックは実行されません。
検証モード
各 チャネル には独自のアカウント入力検証設定があり、チェックが失敗した場合に注文をブロックするかどうかを決定します。
| モード | Description |
|---|---|
| すべて許可 | バリデーターが実行され、結果が記録されるが、結果によって注文がブロックされることはない。 ブロックモードを適用する前に、このモードを使用して検証履歴を収集してください。 |
| 成功のみを許可する | 注文は、小切手が合格した場合、または小切手がスキップされた場合にのみ処理されます。 VIESの障害により、サービスが復旧するまで、EU企業の決済はVIES経由で停止されます。 |
| 技術的な障害を許容する | 無効なVAT番号は注文をブロックしますが、技術的な不具合はブロックしません。 VIESシステムの障害発生中も、VAT番号が確認されないまま注文が継続される。 |
| 無効 | バリデーターは実行されません。 これはデフォルト値です。 |
検証結果
アカウントの検証履歴には、以下の結果が記録されます。
- 成功: VIES が VAT 番号を確認しました。
- 失敗: VIES が VAT 番号を拒否したか、検証者が VIES に連絡する前にアカウントを拒否しました。 納税者番号が欠落している場合と、請求先住所がアカウントに登録されていない場合の両方で、この結果が発生します。
- 警告: 技術的な障害が発生しました。 VIESは、タイムアウト、利用できない加盟国サービス、または送信接続のブロックにより、応答できませんでした。
- 手動: VIES チェックなしで手動で記録されたパス。
SUCCESS または MANUAL の結果は、 チェック間隔 が経過するまで、VIES を再度呼び出す代わりに再利用されます。この間隔はデフォルトで 15 日です。 保存される結果は、注文ではなく、アカウントと請求先住所に関連付けられています。 別の請求先住所でチェックアウトすると、新たなチェックが行われます。 FAILUREおよびWARNINGの結果は、次回のチェックアウト時に必ず再試行されます。
履歴の閲覧と手動検証の記録については、 アカウント検証結果の確認 を参照してください。
検証エラーが発生した状態でチェックアウトする
ブロックされた注文は、注文概要のチェックアウトステップで停止し、バリデーターのメッセージが表示され、「戻る」ボタンのみが表示されます。 カートは中身を保管する。 このブロックは、決済を試みた購入者だけでなく、アカウントのすべてのメンバーに適用されます。

チェックアウト画面では、入力内容の修正はできません。 拒否された VAT 番号を解決するには、アカウントの 詳細 タブで正しい税務 ID を設定してください。 購入者はその後、決済手続きを再度行う。 詳細については、 アカウント を参照してください。
検証に失敗したデリバリーカートのヘッドレスチェックアウトは、カートが配置されず、 が有効な が に false に設定された HTTP 200 を返します。 バリデーターがメッセージを提供すると、リクエストのロケールに翻訳されて、カートの errorMessagesに表示されます。 チェックによって注文がブロックされた場合、ステータスコードは変更されないため、 の値が有効な は、チェックアウトが完了しなかったことを示すシグナルです。 その他の失敗したチェックも 有効 を 無効に設定し、レスポンスには結果ステータスがありません。 アカウント検証が原因であることを確認し、拒否された VAT 番号と技術的なエラーを区別するには、 検証履歴 の resultStatus を読み取ります。