可用元欄位
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
}
| 欄位↕ | 描述↕ |
|---|---|
duties | 訂單的總稅金金額。 |
taxes | 訂單的總稅額。 |
fees | 訂單的總費用。負數值表示抵用或調整。 |
shipping | 訂單的總運費。 |
zonos_items
包含商品級成本明細的 JSON 陣列。每個商品都包括以客戶支付貨幣和商店基礎貨幣表示的金額。
範例值
[
{
"amount": 830.53,
"productId": "49380521509183",
"currencyCode": "CAD",
"paidAmount": {
"amount": 830.53,
"currencyCode": "CAD"
},
"shopAmount": {
"amount": 606.85,
"currencyCode": "USD"
}
}
]
| 欄位↕ | 描述↕ |
|---|---|
amount | 客戶貨幣中的商品金額。 |
productId | 此商品的 Shopify 商品 ID。 |
currencyCode | 客戶支付的貨幣。 |
paidAmount.amount | 客戶為此商品支付的金額。 |
paidAmount.currencyCode | 支付金額的貨幣。 |
shopAmount.amount | 商店基礎貨幣中的等值金額。 |
shopAmount.currencyCode | 商店的基礎貨幣代碼。 |
存取元欄位
您可以透過任何支援讀取 Shopify 訂單元欄位的方法存取這些元欄位：
- Shopify 管理 API（GraphQL 或 REST）
- Shopify Flow 用於根據 Zonos 訂單資料自動化工作流程
- 第三方應用程式讀取訂單元欄位（例如報告工具、ERP）
範例：透過 Shopify GraphQL API 查詢
Shopify GraphQL 查詢
query OrderZonosMetafields($orderId: ID!) {
order(id: $orderId) {
metafields(namespace: "zonos", first: 10) {
edges {
node {
key
value
}
}
}
}
}
訂單元欄位
直接從 Shopify 訂單存取 Zonos 訂單資料。
Zonos 會將訂單詳情寫入 Shopify 訂單元欄位，位於
zonos命名空間下。這讓您可以直接存取 Zonos 訂單 ID、商品級成本明細以及稅金/費用小計，無需另外呼叫 Zonos API。這些元欄位在每個透過 Zonos 處理的 Shopify 訂單上都可用，可以透過 Shopify 管理 API、Shopify Flow 或任何可讀取訂單元欄位的工具進行存取。