订单

一个订单是客户结账后的结果。
使用 DataEase，您可以：

• 修正数百个订单的价格、数量或标签。
• 批量添加跟踪号码、发送发票或退款。
• 导出完整的订单历史用于报告或会计。

Shopify 订单指南。

---

目录

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

---

2. 导出

1. 选择 CSV（适合非常大的文件）或 Excel。
2. 选择 Order。
3. 选择您需要的列-name, financialStatus, lineItemQuantity 等。
4. 运行任务并下载您的文件。
   更多详情：导出指南

---

3. 导入

命令

Order row command → CREATE, UPDATE, REPLACE, DELETE, IGNORE
Line row itemCommand → CREATE, UPDATE, MERGE, DELETE, IGNORE
其他行类型遵循相同模式。
特殊的 action 列（仅导入）：
COMPLETE, CANCEL, SEND_CONFIRMATION, FULFILL, REFUND

提示： 对于 CREATE，您必须至少提供 email 或 phone（或现有的 customerId）。

在试用或开发商店中创建订单时，有一个限制：每分钟最多 5 个新订单。

退款绝不会重复发送。 如果本次导入中同一笔退款的早前尝试失败，Shopify 会拒绝重复执行（IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED）。DataEase 不会用新请求重试（那可能导致重复退款）：该退款行会显示错误 “Refund was not applied…”。请检查这些行并重新运行导入。

步骤

1. 获取示例文件：Order-import-sample.xlsx
2. 编辑标题行（LineType = ORDER），然后为 LINE_ITEM, SHIPPING_LINE 等添加额外行。
3. 在 DataEase 中映射列，上传并开始。
   完整说明：导入指南

---

4. 字段参考

以下是最常用列的简短列表。
导出中的灰色行是仅导出（无法通过导入更改）。

订单级别 (LineType = ORDER)

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

• command — 行操作：CREATE | UPDATE | REPLACE | DELETE | IGNORE。

• currencyCode — 下订单时的商店货币。留空以使用商店默认值。

• presentmentCurrencyCode — 购物者支付的货币（多币种商店）。

• email — 用于收据的客户电子邮件。

• phone — 客户电话号码。

• tags — 逗号分隔的标签。参见 标签指南。

• tagsCommand — 在订单上添加、移除或替换标签。

• buyerAcceptsMarketing — 如果买家选择接收营销信息，则为 true。

• poNumber — 采购订单号。

• taxesIncluded — 如果商品价格已包含税，则为 true。

• displayFinancialStatus — AUTHORIZED, PAID, REFUNDED 等。（仅导出）

• displayFulfillmentStatus — FULFILLED, PARTIALLY_FULFILLED 等。（仅导出）

---

商品 (LineType = LINE_ITEM)

• lineItemVariantId — 要添加/更新的变体 ID。自定义商品留空。

• lineItemQuantity — 订购数量。

• lineItemSku — SKU（如果 variantId 为空，用于定位变体）。

• lineItemOriginalUnitPrice — 折扣前的价格（商店货币）。

• lineItemAppliedDiscountValue — 此行的折扣值。

• lineItemAppliedDiscountValueType — FIXED_AMOUNT 或 PERCENTAGE。

---

运费 (LineType = SHIPPING_LINE)

• shippingLineTitle — 运输服务的名称。

• shippingLinePrice — 商店货币中的价格。

• shippingLinePresentmentPrice — 购物者货币中的价格。

---

履行 (LineType = FULFILLMENT)

• fulfillmentTrackingCompany — 跟踪承运商（Shopify 列表中的确切名称）。

• fulfillmentTrackingNumbers — 跟踪号码（如果有多个，用逗号分隔）。

• fulfillmentLocationId — 扣除库存的地点 ID。

• fulfillmentNotifyCustomer — 如果要通过电子邮件发送运输确认，则为 true。

---

交易和退款 (LineType = TRANSACTION or REFUND)

• transactionKind — AUTHORIZATION | CAPTURE | REFUND | SALE | VOID。

• transactionAmount — 商店货币中的金额。

• refundLineItemRestockType — 退货或取消时的补货类型。

---

Metafields

• metafields — 用于额外数据的自定义列。参见 Metafields 指南。

