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

Shopify Functions 找不到 deliverableLines.cartLine?核对版本、空值与组件金额

Shopify Functions 的输入查询如果提示找不到 deliverableLines.cartLine,先核对扩展的 API 版本和 target。查询能通过但返回 cartLine: null 时,再检查履约行还有没有对应购物车行。组合商品的组件金额可以从履约行自己的 cost 读取。

Shopify Functions deliverableLines cartLine Fulfillment Constraints 组合商品

服务对象与地域限制

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

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

本文要点

  • 11 月 19 日核查时,Order Routing Location Rule 和 Fulfillment Constraints 的 unstable 参考都列出 cartLine 与 cost。
  • 同两个 API 的 2027-01 候选版和 2026-10 稳定版参考未列出这两个履约行字段。
  • 同一个组合商品的多个组件可以关联同一个购物车行,订单编辑后关联也可能为空。
  • 组件金额使用履约行自己的 cost,按需要选择对应的金额字段和币种。

字段校验失败时,先对照版本和 target

Shopify 在 11 月 13 日的 Functions 更新记录中提到履约行增加 cost 和对应购物车行。实际输入字段路径是 cart.deliverableLines。11 月 19 日核查官方参考时,Order Routing Location Rule 与 Fulfillment Constraints 的 unstable 版本包含 cartLine 和 cost,两个 API 的 2027-01 与 2026-10 参考在同一位置均未列出这两个字段。

如果编辑器提示 Cannot query field 之类的错误,核对 shopify.extension.toml 里的 API 版本和 target,再从 Function 目录运行 shopify app function schema。用重新生成的 schema.graphql 检查字段。CLI 按 TOML 里的 Function API 类型和版本生成 schema,文档中的 unstable 字段能否使用以扩展实际 schema 为准。

查询通过后,为 cartLine: null 留一条处理路径

组合商品如果在 cart.lines 中只占一行,每个组件仍可作为独立的 deliverable line 出现,并指向同一父行。需要读取父行 ID 或属性时,先判断 cartLine 是否存在。订单编辑后整套商品可能已离开购物车,仍出现的履约行此时可能返回 cartLine: null。

例如,某个规则要从父行读取一项属性。关联为空时,可以按业务规则跳过依赖父行的判断,并记录缺失状态。让履约行自己的数量或金额处理走它们已有的逻辑。避免用同一 SKU 或商品名称猜测应关联哪一行。

按规则选择组件金额或整套金额

若规则按配送组件金额计算,读 deliverable line 自己的 cost。若规则面向整套商品,且 cartLine 存在,才取该购物车行的金额。多个组件共享父行时,把整套金额重复带入每个组件会放大结果。

例如要根据单件组件金额归类,在输入查询中选择该履约行 cost.amountPerQuantity 下的 amount 和 currencyCode。这个金额是十进制,且代表单件。需要行总额的规则应选择相应总额字段,并明确处理数量、折扣口径和币种。

用三种测试输入确认

用开发店铺或经授权的 Function 测试输入分别覆盖普通商品、共用同一父行的多个组合组件,以及订单编辑后 cartLine 为空的情况。看输入查询是否先通过 schema 校验,再核对函数在有无父行的情况下产生的结果。

保存一份精简的脱敏输入和预期结果,包括实际 API 版本、target、组件金额和规则选用的币种。这样后续即使版本升级,也能区分字段支持变化、空值处理和金额口径变化。

资料来源

常见问题

2027-01 已是候选版,为什么 schema 里没有这两个字段?

本次核查时,两个 Function API 的公开参考仅在 unstable 版本列出它们。先核对扩展所用的 target 与 API 版本,然后以生成的 schema 为准。

cartLine 返回 null 时,其他履约行信息还能用吗?

cartLine 的可空性指父购物车行可缺失。已请求且在当前 schema 可用的履约行字段仍按各自的类型和业务含义处理。

多个组件的 cartLine.id 相同是数据重复吗?

这是组合商品仅占一个父购物车行时可能出现的正常输入。分别处理组件信息,避免按父行 ID 去重时丢掉合法组件。