Mapper les attributs de produit pour WooCommerce Checkout

Aperçu 

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

Étape 1 : Trouver vos attributs de produit

1. Accédez à l'onglet Produits dans votre Admin WordPress.

2. Dans la navigation à gauche, cliquez sur Attributs pour afficher ou gérer vos attributs de produit 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 dans la documentation de l'application pour localiser les attributs.

Étape 2 : Identifier le chemin de l'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 de test pour un produit avec l'attribut que vous souhaitez mapper.
2. Procédez à travers 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, allez dans Devis.
4. Trouvez le devis pour votre commande de test et cliquez sur Détails du devis.
5. Dans la section Détails de l'API à 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 produit sont transmis de WooCommerce à Zonos dans la requête API.

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

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

1. Sous Champ d'attribut, sélectionnez Attribut personnalisé.
2. Dans le champ Alias, entrez un label descriptif (par exemple, Couleur, Taille ou Gravure personnalisée).
3. Dans le champ Chemin de l'élément du panier, entrez le chemin vers la valeur de l'attribut, basé sur la structure que vous avez observée dans les métadonnées.

Exemple de mapping d'attributs personnalisés

Voyons comment vous pouvez mapper un produit qui a un attribut personnalisé pour une gravure personnalisée, 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 qui ont été transmis à Zonos.

Exemple de bloc JSON :

{
  "addons": [
    {
      "name": "Gravure personnalisée",
      "value": "Construit pour durer",
      "price": 0,
      "field_name": "1226-1748963436",
      "field_type": "custom_text",
      "id": 1748963436,
      "price_type": "flat_fee"
    }
  ],
  "variation": {
    "attribute_pa_color": "bleu",
    "attribute_size": "Grand"
  }
}

Dans les paramètres de mapping sous Attributs, chacun de ces attributs doit être mappé comme suit :

Remarque : Le format de chemin addons.0.value fonctionne comme suit :

• addons indique au système de chercher dans le tableau des addons
• .0 pointe vers le premier objet de ce tableau
• .value renvoie la valeur du champ de valeur 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 de produit

Une fois que vous avez mappé l'attribut, passez une commande de test 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 produit ont été importés correctement.