仅导出字段

以下是 DataEase 为订单导出的所有额外“仅灰色”列。 它们是只读的——您无法通过导入更改它们，但它们对于报告、欺诈检查、营销和支持非常有用。

订单总计和价格

• totalPrice — 订单总金额（包括税费+运费+折扣）。
• totalShippingPrice — 折扣或退款前的运费。
• totalWeight — 所有商品的总重量（克）。
• totalTax — 订单收取的总税费。
• subtotalPrice — 商品小计，扣除商品级别折扣后，税费和运费前。
• currentSubtotalPrice — 退货或编辑后的小计。
• totalShopCurrencyDiscount — 创建时商店货币中的所有折扣（订单+商品）。
• totalPresentmentCurrencyDiscount — 购物者货币中的当前订单级别折扣。
• currentTotalDuties — 退货后的应付关税（如果未使用则为 null）。
• currentTotalAdditionalFees — 退货后的额外费用（礼品包装、回收等）。
• originalTotalAdditionalFeesSet — 订单创建时的额外费用。
• totalOutstandingSet — 订单上仍需支付（+）或退款（–）的余额。
• currentTotalPriceSet — 任何编辑或退货后的最终总金额。

订单状态和元数据

• publicationSource — 创建订单的销售渠道（在线商店、POS 等）。
• statusPageUrl — 客户“订单状态”页面链接。
• displayFulfillmentStatus — 友好的履行状态（FULFILLED, PARTIALLY_FULFILLED…）。
• clientIp — 下订单的 IP 地址。
• canNotifyCustomer — 如果存在用于通知的电子邮件地址，则为 true。
• daysToConversion — 从首次访问商店到购买的天数。
• cancellationNote — 订单取消时记录的员工备注。
• riskRecommendation — 欺诈风险建议：ACCEPT, INVESTIGATE, 或 CANCEL。
• createdAt — 订单创建的日期/时间。
• updatedAt — 订单上任何更改的最后时间。
• cancelledAt — 订单取消的时间（如果从未取消则为 null）。

营销/访问跟踪

• lastVisitLandingPage — 买家在购买会话中首次登陆的页面。
• lastVisitSource — 营销来源（Google、Email、Direct 等）。
• lastVisitSourceType — 营销策略类型（广告、社交、推荐…）。
• lastVisitUtmCampaign — UTM 活动名称。
• lastVisitUtmContent — UTM 内容标签。
• lastVisitUtmMedium — UTM 媒介（横幅、电子邮件、cpc…）。
• lastVisitUtmSource — UTM 来源（google, newsletter…）。
• lastVisitUtmTerm — UTM 搜索词。

客户快照（仅导出字段）

• customerCreatedAt — 客户记录首次创建的时间。
• customerLocale — 买家的首选语言。
• customerNumberOfOrders — 此客户的终身订单数。
• customerState — 帐户状态 – INVITED, ENABLED, DISABLED, 或 DECLINED。
• customerAmountSpentAmount — 终身消费金额。
• customerAmountSpentCurrencyCode — 终身消费的货币。
• customerTags — 客户档案上已有的标签。
• customerSmsMarketingConsent — 上次 SMS 营销同意更新时间。
• customerEmailMarketingConsent — 上次电子邮件营销同意更新时间。
• customerCompanyName — B2B 公司名称（如果有）。
• customerCompanyId — 与订单关联的公司 ID。
• customerCompanyExternalId — 外部 ERP/CRM 公司 ID。
• customerLocationId — 公司地点 ID。
• customerLocationExternalId — 公司地点的外部 ID。
• customerLocationName — 公司地点的友好名称。

额外的运输和地址信息

• shippingCity — 运输地址的城市部分。
• shippingCountry — 运输地址的国家名称。
• shippingProvince — 运输地址的州/省名称。

商品分析

