Create a configurable product
A configurable product is a parent product of multiple simple products. Define a configurable product to require the buyer to make one or more choices to select a specific product variation. For example, if the product is a shirt, the buyer must choose the size and color options to select the shirt.
Although a configurable product uses more SKUs and may initially take a little longer to set up, it can save you time in the end. If you plan to grow your business, the configurable product type is a good choice for products with multiple options.
Before creating a configurable product, verify that all the simple products to include in the configurable product are available in Adobe Commerce. Create any that do not exist.
In this tutorial, learn how to create a configurable product using the REST API and the Adobe Commerce Admin.
Use the REST API to create a configurable product:
- Get the attributes for an attribute set to use the ID numbers for subsequent API calls.
- Create simple products for use in the configurable product.
- Create an empty configurable product and associate the simple products.
- Set the product attributes for the configurable product.
- Populate the empty configurable product with simple products.
- Get the configurable product and all the attributes.
- Get the assigned children products for the configurable product.
- Delete the association of simple products to configurable products.
When creating configurable products from the Adobe Commerce Admin, you can either create the simple products first, or use the automated tool that creates new simple products for use using the wizard.
此视频面向谁？
- 网站管理员
- 电子商务促销商
- 新的Adobe Commerce开发人员，他们想要了解如何使用REST API在Adobe Commerce中创建可配置产品
视频内容
使用cURL获取颜色属性
在本例中，对于属性集10，返回包含所有单个属性的整个属性集。 它可能会很长，数百行也是常见的。 查看响应时，颜色的属性ID可能位于中间。 通过使用grep或其他方法搜索结果，加快对这些值的搜索。 我的响应在第665行附近，包含在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"
}
],
...
要检索属性ID以设置可配置产品，请更新以下cURL请求的attribute-sets/10/attributes部分，以使用环境中的属性集ID替换10。 此请求使用GET方法。
curl --location '{{your.url.here}}rest/V1/products/attribute-sets/10/attributes' \
--header 'Authorization: Bearer {{Your Bearer Token}}'
使用cURL创建第一个简单产品
调整环境ID和产品详细信息
使用API创建第一个简单产品，以使用cURL发送以下POST请求。
在提交请求之前，请使用环境的值更新示例。
- 更改
"attribute-set": 10以使用您环境中的属性集ID替换10。 - 将
"value": "13"更改为使用您环境中的值替换13。
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"
}
]
}
}
'
使用cURL创建第二个简单产品
使用API创建第二个简单产品，以使用cURL发送以下POST请求。
在提交请求之前，请使用环境的值更新示例。
- 更改
"attribute_set_id": 10,并在您的环境中将10替换为的属性集ID。 - 更改
"value": "14"并使用您环境中的值替换14。
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"
}
]
}
}
'
使用cURL创建第三个简单产品
通过使用cURL发送以下POST请求来创建第三个简单产品。
在提交请求之前，请使用环境的值更新示例。
- 更改
"attribute_set_id": 10,以使用您环境中的属性集ID替换10。 - 更改
"value": "15"并使用您环境中的值替换15。
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"
}
]
}
}
'
Create an empty configurable product using cURL
Create an empty configurable product by sending the following POST request using cURL.
在提交请求之前，请使用环境的值更新示例。
- Change
"attribute_set_id": 10,and replace10with the attribute set id from your environment. - 更改
"value": "93"并使用您环境中的值替换93。
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"
}
]
}
}'
Set the options available for the configurable product
Set the options available for the configurable product by sending the following POST request using cURL.
Before submitting the request, change "attribute_id": 93, to replace 93 with the attribute id from your environment.
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
}
]
}
}'
If you forget to set the options for the configurable product (parent), you get an error when you try to associate a child product to the configurable product. The error message is similar to the following example:
{"message":"The parent product doesn't have configurable product options.","trace":"#0 [internal function]: Magento\\ConfigurableProduct\\Model\\LinkManagement->addChild('Kids-Hawaiian-U...'}
Link the child product to the configurable
Now, you have created three simple products:
"Kids Hawaiian Ukulele Red","Kids-Hawaiian-Ukulele-Blue""Kids-Hawaiian-Ukulele-Green"
Add these simple products as children of the configurable product by sending the following POST request. Submit a separate request for each product.
For each request, update the childSKU value with the value for the child product you are adding. The following example assigns the simple product kids-Hawaiian-Ukulele-red to the configurable product with the 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"
}
'
Get a configurable product using cURL
Now that you have created a configurable product with three assigned child SKUs. You can see the linked IDs for the assigned products by sending the following GET request using cURL. This request returns detailed information about the configurable product.
...
"configurable_product_links": [
155,
157,
156
]
...
The following uses the GET method
curl --location '{{your.url.here}}/rest/default/V1/products/Kids-Hawaiian-Ukulele' \
--header 'Authorization: Bearer {{Your Bearer Token}}'
Get the children product associated to a configurable product
Return only the children associated with the configurable product by sending the following GET request. The response will include all the attributes for the child product including SKU and price.
The following uses the GET method
curl --location '{{your.url.here}}/rest/default/V1/configurable-products/kids-hawaiian-ukulele/children' \
--header 'Authorization: Bearer {{Your Bearer Token}}'
Delete or remove a child product from the parent configurable
You can remove a child product from a configurable product without deleting the product from the catalog by sending the following DELETE request using 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}}'