Mapper les attributs produits pour WooCommerce Checkout

Aperçu 

Mappez vos attributs produits WooCommerce (couleur, taille et autres personnalisations) dans l'extension Zonos pour garantir que les commandes importées de Zonos vers votre boutique WooCommerce comportent les attributs corrects.

Étape 1 : Trouver vos attributs produits

1. Accédez à l'onglet Products dans votre admin WordPress.

2. Dans la navigation de gauche, cliquez sur Attributes pour afficher ou gérer vos attributs 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 localiser 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 localiser ces données :

1. Créez une commande test 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 un devis de landed cost. (Vous n'avez pas besoin de finaliser la commande.)
3. Dans Dashboard, accédez à Quotes.
4. Trouvez le devis de votre commande test 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 produits sont transmis de WooCommerce à Zonos dans la requête API.

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

Une fois l'attribut localisé 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 mapping d'attributs personnalisés

Prenons l'exemple d'un produit avec un attribut personnalisé pour une gravure, une couleur et une taille.

Si vous utilisez le plugin 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 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 retourne 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 mapping des attributs produits

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