大数跨境

通过 Admin GraphQL API 向草稿订单行项目添加销售计划

通过 Admin GraphQL API 向草稿订单行项目添加销售计划 Shopify电商独立站
2026-10-28
0
导读:Admin GraphQL API 2027-01 版本为草稿订单添加了销售计划支持。您现在可以将销售计划应用于草稿订单项,并读取已应用的销售计划信息。这些字段为新增字段,因此无需任何操作即可保持您的

Admin GraphQL API版本2027-01为草稿订单添加了销售计划支持,您现在可以将销售计划应用于草稿订单项并读取已应用计划的详情,这些字段是附加的,因此无需采取任何操作即可保持您的应用正常运行。

新增内容

在 GraphQL Admin API 中,三个新字段使您的应用能够处理草稿订单上的销售计划:

  • DraftOrderLineItemInput.sellingPlanId用于在创建或更新草稿订单项时设置要应用的销售计划,此输入字段可应用于draftOrderCalculate、draftOrderCreate和draftOrderUpdate,请注意,您只能将销售计划附加到产品变体订单项上。
  • DraftOrderLineItem.sellingPlanApplication 返回应用于已保存草稿订单项的销售计划。
  • CalculatedDraftOrderLineItem.sellingPlanApplication 返回计算后草稿订单上应用的销售计划,以便您在保存之前预览结果。

以下示例将销售计划应用于订单项,并读取回应用的销售计划:

mutation { draftOrderCreate(input: { lineItems: [{ variantId: "gid://shopify/ProductVariant/1", quantity: 1, sellingPlanId: "gid://shopify/SellingPlan/1" }] }) { draftOrder { lineItems(first: 1) { nodes { sellingPlanApplication { sellingPlanId name } } } } userErrors { field message } } }

需要注意的行为

  • 仅支持周期性订阅计划和预付费订阅计划。不支持固定计费计划,例如预售和先试后买。
  • 不支持 B2B 草稿订单、自定义订单项以及销售计划行上的价格覆盖。
  • draftOrderComplete目前尚不支持:对包含销售计划订单项的草稿调用draftOrderComplete会返回用户错误且不会创建订单,您可以通过draftOrderInvoiceSend将草稿订单发票发送至结帐页面。

在我们的产品更新日志和帮助文档中了解更多有关此更改的信息。

【声明】内容源于网络
0
0
Shopify电商独立站
1234
内容 7146
粉丝 0
Shopify电商独立站 1234
总阅读87.4k
粉丝0
内容7.1k