Comment fonctionnent les clés de métadonnées
Chaque article d'une commande peut porter une ou plusieurs entrées de métadonnées — une key et une value. Votre plateforme les envoie à Zonos lors de la création d'une commande. Par défaut, Zonos stocke ces métadonnées mais ne les affiche pas dans la répartition de commande.
Lorsque vous ajoutez une clé sur la page des préférences, Zonos recherche cette clé sur chaque article de commande et affiche la valeur correspondante comme ligne supplémentaire sous l'article.
- Plusieurs valeurs pour la même clé sont jointes par une virgule — par exemple,
red, large. - Les articles qui n'ont pas la clé n'affichent tout simplement pas la ligne, gardant ainsi les détails de commande propres.
- Les clés sont configurées au niveau de l'organisation. Chaque utilisateur de votre organisation voit les mêmes lignes de métadonnées.
Quand utiliser cette fonctionnalité
Cas d'usage courants :
- Gravure ou personnalisation — affichez une clé
engraving-textpour que l'entrepôt sache que la commande nécessite un travail personnalisé avant l'expédition. - Commandes cadeau — affichez une clé
gift-messageougift-wrappour que les préparateurs incluent le bon insert. - Abonnements ou fidélité — affichez une clé
subscription-idouloyalty-tierpour le contexte support et exécution. - Champs plateforme personnalisés — tout champ au niveau article que votre plateforme transmet et que votre équipe doit voir sur la commande.
Ajouter une clé de métadonnées
- Allez dans Dashboard -> Settings -> Orders -> Preferences.
- Dans le champ Metadata keys, saisissez le nom exact de la clé que votre plateforme envoie (par exemple,
engraving-text). - Cliquez sur Add.
La clé s'appliquera immédiatement à toutes les pages de détails de commande. Ouvrez une répartition de commande pour confirmer que la nouvelle ligne apparaît sous chaque article portant cette métadonnée.

Les noms de clés sont sensibles à la casse et doivent correspondre exactement à ce que votre plateforme envoie. Si vous n'êtes pas sûr de la clé exacte, consultez les métadonnées brutes d'une commande récente ou demandez à votre développeur.
Supprimer une clé de métadonnées
- Allez dans Dashboard -> Settings -> Orders -> Preferences.
- Trouvez la clé que vous souhaitez supprimer dans la liste.
- Cliquez sur l'icône corbeille à droite de la ligne.
La ligne cessera d'apparaître dans la répartition de commande pour les commandes nouvelles et existantes.
Dépannage
La ligne n'apparaît pas sur la page de détails de commande.
- Confirmez que le nom de la clé correspond exactement, y compris la casse et les tirets ou underscores (
engraving-textn'est pas identique àEngraving_Text). - Confirmez que l'article de commande possède réellement cette métadonnée. Les commandes plus anciennes créées avant que votre plateforme n'envoie la clé ne l'auront pas.
La ligne apparaît mais est vide.
- La plateforme a envoyé la clé avec une valeur vide. Vérifiez l'intégration côté plateforme pour vous assurer que la valeur est renseignée.
Une clé s'affiche sur certains articles mais pas d'autres.
- C'est normal — les métadonnées sont par article, pas par commande. Seuls les articles pour lesquels la plateforme a envoyé la clé afficheront la ligne.
Préférences de commande
Affichez les métadonnées de plateforme sur chaque article de commande.Lorsque votre plateforme e-commerce envoie des informations supplémentaires avec chaque commande — comme une note de gravure, un message cadeau ou un ID d'abonnement — Zonos les reçoit en tant que metadata. La page des préférences de commande vous permet de choisir quelles clés de métadonnées doivent être affichées sur chaque article de commande dans la répartition, afin que votre équipe d'exécution voie ce qui est nécessaire d'un coup d'œil sans ouvrir la plateforme d'origine.