[PaaS uniquement]{class="badge informative"}
Ajouter une classe de taxe, un jeu d'attributs et des attributs de stock
Le module Attributs de produit supplémentaires d’Adobe Commerce étend les flux de données de produit. Elle comprend des attributs de produit supplémentaires issus des configurations de produit Adobe Commerce :
Une fois installé, le module fonctionne automatiquement. Il capture et exporte les attributs supplémentaires lors de la synchronisation du produit. Aucune configuration supplémentaire n’est requise.
Principaux avantages
- Amélioration automatique : enrichit les flux de produits avec la classe de taxe, le jeu d’attributs et les attributs de stock.
- Intégration transparente : fournit un contexte essentiel pour les systèmes et services externes
- Configuration zéro : fonctionne immédiatement après l'installation
- Mises à jour en temps réel : synchronise automatiquement les modifications du produit
Fonctionnalités et attributs exportés
Le module ajoute trois attributs supplémentaires à vos flux de données de produit existants :
ac_tax_class
ac_attribute_set
ac_inventory
1. Informations sur la classe d'imposition (ac_tax_class
)
Objectif : fournit des informations de classification fiscale pour chaque produit
Format des données : valeur de chaîne contenant le nom de la classe de taxe
Exemple de sortie :
{
"attributes": [
{
"code": "ac_tax_class",
"values": ["Taxable Goods"]
}
]
}
Cas d’utilisation :
Lorsque vous exportez des données de classe de taxe vers les services de catalogue Commerce, ces données sont disponibles pour les applications qui prennent en charge :
- Déclaration de conformité fiscale
- Intégration avec les services externes de calcul des taxes
- Catégorisation des produits pour les systèmes comptables
2. Informations sur le jeu d’attributs (ac_attribute_set
)
Objectif : identifie le jeu d’attributs affecté à chaque produit
Format des données : valeur de chaîne contenant le nom du jeu d’attributs.
Exemple de sortie :
{
"attributes": [
{
"code": "ac_attribute_set",
"values": [
"Default"
]
}
]
}
Cas d’utilisation :
Lorsque vous exportez des données de jeu d’attributs vers les services de catalogue Commerce, cela active des fonctionnalités avancées de gestion des produits dans les systèmes externes. Ces fonctionnalités incluent :
- Identification du modèle de produit
- Gestion et organisation des catalogues
- Intégration de systèmes tiers nécessitant un contexte de jeu d’attributs
3. Données d'inventaire avancées (ac_inventory
)
Objectif : fournit des paramètres de gestion des stocks pour chaque produit
Format de données : chaîne codée en JSON contenant la configuration de l’inventaire
Champs inclus :
-
manageStock
(booléen) : indique si la gestion des stocks est activée -
cartMinQty
(flottant) : quantité minimale autorisée dans le panier -
cartMaxQty
(flottant) : quantité maximale autorisée dans le panier -
backorders
(chaîne) : politique de backorder. La valeur est l’une des suivantes :"no"
: aucun reliquat autorisé"allow"
: Autoriser une quantité inférieure à 0"allow_notify"
: Autoriser une quantité inférieure à 0 et informer le client
-
enableQtyIncrements
(booléen) : indique si les incréments de quantité sont activés -
qtyIncrements
(flottant) : valeur d’incrément de quantité requise
Exemple de sortie :
{
"attributes": [
{
"code": "ac_inventory",
"values": [
"{\"manageStock\":true,\"cartMinQty\":2,\"cartMaxQty\":42,\"backorders\":\"no\",\"enableQtyIncrements\":false,\"qtyIncrements\":2}"
]
}
]
}
Cas d’utilisation :
Lorsque vous exportez des données d’inventaire vers les services de catalogue Commerce, cela active des fonctionnalités avancées de gestion des stocks dans les systèmes externes. Ces fonctionnalités incluent :
- Intégration du système Inventory management
- Règles de validation du panier
- Optimisation du processus d’exécution des commandes
- Personnalisation de l’expérience client
Amélioration du flux d’exportation des données
Le module Attributs de produit supplémentaires améliore les flux de produits existants. Il intègre automatiquement les nouvelles données d’attribut.
-
Flux de produits (
products
) : amélioré avec les trois attributs supplémentaires- Ajoute les attributs
ac_tax_class
,ac_attribute_set
etac_inventory
à chaque enregistrement de produit - Ne modifie pas les données de produit d’origine
- Maintient la rétrocompatibilité avec les consommateurs d’aliments existants.
- Ajoute les attributs
-
Flux d’attributs de produit (
productAttributes
) : amélioré avec des métadonnées d’attribut pour les nouveaux attributs- Enregistre automatiquement les métadonnées des trois nouveaux attributs dans le flux de
productAttributes
- Fournit des détails de configuration des attributs (types de données, paramètres de visibilité, etc.)
- Aide les systèmes externes à comprendre le nouveau schéma d’attribut.
- Enregistre automatiquement les métadonnées des trois nouveaux attributs dans le flux de
Installation de l’extension
Conditions requises
-
PHP 8.1, 8.2, 8.3 ou 8.4
-
Adobe Commerce 2.4.4+
-
Extension Adobe Commerce Data Export, version 103.4.11 ou ultérieure
-
Accès à repo.magento.com
Pour générer des clés et obtenir les droits nécessaires, voir Obtenir vos clés d’authentification. Pour les installations cloud, consultez le guide Commerce sur les infrastructures cloud.
-
Accès à la ligne de commande du serveur applicatif Adobe Commerce.
Etapes d'installation
Ajoutez le module adobe-commerce/module-extra-product-attributes
à l’aide du compositeur :
composer require adobe-commerce/module-extra-product-attributes
Pour obtenir des instructions d’installation détaillées, consultez les guides suivants :
Synchronisation des données de produit
Après le redéploiement, l’instance Adobe Commerce exporte automatiquement les données supplémentaires lors de la synchronisation du produit. Vous pouvez également utiliser les commandes de l’interface de ligne de commande resync
pour effectuer une synchronisation immédiate.
# Resync the products feed (includes the new attributes)
bin/magento saas:resync --feed=products
# Resync the product attributes feed (includes new attribute metadata)
bin/magento saas:resync --feed=productAttributes
Dépannage
Attributs supplémentaires manquants dans les produits :
- Vérifiez que le module est correctement installé et activé
- Exécutez les commandes de resynchronisation pour actualiser les données du produit.
- Vérifiez que les produits ont des affectations de classe de taxe et de jeu d'attributs valides
Les données d’inventaire semblent incorrectes :
- Vérifiez que les paramètres d’inventaire sont correctement configurés dans l’administration.
- Rechercher des remplacements d’inventaire spécifiques au site web
- Vérifiez que le module Inventory management fonctionne correctement
Pour plus d’informations, consultez le Guide Inventory management dans la Documentation pour les commerçants Adobe Commerce.
Problèmes de performances :
- Surveiller les performances du processus d’exportation après l’installation
- Envisagez de planifier des resynchronisations pendant les périodes de faible trafic
Journalisation et débogage
Le module consigne les erreurs et les avertissements d’exportation dans le système de journalisation Commerce standard. Si vous rencontrez des problèmes lors de la synchronisation du produit, vérifiez les journaux d’exportation des données.
Pour plus d’informations, voir Vérification des journaux et dépannage.