Documentation Commerce Vidéos et tutoriels

Création d’un produit configurable

5 mai 2025

Créé pour :

Débutant
Développeur
Utilisateur ou utilisatrice

Un produit configurable est un produit parent de plusieurs produits simples. Définissez un produit configurable afin d’exiger que l’acheteur fasse un ou plusieurs choix pour sélectionner une variante de produit spécifique. Par exemple, si le produit est une chemise, l’acheteur doit choisir les options de taille et de couleur pour sélectionner la chemise.

Bien qu’un produit configurable utilise davantage de SKU et qu’il puisse prendre un peu plus de temps au départ à configurer, il peut vous faire gagner du temps au bout du compte. Si vous prévoyez de développer votre entreprise, le type de produit configurable est un bon choix pour les produits avec plusieurs options.

Avant de créer un produit configurable, vérifiez que tous les produits simples à inclure dans le produit configurable sont disponibles dans Adobe Commerce. Créez tout qui n’existe pas.

Dans ce tutoriel, découvrez comment créer un produit configurable à l’aide de l’API REST et de l’administrateur Adobe Commerce.

Utilisez l’API REST pour créer un produit configurable :

Obtenez les attributs d’un jeu d’attributs pour utiliser les numéros d’ID pour les appels d’API suivants.
Créez des produits simples à utiliser dans le produit configurable.
Créez un produit configurable vide et associez les produits simples.
Définissez les attributs de produit pour le produit configurable.
Renseignez le produit configurable vide avec des produits simples.
Obtenez le produit configurable et tous les attributs.
Obtenez les produits enfants attribués pour le produit configurable.
Supprimez l’association de produits simples à des produits configurables.

Lors de la création de produits configurables à partir de l’administrateur Adobe Commerce, vous pouvez soit créer d’abord les produits simples, soit utiliser l’outil automatisé qui crée de nouveaux produits simples à utiliser à l’aide de l’assistant.

Pour qui est cette vidéo ?

Chargés de site web
Marchandisers e en eCommerce
Nouveaux développeurs Adobe Commerce qui souhaitent apprendre à créer des produits configurables dans Adobe Commerce à l’aide de l’API REST

Contenu vidéo

video poster

https://video.tv.adobe.com/v/3455037?learn=on&captions=fre_fr

Obtention des attributs de couleur à l’aide de cURL

Dans cet exemple, l’ensemble d’attributs complet avec tous les attributs individuels est renvoyé pour l’ensemble d’attributs 10. Cela peut être long, des centaines de lignes ne sont pas rares. Lors de la révision de la réponse, l’identifiant d’attribut pour la couleur sera probablement au milieu. Accélérez la recherche de ces valeurs à l’aide de grep ou d’autres méthodes pour rechercher les résultats. Ma réponse se trouvait à proximité de la ligne 665 et est incluse dans le fragment de code suivant de la réponse JSON.

...
{
        "attribute_id": 93,
        "attribute_code": "color",
        "frontend_input": "select",
        "entity_type_id": "4",
        "is_required": false,
        "options": [
            {
                "label": " ",
                "value": ""
            },
            {
                "label": "Red",
                "value": "13"
            },
            {
                "label": "Blue",
                "value": "14"
            },
            {
                "label": "Green",
                "value": "15"
            }
        ],
...

Pour récupérer les identifiants d’attribut afin de configurer votre produit configurable, mettez à jour la partie attribute-sets/10/attributes de la requête cURL suivante afin de remplacer 10 par l’identifiant de jeu d’attributs dans votre environnement. Cette requête utilise la méthode GET .

curl --location '{{your.url.here}}rest/V1/products/attribute-sets/10/attributes' \
--header 'Authorization: Bearer {{Your Bearer Token}}'

Création du premier produit simple à l’aide de cURL

Ajuster les ID d’environnement et les détails des produits

Créez le premier produit simple à l’aide de l’API pour envoyer la demande de POST suivante à l’aide de cURL.

Avant d’envoyer la requête, mettez à jour l’exemple avec les valeurs de votre environnement.

Modifiez "attribute-set": 10 pour remplacer 10 par l’identifiant de jeu d’attributs de votre environnement.
Modifiez "value": "13" pour remplacer 13 par la valeur de votre environnement.

curl --location '{{your.url.here}}/rest/default/V1/products' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{Your Bearer Token}}' \
--header 'Cookie: PHPSESSID=aff63a1634f6f1a773e7a4894bf1a55c' \
--data '{
  "product": {
    "sku": "Kids-Hawaiian-Ukulele-red",
    "name": "Kids Hawaiian Ukulele Red",
    "attribute_set_id": 10,
    "price": 12.50,
    "status": 1,
    "visibility": 1,
    "type_id": "simple",
    "weight": "0.5",
    "extension_attributes": {
        "stock_item": {
            "qty": "10",
            "is_in_stock": true
        }
    },
    "custom_attributes": [
        {
            "attribute_code": "color",
            "value": "13"
        }
    ]
  }
}
'