• lineItemName — 销售时的产品标题和变体标题。
• lineItemOriginalTotal — 任何折扣前的商品总计。
• lineItemTotalPresentmentCurrencyDiscount — 应用于此行的折扣（购物者货币）。
• lineItemVariantSku — 订单时捕获的变体 SKU。
• lineItemVariantProductTags — 此变体的产品标签（快照）。
• lineItemVariantInventoryQuantity — 导出时变体的库存。
• lineItemOriginalUnitPrice — 订单创建时的单价（商店货币）。
• lineItemVariantProductHandle — 销售时记录的产品 handle。
• lineItemDiscountAllocations — 此商品的折扣分配的 JSON 数据。
• lineItemDiscountPerItem — 每单位的折扣总额（商店货币）。
• lineItemVariantProductType — 产品类型快照。
• lineItemVariantWeightUnit — 重量单位（g, kg, oz, lb）。
• lineItemVariantWeight — 重量值。
• lineItemVariantCost — 每单位成本（需要“查看产品成本”权限）。
• lineItemVariantCountryCodeOfOrigin — 原产国代码。
• lineItemVariantHSCode — 协调关税代码（6–13 位数字）。
• lineItemVariantProvinceCodeOfOrigin — 原产省/州代码。

履行审核

• fulfillmentStatus — 履行状态（SUCCESS, FAILURE 等）。
• fulfillmentName — 参考名称（例如，“F-1001”）。
• fulfillmentCreatedAt — 履行记录创建的时间。
• fulfillmentUpdatedAt — 履行记录的最后更改时间。
• fulfillmentDeliveredAt — 包裹交付的日期（如果承运商更新）。
• fulfillmentEstimatedDeliveryAt — 预计交付日期。
• fulfillmentInTransitAt — 承运商标记包裹“运输中”的时间。
• fulfillmentRequiresShipping — 如果此履行中的任何行需要运输，则为 true。
• fulfillmentTotalQuantity — 此履行中所有商品数量的总和。
• fulfillmentDisplayStatus — 友好的状态（IN_TRANSIT, DELIVERED…）。
• fulfillmentCountry — 履行地点的国家名称。

运费详情

• shippingLineSource — 费率来源（手动、应用、承运商）。
• shippingLineDiscountedPrice — 折扣后的运费（商店货币）。
• shippingLineDiscountedPresentmentPrice — 折扣后的运费（购物者货币）。

交易分析

• transactionPaymentId — 网关的支付参考 ID。
• transactionCreatedAt — 交易记录创建的时间。
• transactionErrorCode — 如果支付失败，网关错误代码。
• transactionAuthorizationExpiresAt — 授权到期时间（仅 Plus）。
• transactionFormattedGateway — 友好的网关名称（例如，“Stripe”）。
• transactionManuallyCapturable — 如果可以手动捕获支付，则为 true。
• transactionMaximumRefundableAmount — 剩余可退款金额（用于建议退款）。
• transactionMultiCapturable — 如果允许多次捕获，则为 true。
• transactionProcessedAt — 交易处理的时间戳。

支付卡详情（已屏蔽）

• paymentDetailsAvsResultCode — 来自网关的地址验证代码。
• paymentDetailsBin — 卡的前六位数字（BIN/IIN）。
• paymentDetailsNumber — 屏蔽的卡号（XXXX-XXXX-1234）。
• paymentDetailsName — 持卡人姓名。
• paymentDetailsExpirationYear — 卡的到期年份。
• paymentDetailsExpirationMonth — 卡的到期月份。
• paymentDetailsCvvResultCode — CVV 匹配结果。
• paymentDetailsCompany — 卡品牌（Visa, MasterCard…）。
• paymentDetailsPaymentMethodName — 网关特定方法（例如，“visa_debit”）。
• paymentDetailsWallet — 使用的数字钱包（APPLE_PAY, GOOGLE_PAY…）。

退款审核

• refundId — 退款记录 ID。
• refundCreatedAt — 退款创建的时间。
• refundedAmount — 总退款金额（商店货币）。
• refundedPresentmentAmount — 总退款金额（购物者货币）。
• refundLineItemLocationId — 退回库存的地点。
• refundLineItemRestocked — 如果库存已补货，则为 true。
• refundLineItemRefundedAmount — 该行的退款金额（商店货币）。
• refundLineItemRefundedPresentmentAmount — 该行的退款金额（购物者货币）。

---

5. 过滤器

导出时使用这些过滤器来缩小结果集：

