验证地址警报

在很多场景（例如，订单捕获或更改订单地址）中，要求进行地址验证。 应用程序提供地址验证代理进程以验证订单上的地址，并发出警报通知用户采取适当的操作。

解决方案

以下部分描述了 API、用户出口、服务及其他组件。

在捕获或修改地址的同时，verifyAddress API 会采用地址信息，并通过地址验证系统 (AVS) 预先尝试进行验证。 通过 YCDVerifyAddressWithAVSUE 用户出口来处理与 AVS 的通信。 将返回验证过程的状态。 可能的值如下所示：
  • UE_MISSING - 找不到用户出口 YCDVerifyAddressWithAVSUE 的实现。
  • AVS_DOWN - 地址验证系统未响应
  • FAILED - 该地址无法由地址验证系统验证
  • VERIFIED - 该地址已由地址验证系统验证

创建或修改订单期间，如果将 IsAddressVerified 属性设置为“N”，并在输入时将其传递到 createOrder 或 changeOrder API，那么地址验证系统将验证地址。 如果 YCDVerifyAddressWithAVSUE 用户出口指示一个无效地址，那么订单将处于 YCD_VERIFY_ADDRESS 类型的暂挂状态。 无法调度或发布处于地址验证暂挂状态的订单。

地址验证代理将会选取处于地址验证暂挂状态的订单。 对于必须验证的订单中的每个地址，代理都会调用 verifyAddress API，而此 API 随后调用 YCDVerifyAddressWithAVSUE 用户出口来与 AVS 进行交互。

如果 AVS 确认所有地址有效，那么代理将会移除订单的暂挂状态。

如果地址无效，那么代理会拒绝暂挂状态。 地址无效时，AVS 会尽可能返回多个可能的相近匹配项。 代理处理此情况的方式与处理 AVS 指示无效地址的方式相同：拒绝订单的暂挂状态并发出警报。 代理不会重新处理订单，除非手动更改地址。

如果 AVS 处于脱机状态，那么可以配置代理以移除订单的暂挂状态并处理订单，或者拒绝暂挂状态并由代理稍后重新进行处理。

图 1。 地址验证代理
地址验证代理程序

地址验证代理的详细信息如下：

表 1. 属性
属性 值
基本事务标识 PROCESS_ORDER_HOLD_TYPE
基本文档类型 0001（销售订单）
基本进程类型 ORDER_FULFILLMENT（订单实现）
抽象交易 False
已调用 API verifyAddress
表 2。 关键参数
参数 描述
操作 该字段由应用程序在内部使用。 唯一的有效值为 Get。 请勿修改此字段。
要缓冲的记录数 可选。 一次检索并处理的记录数。 如果此项保留为空白或指定为 0（零），那么缺省设置为 5000。
CollectPendingJobs

如果此参数设置为 N，那么代理将不会收集这个时间触发型事务的暂挂作业的相关信息。 此暂挂作业信息用于在系统管理控制台中监控代理。

缺省情况下， 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. 启动 Applications Manager-> 分布式 Order Management，并装入执行地址验证的企业。
    2. 转至 分布式 Order Management -> <Document Specific> -> <Document Type> -> 实现 -> 暂挂类型。
    3. 单击创建图标，以创建包含以下详细信息的地址验证暂挂类型：
      • 在暂挂类型字段中，输入 YCD_VERIFY_ADDRESS。
      • 在创建暂挂选项卡中，选择以下选项：
        • 在确认草稿订单时
        • 在创建订单时
        • 当执行以下修改时：指定相应的修改类型和修改级别。 示例：修改类型可以是“更改收款人”和“更改收货地址”，修改级别可以是“订单”或“行”。
      • 在解决暂挂选项卡中，选择地址验证作为将处理所创建暂挂的时间触发型事务。
      • 在暂挂效果选项卡中，您可以指定将阻止其处理处于此暂挂状态的订单的事务。 此外，还可以指定不允许对处于此暂挂状态的订单所做的修改。
    4. 单击 保存。 这样会保存该暂挂类型。
    注: 过程中提到的属性很重要。 此外，您还可以根据业务需求来为暂挂类型指定其他属性。
  2. 实现 YCDVerifyAddressWithAVSUE 用户出口以使用 AVS 来验证地址。
  3. 配置地址验证代理。 要配置 AVS 不在线时代理的行为，请参阅配置时间触发事务。
  4. 配置代理在重新处理地址前必须等待的时间。 要配置代理在尝试重新处理无法验证的地址前必须等待的时间量，可以在 Applications Manager 中进行配置。 有关配置代理标准参数的更多信息，请参阅配置时间触发事务。

最终用户影响

用户可以验证地址并根据需要进行更新，以便向正确的地址分派订单并出具帐单。