Mapper les attributs de produits pour WooCommerce Checkout

Aperçu 

Mappez vos attributs de produits WooCommerce (comme la couleur, la taille et d'autres personnalisations) dans l'extension Zonos pour vous assurer que les commandes importées de Zonos dans votre boutique WooCommerce comportent les bons attributs.

Étape 1 : Trouver vos attributs de produits

1. Accédez à l'onglet Products dans votre tableau de bord d'administration WordPress.

2. Dans la navigation de gauche, cliquez sur Attributes pour afficher ou gérer vos attributs de produits globaux. Les attributs peuvent également être définis lors de l'ajout d'un nouveau produit.

Si vous utilisez une application tierce pour des attributs personnalisés, comme Product Add-Ons for WooCommerce, suivez les instructions de la documentation de l'application pour repérer les attributs.

Étape 2 : Identifier le chemin d'attribut depuis Zonos

Pour mapper les attributs dans l'extension Zonos, vous devez d'abord comprendre comment ils sont transmis à Zonos. Pour repérer ces données :

1. Créez une commande d'essai pour un produit avec l'attribut que vous souhaitez mapper.
2. Passez par Zonos Checkout et sélectionnez un niveau de service. Cela générera une soumission de landed cost. (Vous n'avez pas besoin de finaliser la commande.)
3. Dans Dashboard, accédez à Quotes.
4. Trouvez la soumission de votre commande d'essai et cliquez sur Quote Details.
5. Dans la section API Details à droite, développez le menu déroulant de niveau racine, puis développez :
   • items
   • metadata

Ce bloc de métadonnées montre comment les attributs de produits sont transmis de WooCommerce à Zonos dans la requête API.

Étape 3 : Mapper l'attribut dans l'extension Zonos

Une fois l'attribut repéré dans le JSON de métadonnées, retournez aux paramètres Zonos Mapping de votre extension WooCommerce.

1. Sous Attribute field, sélectionnez Custom Attribute.
2. Dans le champ Alias, saisissez un libellé descriptif (p. ex. Color, Size ou Custom Engraving).
3. Dans le champ Cart item path, saisissez le chemin vers la valeur de l'attribut, selon la structure observée dans les métadonnées.

Exemple de mappage d'attributs personnalisés

Voyons comment mapper un produit qui comporte des attributs personnalisés pour une gravure, une couleur et une taille.

Si vous utilisez le module d'extension Product Add-ons de WooCommerce, les attributs sont parfois transmis dans un tableau sous la clé addons. Le bloc JSON ci-dessous montre les attributs qui ont été transmis à Zonos.

Exemple de bloc JSON :

{
  "addons": [
    {
      "name": "Custom Engraving",
      "value": "Built to last",
      "price": 0,
      "field_name": "1226-1748963436",
      "field_type": "custom_text",
      "id": 1748963436,
      "price_type": "flat_fee"
    }
  ],
  "variation": {
    "attribute_pa_color": "blue",
    "attribute_size": "Large"
  }
}

Dans Mapping settings sous Attributes, chacun de ces attributs doit être mappé comme suit :

Note : Le format de chemin addons.0.value fonctionne ainsi :

• addons indique au système de chercher dans le tableau addons
• .0 pointe vers le premier objet de ce tableau
• .value renvoie la valeur du champ value de cet objet
• attribute_pa_color et attribute_size sont des objets qui ne sont pas dans un tableau et peuvent être mappés directement.

Tester le mappage des attributs de produits

Une fois l'attribut mappé, passez une commande d'essai complète dans Zonos Checkout. Une fois la commande traitée, vérifiez les détails de la commande dans WooCommerce pour vous assurer que les attributs de produits ont été importés correctement.