新一代平台

实施客户搜索

在线编辑

店铺助理可以搜索客户并查看客户与店铺和企业的互动。 本部分描述了用于实现客户搜索的 API ，服务和其他组件。

当客户访问商店时，店铺助理可以通过识别客户并查看概要文件来吸引客户参与购买。 概要文件显示客户的基本详细信息以及订单历史记录。

假设和限制

  • 仅支持具有 CustomerType=02的客户。
  • 支持电话号码和电子邮件标识的完全匹配。

解决方案

查找客户 Portlet

店铺助理可以使用完整电话号码或电子邮件标识来搜索客户。 或者，店铺助理可以单击 高级搜索 以使用名字和姓氏来搜索客户。

将调用 getCompleteCustomerList API 来检索匹配的客户。 API 与客户的电话号码或电子邮件标识完全匹配，并返回结果。
  • 如果单个客户作为搜索结果返回，那么将显示 " 客户概要文件 " 屏幕，其中包含客户的联系详细信息，送货信息和订单历史记录。
  • 如果多个客户作为搜索结果返回，那么将显示 " 客户搜索结果 " 屏幕。 店铺助理可以单击 查看 以查看 " 客户概要文件 " 页面。

" 客户搜索结果 " 页面

" 客户搜索结果 " 页面显示以下信息:
  • 修改搜索

    店铺助理可以使用 修改搜索 链接来查看和修改搜索条件。

  • 客户搜索结果

    店铺助理可以根据搜索条件作为单独的卡来查看客户列表。 此页面显示客户的基本信息，例如姓名，电话号码，电子邮件标识和地址。 单击 查看 将打开 " 客户概要文件 " 页面。

" 客户概要文件 " 页面

" 客户概要文件 " 页面显示以下信息:
客户详细信息
店铺助理可以查看基本详细信息，例如客户的名称，电话号码，电子邮件标识和地址。 客户的电子邮件标识和电话号码取自客户的联系方式，而不是取自客户的地址。 缺省送货地址和帐单地址也显示在客户概要文件屏幕中。

将调用 getCompleteCustomerDetails API 以获取客户详细信息。

缺省情况下，仅显示名称，电话号码和电子邮件。 单击 更多信息 将展开客户详细信息以显示缺省帐单地址和送货地址以及 编辑概要文件 按钮。 单击 隐藏 将折叠该部分。

编辑概要文件
店铺助理可以通过单击 " 客户概要文件 " 页面的 "客户详细信息" 部分中的 编辑概要文件 来修改客户概要文件。 仅当单击 更多信息 时，才会显示 编辑概要文件 按钮。 此操作由资源许可权控制。 (编辑客户概要文件)。
单击 编辑概要文件 时，将调用 getCompleteCustomerDetails API 以填充客户的以下详细信息:
  • 联系信息面板包括名字，姓氏，电话号码和电子邮件地址。
  • " 地址 " 面板显示缺省送货地址和帐单地址后跟其余地址的所有地址。
  • 如果 getCompleteCustomerDetails API 调用失败，那么将显示一条错误消息，其中包含用于重试编辑的链接。
  • 确认更改后，将调用 manageCustomer API 以将更改保存到客户记录。
  • 将显示一条消息以确认客户详细信息已成功修改。 如果发生错误，将显示相应的错误消息。
订单历史
店铺助理可以在 " 客户概要文件 " 页面的 订单 面板中查看客户的订单历史记录。

将调用 getOrderList API 以获取当前客户的订单列表。 如果订单历史记录具有较长的订单列表，那么可以使用订单日期，订单状态和订单渠道作为过滤器选项来对其进行优化。 店铺助理还可以仅过滤属于当前店铺的订单。 处于 "草稿订单" 和 "已取消" 状态的订单不会显示在订单历史记录中。

过滤顺序
  • 当店铺助理单击 过滤器 选项时，将调用 getCommonCodeList API (CodeType=ENTRY_TYPE) 以填充条目类型复选框。 将从 order-list-filter.config.ts 文件中的预定义列表中选取订单状态。 此文件可配置，因此您可以根据需要定制状态。 有关在订单筛选器中自定义订单状态的更多信息，请参阅 《向筛选条件添加自定义订单状态 》。
  • 当店铺助理选择相应的过滤条件并应用过滤器时，会将过滤条件传递到 getOrderList API 以检索与输入条件匹配的订单。 可以将订单状态、日期范围、卖方组织代码以及具有相应 EntryType 属性的复杂查询作为输入传递到 getOrderList API 以检索订单。 对于 Store ， Online 和 Call Center 通道， EntryType 分别为 Store， Online和 Call Center 。
排序顺序
店铺助理可以使用下列其中一个选项对订单历史记录下的订单进行排序:
  • 从最旧到最新
  • 从最新到最旧

缺省情况下，订单按最新的第一个顺序排序。 将调用 getOrderList API 以根据用户选择的排序选项对订单进行排序。 如果没有要显示的订单历史记录，那么将禁用 排序 按钮。

用于对订单进行排序的选项是可定制的。 有关如何自定义排序选项的更多信息，请参阅客户资料页面中的“为订单添加自定义排序选项 ”。

注意

" 客户概要文件 " 页面中的标题显示 注释 按钮以及与客户概要文件关联的注释计数。 店铺助理可以单击该按钮以查看和管理注释。

每个注释都具有注释文本，添加该注释的用户 (系统或用户) ，添加该注释的日期以及重要注释的情况标志。 如果需要，店铺助理可以添加新注释并将其标记为重要。

当店铺助理单击 注释 按钮时，将调用 getParticipantNoteList API 以显示已与客户概要文件关联的注释。 在店铺助理添加注释时，会调用 manageCustomer API 以添加新注释。