PuppyIP 资源中心
跨境电商开发 5 分钟 发布于 2026-11-19

Shopify B2B 客户为什么看不到公司地点或旧订单?Customer Account API 排查

Shopify 11 月 17 日调整了所有版本的 Customer Account API。B2B 客户只能查看其所属公司的数据和订单,地点可见性还取决于本人在该地点的角色。页面突然少了一个地点或几笔公司订单时,先核对当前登录客户、公司成员身份和地点角色。

Shopify Customer Account API Shopify B2B CompanyLocation 公司订单

服务对象与地域限制

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 时应该先查哪里?

核对当前登录联系人在该地点是否有角色,以及地点是否属于当前客户可进入的公司。测试时分别检查列表、详情和已有页面缓存。