草稿订单

草稿订单是商家在付款前为客户创建的订单。
使用 DataEase 的场景：

• 电话或聊天销售 – 创建并通过电子邮件发送结账链接。
• 批发或预购交易 – 添加自定义价格和商品。
• 批量重新创建订单或快速报价。

Shopify 草稿订单指南。

---

目录

1. 导出
2. 导入
3. 字段参考
4. 过滤器

---

2. 导出

1. 选择 CSV（适合多行项目）或 Excel。
2. 选择 DraftOrder 作为实体。
3. 选择列，例如 tags、lineItemVariantId、customerEmail。
4. 运行任务并下载文件。

详情：导出指南

---

3. 导入

命令

草稿订单行 command: CREATE, UPDATE, REPLACE, DELETE, IGNORE
行项目行 itemCommand: CREATE, UPDATE, MERGE, DELETE, IGNORE
操作（可选）：COMPLETE, DUPLICATE, SEND_INVOICE

规则

• CREATE 至少需要 email 或 phone（或 customerId）。
• 第一行（topRow = TRUE）是订单头；后续行添加项目/地址。
• UPDATE 跳过空白单元格；REPLACE 仅用给定列覆盖。
• 每次导入运行仅允许一个操作。

步骤

1. 下载示例：DraftOrder-import-sample.xlsx
2. 编辑标题行并添加项目行。
3. 在 DataEase 中映射列，上传并开始。

完整帮助：导入指南

---

4. 字段参考

以下是您可以使用的每个列。“仅导入”表示该值可以上传但不会在导出时返回。

一般订单字段

• id — 草稿订单 ID。用于 UPDATE, REPLACE, DELETE。

• command — 主行操作（CREATE, UPDATE, 等）。

• acceptAutomaticDiscounts — true 允许 Shopify 自动应用商店折扣。

• allowDiscountCodesInCheckout — true 允许客户在结账时输入折扣码。

• presentmentCurrencyCode — 客户支付的货币。

• discountCodes — 订单上的代码列表。

• email — 客户的发票电子邮件。

• phone — 客户电话。

• note — 订单的内部备注。

• tags — 标签列表。

• tagsCommand — 添加、移除或替换标签。

• poNumber — 采购订单号。

• customAttributes — 显示给客户的键值元信息。

• reserveInventoryUntil — 保留库存的 ISO 日期。

行项目字段（topRow = FALSE，含项目值）

• lineItemUuid — 行的唯一 ID；使用捆绑包时必需。

• itemCommand — 对此行的 CREATE, UPDATE, MERGE, DELETE, IGNORE。

• lineItemVariantId — 变体 ID（自定义项目留空）。

• lineItemTitle — 自定义项目的标题（如果设置了 variantId 则忽略）。

• lineItemQuantity — 要添加的数量。

• lineItemOriginalUnitPrice — 折扣前的价格。

• lineItemOriginalUnitPriceCurrency — originalUnitPrice 的货币代码。

• lineItemAppliedDiscountValue — 此行的折扣值。

• lineItemAppliedDiscountValueType — FIXED_AMOUNT 或 PERCENTAGE。

(类似字段存在于重量、SKU、条形码等)

客户链接

• customerId — 现有客户 ID。如果为空，则通过电子邮件/电话匹配或创建新客户。

• customerCompanyId — B2B 订单的公司 ID。

账单和送货地址

• billingAddress1 — 账单街道地址 1。

• shippingAddress1 — 送货街道地址 1。

(每个地址都有对应的城市、邮编、省代码、国家代码、电话等)

订单级别折扣

• appliedDiscountTitle — 自定义订单折扣的名称。

• appliedDiscountValue — 折扣金额（金额或百分比）。

• appliedDiscountValueType — FIXED_AMOUNT 或 PERCENTAGE。

送货线

• shippingTitle — 显示的送货标题。

• shippingLinePresentmentPrice — 以展示货币计算的送货成本。

仅导入助手

• action — 导入行后 COMPLETE, DUPLICATE, 或 SEND_INVOICE。仅导入。

• shippingLinePrice — 以商店货币计算的送货成本。仅导入。

• useCustomerDefaultAddress — true 使用客户默认的送货/账单地址。仅导入。

Metafields

• metafields — 自定义 metafield 列。参见 Metafields 指南。

---

5. 过滤器

• CreatedAt — 导出在某个日期或范围内创建的草稿订单。

• CustomerId — 导出与某个客户相关的草稿。

• Id — 按 ID 导出单个草稿。

• Source — 按来源过滤（API、POS 等）。

• Status — OPEN, INVOICE_SENT, COMPLETED。

• Tag — 包含匹配标签的草稿。

• UpdatedAt — 选择最后更新的日期范围。

