Bestell-Metafelder

Zonos schreibt Bestelldetails in Shopify-Bestell-Metafelder unter dem zonos-Namespace. So haben Sie direkten Zugriff auf Zonos-Bestell-IDs, kostenbezogene Aufschlüsselungen auf Artikelebene sowie Zoll-/Steuer-/Gebühren-Zwischensummen, ohne die Zonos-API separat aufrufen zu müssen.

Diese Metafelder sind für jede über Zonos verarbeitete Shopify-Bestellung verfügbar und können über die Shopify Admin API, Shopify Flow oder jedes Tool abgerufen werden, das Bestell-Metafelder liest.

Verfügbare Metafelder 

Zonos schreibt drei Metafelder in jede Shopify-Bestellung, alle unter dem zonos-Namespace.

zonos_id

Die eindeutige Zonos-Bestell-ID, die mit dieser Shopify-Bestellung verknüpft ist. Verwenden Sie diese ID, um die vollständige Bestellung im Zonos Dashboard oder über die Zonos-API nachzuschlagen.

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Ein JSON-Objekt mit den aggregierten Zoll-, Steuer-, Gebühren- und Versandgesamtbeträgen für die Bestellung.

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

zonos_items

Ein JSON-Array mit kostenbezogenen Aufschlüsselungen auf Artikelebene. Jeder Artikel enthält Beträge sowohl in der vom Kunden bezahlten Währung als auch in der Basiswährung Ihres Shops.

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

Metafelder abrufen 

Sie können diese Metafelder über jede Methode abrufen, die das Lesen von Shopify-Bestell-Metafeldern unterstützt:

• Shopify Admin API (GraphQL oder REST)
• Shopify Flow zur Automatisierung von Workflows basierend auf Zonos-Bestelldaten
• Drittanbieter-Apps, die Bestell-Metafelder lesen (z. B. Reporting-Tools, ERPs)

Beispiel: Abfrage über Shopify GraphQL API

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