注文メタフィールド

Zonos は zonos 名前空間の Shopify 注文メタフィールドに注文詳細を書き込みます。これにより、Zonos API を別途呼び出すことなく、Zonos 注文 ID、商品レベルのコスト内訳、関税/税金/手数料の小計に直接アクセスできます。

これらのメタフィールドは Zonos 経由で処理されたすべての Shopify 注文で利用でき、Shopify Admin API、Shopify Flow、または注文メタフィールドを読み取る任意のツールからアクセスできます。

利用可能なメタフィールド 

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
}

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
        }
      }
    }
  }
}