訂單元欄位

Zonos 會將訂單詳情寫入 Shopify 訂單元欄位，位於 zonos 命名空間下。這讓您可以直接存取 Zonos 訂單 ID、商品級成本明細以及稅金/費用小計，無需另外呼叫 Zonos API。

這些元欄位在每個透過 Zonos 處理的 Shopify 訂單上都可用，可以透過 Shopify 管理 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 管理 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
        }
      }
    }
  }
}