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

Shopify 草稿订单加折扣报 ACCESS_DENIED?检查员工权限与 GraphQL 错误

从 Shopify 11 月 18 日公布的变更看,如果应用以员工身份为草稿订单添加折扣,该员工需要有 Apply discounts 权限(apply_discounts_to_draft_orders)。缺少权限时,Shopify 返回顶层 GraphQL ACCESS_DENIED,对应操作的返回值是 null,草稿不会保存。检查响应的 errors,再分别核对应用的访问范围和员工角色。

Shopify Admin API 草稿订单 ACCESS_DENIED 折扣权限

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 公告适用于所有受支持的 Admin API 版本。
  • 添加新折扣码和从关闭切到开启自动折扣会触发检查。
  • 原样保留或移除已有折扣仍受支持。
  • 应用访问范围与请求所代表员工的折扣权限需要分别核对。

先看哪种操作触发权限检查

规则覆盖 draftOrderCreate 和 draftOrderUpdate。创建草稿时,discountCodes 非空或 acceptAutomaticDiscounts 为 true,就属于添加折扣。更新草稿时,如果请求新增现有草稿没有的折扣码,或首次启用自动折扣,也会触发检查。

假设草稿已有 SAVE10。员工更新备注并原样保留 SAVE10,或从草稿移除此折扣码,Shopify 公告描述的这项检查不会因该折扣而拒绝请求。若改用另一个尚未关联的折扣码,则属于新增。其他草稿权限与输入校验仍适用。

分别核对应用访问范围和员工权限

先确认调用对应店铺时使用的是哪类访问令牌,以及应用是否具有 write_draft_orders。以员工身份发起的请求,还要检查执行请求的员工角色是否有管理草稿订单及应用折扣所需的权限。员工能打开草稿或编辑普通字段,仍可能没有添加折扣的权限。

Shopify 的公告把离线令牌等非员工身份请求排除在本次新增检查之外。保留现有调用的身份和授权模式。确需调整权限时,交由商家管理员按该岗位所需权限处理。

前端和后台任务怎样识别失败

解析 GraphQL 响应时先检查顶层 errors,记录相关错误的 code 和 path,并检查相应的 mutation payload 是否为 null。对于这项变更,单独读取 payload 中的 userErrors 会漏掉拒绝。若 payload 存在,再处理返回的 userErrors,并确认返回了预期草稿。

收到此类权限拒绝后,把本次操作标记为失败并提示核对操作者权限。在授权测试店铺复核时,分别测试保留现有折扣和新增折扣的响应。确认权限或请求条件已纠正后,再用最小必要输入重试。

为什么同一个操作只在部分员工账号失败

例如,两名员工都可编辑草稿,其中只有一人能应用折扣。如果应用以当前员工身份调用 API,两人提交同一张草稿的折扣修改时可能得到不同结果。排查时记录店铺、请求时间、API 版本、操作名和错误代码,再到商家后台查对应员工角色,避免仅因同一个应用在其他员工账号可用就排除权限问题。

也要检查表单是否把系统建议的优惠码或自动折扣选项一并提交。界面上仅修改备注,实际发送的新折扣字段仍可能触发拒绝。用测试店铺确认保留原折扣的普通字段更新与新增折扣分别是什么响应,不要记录访问令牌或客户数据。

资料来源

常见问题

切换到另一个 API 版本能解决吗?

Shopify 公告明确覆盖所有受支持的版本。先确认请求代表哪位员工,以及应用和员工各自的权限。

修改备注时需要把已有折扣清空吗?

不必为了这项检查移除原折扣。原样保留和移除已有折扣都不属于新增。若应用自动补入一个不同的折扣码,要检查它生成的输入。

HTTP 请求成功,界面为什么没保存草稿?

HTTP 层返回成功时仍应检查 GraphQL 响应。顶层 errors 出现 ACCESS_DENIED 且对应 mutation payload 为 null 时,本次添加折扣没有保存。