利用可能なメタフィールド
Zonos は各 Shopify 注文に zonos 名前空間の3つのメタフィールドを書き込みます。
zonos_id
この Shopify 注文にリンクされた一意の Zonos 注文 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 API を別途呼び出すことなく、Zonos 注文 ID、商品レベルのコスト内訳、関税/税金/手数料の小計に直接アクセスできます。これらのメタフィールドは Zonos 経由で処理されたすべての Shopify 注文で利用でき、Shopify Admin API、Shopify Flow、または注文メタフィールドを読み取る任意のツールからアクセスできます。