可用的元欄位
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 Admin 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 在
zonos命名空間下將訂單詳情寫入 Shopify 訂單元欄位。這讓您可以直接存取 Zonos 訂單 ID、商品級別成本明細以及關稅/稅項/費用小計，無需另外呼叫 Zonos API。這些元欄位適用於透過 Zonos 處理的每份 Shopify 訂單，並可透過 Shopify Admin API、Shopify Flow 或任何可讀取訂單元欄位的工具來存取。