• Id — 精确的订单 ID。
• Name — Shopify 订单号（例如，#1001）。
• CreatedAt — 创建日期/范围。
• ProcessedAt — 支付处理日期/范围。
• UpdatedAt — 最后更改日期/范围。
• ClosedAt — 订单关闭日期/范围。
• CancelledAt — 取消日期/范围。
• CancelReason — 取消原因（CUSTOMER, INVENTORY, …）。
• FinancialStatus — PENDING, PAID, PARTIALLY_PAID, REFUNDED, …
• DisplayFinancialStatus — UI 的聚合财务状态。
• FulfillmentStatus — UNFULFILLED, PARTIALLY_FULFILLED, FULFILLED, …
• DisplayFulfillmentStatus — UI 的聚合履行状态。
• OrderFulfillmentStatus — 发货状态过滤器（scheduled, in_progress, …）。
• ReturnStatus — NONE, PARTIALLY_RETURNED, RETURNED。
• RiskLevel — LOW, MEDIUM, HIGH 欺诈风险。
• RiskRecommendation — ACCEPT, INVESTIGATE, CANCEL。
• ChargebackStatus — NONE, UNDER_REVIEW, WON, LOST。
• Gateway — 支付网关名称（PayPal, Shopify Payments, …）。
• PaymentId — 特定支付标识符。
• PaymentProviderId — 提供商侧支付 ID。
• CreditCardLast4 — 卡的最后四位数字。
• TransactionKind — AUTHORIZATION, CAPTURE, REFUND, …
• TransactionStatus — SUCCESS, FAILURE, PENDING。
• Test — true / false - 仅测试订单。
• Channel — POS, Online Store, Draft 等。
• ChannelId — 内部销售渠道 ID。
• SalesChannel — 人性化的渠道名称（Shop App, IG Shop, …）。
• SourceName — 来源标签（web, pos, api, draft_order）。
• SourceIdentifier — 外部 POS / 第三方订单 ID。
• CheckoutToken — 结账会话令牌。
• CartToken — 与订单关联的购物车 ID。
• DeliveryMethod — SHIPPING, LOCAL_PICKUP, LOCAL_DELIVERY。
• FulfillmentLocationId — 履行订单的地点。
• ReferenceLocationId — POS / 原始地点参考。
• LocationId — 创建订单的商店地点。
• PoNumber — 采购订单参考号。
• ConfirmationNumber — 外部确认/收据号码。
• Sku — 包含特定 SKU 的订单。
• SubtotalLineItemsQuantity — 商品总数量（支持范围）。
• DiscountCode — 使用给定折扣代码的订单。
• Tag — 带有特定标签的订单。
• Email — 客户电子邮件匹配。
• Phone — 客户电话匹配。
• CustomerId — 单个客户的所有订单。
• CustomerState — ENABLED, INVITED, DECLINED, DISABLED。
• CompanyId — B2B 公司 ID。
• FraudProtectionLevel — NOT_PROTECTED 或 PROTECTED。
• Status — OPEN, CLOSED, CANCELLED。
• CartToken — 按原始购物车令牌过滤。
• ChargebackStatus — 订单的拒付状态。
• lastVisitUtmMedium — 购买时捕获的 UTM 媒介。

---

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

其他字段

DataEase 支持此实体的更多列：

