创建草稿订单-draftOrderCreate mutation

创建草稿订单。

所需的访问

write_draft_orders 访问范围。

在本页面

• 互动范例
• 参数
• DraftOrderInput字段
• 返回字段

互动范例

这是一个示例变异查询。使用下面的嵌入式交互式工具来编辑查询。

提示：使用Ctrl+Space表示自动填充字段。

<font style="color:#1F61A0;">draftOrder </font><font style="color:#555555;">{</font> 
  <font style="color:#1F61A0;">ID</font>
<font style="color:#555555;">}</font>
<font style="color:#1F61A0;">userErrors </font><font style="color:#555555;">{</font> 
  <font style="color:#1F61A0;">场地</font>
  <font style="color:#1F61A0;">信息</font>
<font style="color:#555555;">}</font>

参数

DraftOrderInput字段

• AppliedDiscount（[DraftOrderAppliedDiscountInput](https://shopify.dev/docs/admin-api/graphql/reference/orders/draftorderapplieddiscountinput)）
  将应用于订单草稿的折扣。订单草稿订单项可以享有一个折扣。草稿订单也可以有一个订单级别的折扣。
• billingAddress（[MailingAddressInput](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/mailingaddressinput)）
  与付款方式关联的邮寄地址。
• customAttributes（[[AttributeInput!]](https://shopify.dev/docs/admin-api/graphql/reference/orders/attributeinput)）
  向客户添加了额外的信息。
• customerId（[ID](https://shopify.dev/docs/admin-api/graphql/reference/scalar#id-2021-01)）
  与订单草稿关联的客户。
• 电子邮件（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
  客户的电子邮件地址。
• lineItems（[[DraftOrderLineItemInput!]](https://shopify.dev/docs/admin-api/graphql/reference/orders/draftorderlineiteminput)）
  与草稿订单相关联的产品变体订单项或自定义订单项。每个草稿订单必须至少包含一个订单项。
• localizationExtensions（[[LocalizationExtensionInput!]](https://shopify.dev/docs/admin-api/graphql/reference/translations/localizationextensioninput)）
  订单附加的本地化扩展。例如，税号。
• 元字段（[[MetafieldInput!]](https://shopify.dev/docs/admin-api/graphql/reference/metafields/metafieldinput)）
  附加到草稿订单的元字段。
• 注意（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
  商店所有者可以附加到草稿订单的可选注释的文本。
• privateMetafields（[[PrivateMetafieldInput!]](https://shopify.dev/docs/admin-api/graphql/reference/metafields/privatemetafieldinput)）
  草稿订单所附的专用元字段。
• shippingAddress（[MailingAddressInput](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/mailingaddressinput)）
  将订单运送到的邮寄地址。
• shippingLine（[ShippingLineInput](https://shopify.dev/docs/admin-api/graphql/reference/orders/shippinglineinput)）
  运送对象，详细说明了使用的运送方法。
• 标签（[[String!]](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
  以逗号分隔的已添加到草稿订单中的标签列表。
• taxExempt（[Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01)）
  订单草案是否免税。如果为假，则Shopify将参考每个订单项的应纳税字段。如果将客户应用于订单草稿，则Shopify将改用客户的免税字段。
• useCustomerDefaultAddress（[Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01)）
  作为草稿订单对象的一部分发送，以加载客户运输信息。

返回字段

• draftOrder（[DraftOrder](https://shopify.dev/docs/admin-api/graphql/reference/orders/draftorder)）
  创建的草稿订单。
• userErrors（[[UserError!]!](https://shopify.dev/docs/admin-api/graphql/reference/usererror)）
  执行突变时发生的错误列表。