Création du second produit simple à l’aide de cURL

Créez le deuxième produit simple à l’aide de l’API pour envoyer la demande de POST suivante à l’aide de cURL.

Avant d’envoyer la requête, mettez à jour l’exemple avec les valeurs de votre environnement.

Modifiez "attribute_set_id": 10, et remplacez 10 par l’identifiant de jeu d’attributs de dans votre environnement.
Modifiez "value": "14" et remplacez 14 par la valeur de votre environnement.

curl --location '{{your.url.here}}/rest/default/V1/products' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{Your Bearer Token}}' \
--header 'Cookie: PHPSESSID=aff63a1634f6f1a773e7a4894bf1a55c' \
--data '{
  "product": {
    "sku": "Kids-Hawaiian-Ukulele-Blue",
    "name": "Kids Hawaiian Ukulele Blue",
    "attribute_set_id": 10,
    "price": 15,
    "status": 1,
    "visibility": 1,
    "type_id": "simple",
    "weight": "0.5",
    "extension_attributes": {
        "stock_item": {
            "qty": "20",
            "is_in_stock": true
        }
    },
    "custom_attributes": [
        {
            "attribute_code": "color",
            "value": "14"
        }
    ]
  }
}
'

Créer le troisième produit simple à l’aide de cURL

Créez le troisième produit simple en envoyant la demande de POST suivante à l’aide de cURL.

Avant d’envoyer la requête, mettez à jour l’exemple avec les valeurs de votre environnement.

Modifiez "attribute_set_id": 10, pour remplacer 10 par l’identifiant de jeu d’attributs de votre environnement.
Modifiez "value": "15" et remplacez 15 par la valeur de votre environnement.

curl --location '{{your.url.here}}/rest/default/V1/products' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{Your Bearer Token}}' \
--header 'Cookie: PHPSESSID=aff63a1634f6f1a773e7a4894bf1a55c' \
--data '{
  "product": {
    "sku": "Kids-Hawaiian-Ukulele-Green",
    "name": "Kids Hawaiian Ukulele Green",
    "attribute_set_id": 10,
    "price": 25,
    "status": 1,
    "visibility": 1,
    "type_id": "simple",
    "weight": "0.5",
    "extension_attributes": {
        "stock_item": {
            "qty": "30",
            "is_in_stock": true
        }
    },
    "custom_attributes": [
        {
            "attribute_code": "color",
            "value": "15"
        }
    ]
  }
}
'

Créer un produit configurable vide à l’aide de cURL

Créez un produit configurable vide en envoyant la demande de POST suivante à l’aide de cURL.

Avant d’envoyer la requête, mettez à jour l’exemple avec les valeurs de votre environnement.

Modifiez "attribute_set_id": 10, et remplacez 10 par l’identifiant de jeu d’attributs de votre environnement.
Modifiez "value": "93" et remplacez 93 par la valeur de votre environnement.

curl --location '{{your.url.here}}/rest/default/V1/products' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{Your Bearer Token}}' \
--header 'Cookie: PHPSESSID=aff63a1634f6f1a773e7a4894bf1a55c' \
--data '{
  "product": {
    "sku": "Kids-Hawaiian-Ukulele",
    "name": "Kids Hawaiian Ukulele",
    "attribute_set_id": 10,
    "status": 1,
    "visibility": 4,
    "type_id": "configurable",
    "weight": "0.5",
    "custom_attributes": [
        {
            "attribute_code": "color",
            "value": "93"
        }
    ]
  }
}'

