Order metafields

Zonos writes order details to Shopify order metafields under the zonos namespace. This gives you direct access to Zonos order IDs, item-level cost breakdowns, and duty/tax/fee subtotals without needing to call the Zonos API separately.

These metafields are available on every Shopify order processed through Zonos and can be accessed via the Shopify Admin API, Shopify Flow, or any tool that reads order metafields.

Available metafields 

Zonos writes three metafields to each Shopify order, all under the zonos namespace.

zonos_id

The unique Zonos order ID linked to this Shopify order. Use this ID to look up the full order in Zonos Dashboard or via the Zonos API.

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

A JSON object containing the aggregated duty, tax, fee, and shipping totals for the order.

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

zonos_items

A JSON array containing item-level cost breakdowns. Each item includes amounts in both the customer's paid currency and your shop's base currency.

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

Accessing metafields 

You can access these metafields through any method that supports reading Shopify order metafields:

• Shopify Admin API (GraphQL or REST)
• Shopify Flow for automating workflows based on Zonos order data
• Third-party apps that read order metafields (e.g., reporting tools, ERPs)

Example: Query via Shopify GraphQL API

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