服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 本次更新适用于所有 Customer Account API 版本,GraphQL schema 保持原样。
- 当前联系人的地点列表按本人角色筛选;查看其他联系人的地点列表会得到空列表。
- 地点上的 taxIdentifier、contacts、roleAssignments 可能为 null 或空连接。
- 客户被移出公司后,其公司订单和草稿订单从列表中移除,个人订单仍可见。
先核对当前客户在公司地点的角色
先确认用户进入的账号和它代表的公司,以及用户在哪些地点仍有角色。当前客户可在自己的 CompanyContact.locations、Company.locations 和 companyLocation(id:) 中读取本人有角色的地点。若把另一个联系人的 locations 当成地点选择器的数据源,列表将为空。
用 companyLocation(id:) 打开地点详情时,若当前联系人缺少角色,参考文档给出的结果是 null。若从已获授权的订单上下文读取地点对象,也要让税号、联系人和角色列表的组件支持缺失状态。地点显示名称和某些字段的可见性应分别判断。
分别处理详情空值和列表缺项
例如,某位买手仍属于一家公司,但当前只负责其中一个仓库。他的地点选择器只应显示当前登录账号可见的地点。如果只缺税号,可使用“税号不可查看”之类的中性状态,避免把空值保存成新的税号或显示为零。
显示联系人或角色时,区分空连接与请求失败。收到空值或少量结果时,可根据同一账号的角色核对结果决定页面状态。若响应另有 GraphQL errors,再处理对应错误。记录实际 API 版本、操作名和缺失字段,诊断样本省略令牌、税号和联系方式。
退出公司后重新核对订单历史
商家把客户移出公司后,Customer Account API 的 order(id:) 和 draftOrder(id:) 会拒绝返回该公司的相应订单。customer.orders 与 customer.draftOrders 也会排除该公司的记录,客户个人订单仍会列在个人订单历史中。
在买家侧刷新订单历史时,按当前会话重新读取。公司权限发生变化后,清除旧的公司订单预览,并让详情页显示当前不可查看。即使应用缓存了摘要或曾经给出订单详情链接,也要依据现在的会话权限决定显示内容。
用测试店验证三种可见性
在受控的测试店准备一名具备地点角色的买手、一名仍属公司但在该地点无角色的买手,以及一名已从测试公司移除的客户。分别验证地点选择器、地点详情和订单列表。对最后一名客户,同时检查个人订单仍在,确认页面能保持正常使用。
Shopify 说明无需改写查询。应用端需要接住较少结果、空连接或 null。把这些结果加入现有检验,特别留意页面会不会把正常的权限变化显示成加载失败,或在账号权限降低后继续显示旧摘要。
资料来源
常见问题
把 Customer Account API 切回较早版本有用吗?
本次规则适用于所有版本。先按当前客户的公司成员身份和地点角色核对可见数据,再检查应用对空值和空连接的处理。
旧公司订单从个人历史消失,表示商家删除订单了吗?
更新说明的是客户侧读取范围。客户离开公司后,公司订单从此人的列表排除,详情读取也会被拒绝。商家应通过有权访问的管理入口核对订单状态。
地点详情显示 null 时应该先查哪里?
核对当前登录联系人在该地点是否有角色,以及地点是否属于当前客户可进入的公司。测试时分别检查列表、详情和已有页面缓存。