Order metafields

Zonos는 zonos namespace 아래 Shopify order metafield에 주문 세부 정보를 기록합니다. Zonos API를 별도로 호출하지 않고도 Zonos order ID, item-level cost breakdown, duty/tax/fee subtotal에 직접 액세스할 수 있습니다.

이 metafield는 Zonos를 통해 처리된 모든 Shopify 주문에서 사용할 수 있으며 Shopify Admin API, Shopify Flow 또는 order metafield를 읽는 모든 도구를 통해 액세스할 수 있습니다.

Available metafields 

Zonos는 각 Shopify 주문에 zonos namespace 아래 3개의 metafield를 기록합니다.

zonos_id

이 Shopify 주문에 연결된 고유 Zonos order ID입니다. 이 ID로 Zonos Dashboard 또는 Zonos API에서 전체 주문을 조회하세요.

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

주문의 duty, tax, fee, shipping total을 집계한 JSON object입니다.

{
  "duties": 0,
  "taxes": 400.39,
  "fees": -78.93,
  "shipping": 966.87
}

zonos_items

item-level cost breakdown을 포함하는 JSON array입니다. 각 item에는 customer가 지불한 currency와 shop base currency의 amount가 모두 포함됩니다.

[
  {
    "amount": 830.53,
    "productId": "49380521509183",
    "currencyCode": "CAD",
    "paidAmount": {
      "amount": 830.53,
      "currencyCode": "CAD"
    },
    "shopAmount": {
      "amount": 606.85,
      "currencyCode": "USD"
    }
  }
]

Metafield 액세스 

Shopify order metafield 읽기를 지원하는 모든 방법으로 이 metafield에 액세스할 수 있습니다:

• Shopify Admin API (GraphQL or REST)
• Zonos 주문 data 기반 workflow 자동화를 위한 Shopify Flow
• order metafield을 읽는 Third-party apps(예: reporting tool, ERP)

예시: Shopify GraphQL API를 통한 query

query OrderZonosMetafields($orderId: ID!) {
  order(id: $orderId) {
    metafields(namespace: "zonos", first: 10) {
      edges {
        node {
          key
          value
        }
      }
    }
  }
}