订单元字段

Zonos 在 zonos 命名空间下将订单详情写入 Shopify 订单元字段。这使您可以直接访问 Zonos 订单 ID、商品级费用明细以及关税/税费/费用小计，而无需单独调用 Zonos API。

这些元字段可在通过 Zonos 处理的每个 Shopify 订单上使用，可以通过 Shopify Admin API、Shopify Flow 或任何读取订单元字段的工具进行访问。

可用元字段 

Zonos 向每个 Shopify 订单写入三个元字段，全部在 zonos 命名空间下。

zonos_id

链接到此 Shopify 订单的唯一 Zonos 订单 ID。使用此 ID 在 Zonos Dashboard 中查找完整订单或通过 Zonos API 查找。

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

一个 JSON 对象，包含订单的汇总关税、税费、费用和运费合计。

{
  "duties": 0,
  "taxes": 400.39,
  "fees": -78.93,
  "shipping": 966.87
}

zonos_items

一个 JSON 数组，包含商品级费用明细。每个商品包括客户支付的货币和您商店基础货币中的金额。

[
  {
    "amount": 830.53,
    "productId": "49380521509183",
    "currencyCode": "CAD",
    "paidAmount": {
      "amount": 830.53,
      "currencyCode": "CAD"
    },
    "shopAmount": {
      "amount": 606.85,
      "currencyCode": "USD"
    }
  }
]

访问元字段 

您可以通过任何支持读取 Shopify 订单元字段的方法访问这些元字段：

• Shopify Admin API（GraphQL 或 REST）
• Shopify Flow，用于基于 Zonos 订单数据自动化工作流
• 第三方应用，读取订单元字段（例如，报告工具、ERP）

示例：通过 Shopify GraphQL API 查询

query OrderZonosMetafields($orderId: ID!) {
  order(id: $orderId) {
    metafields(namespace: "zonos", first: 10) {
      edges {
        node {
          key
          value
        }
      }
    }
  }
}