Définir les options disponibles pour le produit configurable

Définissez les options disponibles pour le produit configurable en envoyant la demande de POST suivante à l’aide de cURL.

Avant d’envoyer la demande, remplacez "attribute_id": 93, par 93 avec l’identifiant d’attribut de votre environnement.

curl --location '{{your.url.here}}/rest/default/V1/configurable-products/Kids-Hawaiian-Ukulele/options' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{Your Bearer Token}}' \
--header 'Cookie: PHPSESSID=aff63a1634f6f1a773e7a4894bf1a55c' \
--data '{
  "option": {
    "attribute_id": "93",
    "label": "Color",
    "position": 0,
    "is_use_default": true,
    "values": [
      {
        "value_index": 9
      }
    ]
  }
}'

Si vous oubliez de définir les options du produit configurable (parent), une erreur s’affiche lorsque vous essayez d’associer un produit enfant au produit configurable. Le message d’erreur est similaire à l’exemple suivant :

{"message":"The parent product doesn't have configurable product options.","trace":"#0 [internal function]: Magento\\ConfigurableProduct\\Model\\LinkManagement->addChild('Kids-Hawaiian-U...'}

Lier le produit enfant au module configurable

Vous avez maintenant créé trois produits simples :

"Kids Hawaiian Ukulele Red",
"Kids-Hawaiian-Ukulele-Blue"
"Kids-Hawaiian-Ukulele-Green"

Ajoutez ces produits simples en tant qu’enfants du produit configurable en envoyant la demande de POST suivante. Envoyez une requête distincte pour chaque produit.

Pour chaque requête, mettez à jour la valeur childSKU avec la valeur du produit enfant que vous ajoutez. L’exemple suivant affecte le produit simple kids-Hawaiian-Ukulele-red au produit configurable avec le SKU Kids-Hawaiian-Ukulele-red.

curl --location '{{your.url.here}}rest/default/V1/configurable-products/Kids-Hawaiian-Ukulele/child' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{Your Bearer Token}}' \
--header 'Cookie: PHPSESSID=aff63a1634f6f1a773e7a4894bf1a55c' \
--data '{
  "childSku": "Kids-Hawaiian-Ukulele-red"
}
'

Obtenir un produit configurable à l’aide de cURL

Maintenant que vous avez créé un produit configurable avec trois SKU enfants attribués. Vous pouvez voir les identifiants liés des produits affectés en envoyant la demande de GET suivante à l’aide de cURL. Cette requête renvoie des informations détaillées sur le produit configurable.

...
        "configurable_product_links": [
            155,
            157,
            156
        ]
...

Les éléments suivants utilisent la méthode GET

curl --location '{{your.url.here}}/rest/default/V1/products/Kids-Hawaiian-Ukulele' \
--header 'Authorization: Bearer {{Your Bearer Token}}'

Obtenir le produit enfant associé à un produit configurable

Renvoie uniquement les enfants associés au produit configurable en envoyant la demande de GET suivante. La réponse inclut tous les attributs du produit enfant, y compris le SKU et le prix.

Les éléments suivants utilisent la méthode GET

curl --location '{{your.url.here}}/rest/default/V1/configurable-products/kids-hawaiian-ukulele/children' \
--header 'Authorization: Bearer {{Your Bearer Token}}'

Supprimer ou supprimer un produit enfant du configurable parent

Vous pouvez supprimer un produit enfant d’un produit configurable sans supprimer le produit du catalogue en envoyant la demande de DELETE suivante à l’aide de cURL.

curl --location --request DELETE '{{your.url.here}}/rest/default/V1/configurable-products/Kids-Hawaiian-Ukulele/children/Kids-Hawaiian-Ukulele-Blue' \
--header 'Authorization: Bearer {{Your Bearer Token}}'

Ressources supplémentaires

recommendation-more-help