• discountCodes — 应用于订单的折扣代码。
• note — 关于订单的内部备注。
• customAttributes — 订单的自定义属性，格式为 JSON。
• retailLocationId — 与订单关联的零售地点 ID。
• isTest — 指示订单是否为测试订单。
• refundOnCancellation — 是否在取消时退款。
• storeCreditRefundExpiration — 商店信用退款的到期日期。
• restockOnCancellation — 是否在订单取消时补货。
• sourceUrl — 订单来源的 URL。
• lastVisitReferrerUrl — 下订单前最后一个推荐人的 URL。
• inventoryBehaviour — 订单的库存行为。
• sendFulfillmentReceipt — 是否向客户发送履行收据。
• sendReceipt — 是否向客户发送订单收据。
• notifyCustomerOnUpdate — 订单更新时通知客户。
• updateOrderStaffNote — 更新订单上的员工备注。
• freeShippingDiscountCode — 免费运费的折扣代码。
• fixedDiscountShopAmount — 商店货币中的固定折扣金额。
• fixedDiscountPresentmentAmount — 购物者货币中的固定折扣金额。
• fixedDiscountCode — 固定金额折扣的折扣代码。
• percentageDiscountCode — 百分比折扣的折扣代码。
• percentageDiscountCodePercentage — 折扣代码的百分比值。
• orderFulfillmentLocationId — 订单履行的地点 ID。
• orderFulfillmentShipmentStatus — 订单履行的发货状态。
• orderFulfillmentNotifyCustomer — 通知客户订单履行。
• orderFulfillmentTrackingCompany — 订单履行的跟踪公司。
• orderFulfillmentTrackingNumber — 订单履行的跟踪号码。
• customerEmail — 客户的电子邮件地址。
• customerFirstName — 客户的名字。
• customerLastName — 客户的姓氏。
• customerNote — 客户的备注。
• customerPhone — 客户的电话号码。
• customerTaxExempt — 指示客户是否免税。
• billingFirstName — 账单的名字。
• billingLastName — 账单的姓氏。
• billingName — 账单的全名。
• billingCompany — 账单的公司名称。
• billingPhone — 账单的电话号码。
• billingAddress1 — 账单地址的第一行。
• billingAddress2 — 账单地址的第二行。
• billingCity — 账单的城市。
• billingCountry — 账单的国家。
• billingCountryCode — 账单的国家代码。
• billingZip — 账单的邮政编码。
• billingProvince — 账单的省份。
• billingProvinceCode — 账单的省份代码。
• shippingFirstName — 运输的名字。
• shippingLastName — 运输的姓氏。
• shippingName — 运输的全名。
• shippingCompany — 运输的公司名称。
• shippingPhone — 运输的电话号码。
• shippingAddress1 — 运输地址的第一行。
• shippingAddress2 — 运输地址的第二行。
• shippingCountryCode — 运输的国家代码。
• shippingZip — 运输的邮政编码。
• shippingProvinceCode — 运输的省份代码。
• lineItemId — 商品的 ID。
• lineItemTaxable — 指示商品是否应税。
• lineItemTitle — 商品的标题。
• lineItemVariantBarcode — 商品变体的条形码。
• lineItemVariantTitle — 商品变体的标题。
• lineItemVendor — 商品的供应商。
• lineItemUnitPrice — 商品的单价。
• lineItemUnitPresentmentPrice — 商品单位的展示价格。
• lineItemIsGiftCard — 指示商品是否为礼品卡。
• lineItemRequiresShipping — 指示商品是否需要运输。
• lineItemProductId — 商品的产品 ID。
• lineItemCustomAttributes — 商品的自定义属性，格式为 JSON。
• lineItemLocationId — 商品的地点 ID。
• LineItemQuantityRestock — 商品的补货数量。
• LineItemAllowDuplicates — 允许重复的商品。
• fulfillmentId — 履行的 ID。
• fulfillmentTrackingUrls — 履行的跟踪 URL。
• fulfillmentAddress1 — 履行地址的第一行。
• fulfillmentAddress2 — 履行地址的第二行。
• fulfillmentCity — 履行的城市。
• fulfillmentCountryCode — 履行的国家代码。
• fulfillmentProvince — 履行的省份。
• fulfillmentProvinceCode — 履行的省份代码。
• fulfillmentZip — 履行的邮政编码。
• fulfillmentMessage — 履行的消息。
• shippingLineId — 运费的 ID。
• shippingLineCode — 运费的代码。
• transactionId — 交易的 ID。
• transactionPresentmentAmount — 交易的展示金额。
• transactionAuthorizationCode — 交易的授权代码。
• transactionGateway — 交易的支付网关。
• transactionTest — 指示交易是否为测试。
• transactionParentTransactionId — 父交易 ID。
• transactionGiftCardId — 交易中使用的礼品卡 ID。
• transactionReceiptJson — 交易收据的 JSON 格式。
• refundNote — 退款的备注。
• refundDiscrepancyReason — 退款差异的原因。
• refundNotifyCustomer — 通知客户退款。
• refundFullShippingAmount — 退款全额运费。
• refundShippingPresentmentAmount — 运费退款的展示金额。
• lineType — 商品类型。
• taxLines — 与订单关联的税费行。