Order-metafields

Zonos schrijft orderdetails naar Shopify order-metafields onder de zonos-namespace. Dit geeft u directe toegang tot Zonos order-ID's, kostenopsplitsingen op itemniveau en subtotalen voor invoerrechten/belasting/kosten zonder apart de Zonos API aan te roepen.

Deze metafields zijn beschikbaar op elke Shopify-order die via Zonos is verwerkt en zijn toegankelijk via de Shopify Admin API, Shopify Flow of elke tool die order-metafields leest.

Beschikbare metafields 

Zonos schrijft drie metafields naar elke Shopify-order, alle onder de zonos-namespace.

zonos_id

Het unieke Zonos order-ID gekoppeld aan deze Shopify-order. Gebruik dit ID om de volledige order op te zoeken in Zonos Dashboard of via de Zonos API.

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Een JSON-object met de geaggregeerde totalen voor invoerrechten, belasting, kosten en verzending voor de order.

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

zonos_items

Een JSON-array met kostenopsplitsingen op itemniveau. Elk item bevat bedragen in zowel de betaalde valuta van de klant als de basisvaluta van uw winkel.

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

Metafields benaderen 

U kunt deze metafields benaderen via elke methode die het lezen van Shopify order-metafields ondersteunt:

• Shopify Admin API (GraphQL of REST)
• Shopify Flow voor het automatiseren van workflows op basis van Zonos-ordergegevens
• Apps van derden die order-metafields lezen (bijv. rapportagetools, ERP's)

Voorbeeld: Query via Shopify GraphQL API

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