---

需要帮助吗？我们的支持团队会在 24 小时内回复。

其他字段

DataEase 支持此实体的更多列：

• currencyCode — 草稿订单的货币代码。
• completedAt — 草稿订单完成的时间戳。
• name — 草稿订单的名称。
• totalPrice — 草稿订单的总价格。
• totalShippingPrice — 草稿订单的总运费。
• totalWeight — 草稿订单的总重量。
• totalTax — 草稿订单的总税额。
• subtotalPrice — 税前和折扣前的小计价格。
• invoiceUrl — 草稿订单发票的 URL。
• invoiceSentAt — 发票发送的时间戳。
• taxesIncluded — 如果价格中包含税费，则为 true。
• visibleToCustomer — 如果草稿订单对客户可见，则为 true。
• warnings — 与草稿订单相关的警告。
• lineItemId — 草稿订单中行项目的 ID。
• lineItemName — 行项目的名称。
• lineItemOriginalTotal — 行项目的原始总价格。
• lineItemTaxable — 如果行项目应纳税，则为 true。
• lineItemTotalDiscount — 应用于行项目的总折扣。
• lineItemSku — 行项目的 SKU。
• lineItemVariantBarcode — 行项目变体的条形码。
• lineItemVariantTitle — 行项目变体的标题。
• lineItemVendor — 行项目的供应商。
• lineItemVariantPrice — 行项目变体的价格。
• lineItemVariantProductTags — 行项目变体的产品标签。
• lineItemVariantInventoryQuantity — 行项目变体的库存数量。
• lineItemWeightUnit — 行项目的重量单位。
• lineItemWeightValue — 行项目的重量值。
• lineItemIsGiftCard — 如果行项目是礼品卡，则为 true。
• lineItemRequiresShipping — 如果行项目需要运输，则为 true。
• lineItemProductId — 行项目的产品 ID。
• lineItemProductHandle — 行项目的产品 handle。
• lineItemProductType — 行项目的产品类型。
• lineItemCustomAttributes — 行项目的自定义属性。
• lineItemAppliedDiscountPresentmentAmount — 行项目上应用折扣的展示金额。
• lineItemAppliedDiscountShopAmount — 行项目上应用折扣的商店金额。
• lineItemAppliedDiscountDescription — 行项目上应用折扣的描述。
• lineItemAppliedDiscountTitle — 行项目上应用折扣的标题。
• customerEmail — 客户的电子邮件地址。
• customerFirstName — 客户的名字。
• customerLastName — 客户的姓氏。
• customerCreatedAt — 客户创建的时间戳。
• customerLocale — 客户的语言环境。
• customerNote — 与客户相关的备注。
• customerPhone — 客户的电话号码。
• customerNumberOfOrders — 客户下的订单数量。
• customerState — 客户的状态。
• customerAmountSpentAmount — 客户花费的总金额。
• customerTags — 与客户相关的标签。
• customerSmsMarketingConsent — 如果客户同意短信营销，则为 true。
• customerEmailMarketingConsent — 如果客户同意电子邮件营销，则为 true。
• customerTaxExempt — 如果客户免税，则为 true。
• customerCompanyName — 客户的公司名称。
• customerLocationId — 与客户相关的地点 ID。
• customerContactId — 客户的联系人 ID。
• customerCompanyExternalId — 客户的外部公司 ID。
• billingName — 完整的账单名称。
• billingFirstName — 账单的名字。
• billingLastName — 账单的姓氏。
• billingCompany — 账单的公司名称。
• billingPhone — 账单的电话号码。
• billingAddress2 — 账单地址的第二行。
• billingCity — 账单的城市。
• billingCountry — 账单的国家。
• billingCountryCode — 账单的国家代码。
• billingZip — 账单的邮政编码。
• billingProvince — 账单的省份。
• billingProvinceCode — 账单的省份代码。
• shippingName — 完整的送货名称。
• shippingFirstName — 送货的名字。
• shippingLastName — 送货的姓氏。
• shippingCompany — 送货的公司名称。
• shippingPhone — 送货的电话号码。
• shippingAddress2 — 送货地址的第二行。
• shippingCity — 送货的城市。
• shippingCountry — 送货的国家。
• shippingCountryCode — 送货的国家代码。
• shippingZip — 送货的邮政编码。
• shippingProvince — 送货的省份。
• shippingProvinceCode — 送货的省份代码。
• appliedDiscountPresentmentAmount — 应用折扣的展示金额。
• appliedDiscountShopAmount — 应用折扣的商店金额。
• appliedDiscountDescription — 应用折扣的描述。
• shippingRateHandle — 送货费率的 handle。
• taxLines — 应用于草稿订单的税行。