Metafields de commande

Zonos écrit les détails de commande dans les metafields de commande Shopify sous l'espace de noms zonos. Cela vous donne un accès direct aux identifiants de commande Zonos, aux ventilations des coûts par article et aux sous-totaux droits/taxes/frais, sans avoir à appeler l'API Zonos séparément.

Ces metafields sont disponibles sur chaque commande Shopify traitée via Zonos et peuvent être consultés via l'API Admin Shopify, Shopify Flow ou tout outil lisant les metafields de commande.

Metafields disponibles 

Zonos écrit trois metafields sur chaque commande Shopify, tous sous l'espace de noms zonos.

zonos_id

L'identifiant de commande Zonos unique lié à cette commande Shopify. Utilisez cet identifiant pour consulter la commande complète dans Zonos Dashboard ou via l'API Zonos.

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Un objet JSON contenant les totaux agrégés de droits, taxes, frais et expédition pour la commande.

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

zonos_items

Un tableau JSON contenant les ventilations des coûts par article. Chaque article inclut des montants dans la devise payée par le client et la devise de base de votre boutique.

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

Accéder aux metafields 

Vous pouvez accéder à ces metafields via toute méthode prenant en charge la lecture des metafields de commande Shopify :

• Shopify Admin API (GraphQL ou REST)
• Shopify Flow pour automatiser des workflows basés sur les données de commande Zonos
• Applications tierces lisant les metafields de commande (par ex. outils de reporting, ERP)

Exemple : requête via l'API GraphQL Shopify

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