Step 3. Define configurable product options

Now that we've created all the Champ Tee products, we need to assign size as the configurable attribute and link the simple products to the configurable product.

Set the configurable attribute

The POST async/bulk/V1/configurable-products/bySku/options call assigns the specified attribute_id to be the configurable attribute.

The value assigned to the value_index must be unique within the system.

Endpoint:

POST <host>/rest/default/async/bulk/V1/configurable-products/bySku/options

Payload:

Copy
[{
 "sku": "MS-Champ",
 "option": {
   "attribute_id": "141",
   "label": "Size",
   "position": 0,
   "is_use_default": true,
   "values": [
     {
       "value_index": 9
     }
   ]
 }
}]
Copied to your clipboard
[{
 "sku": "MS-Champ",
 "option": {
   "attribute_id": "141",
   "label": "Size",
   "position": 0,
   "is_use_default": true,
   "values": [
     {
       "value_index": 9
     }
   ]
 }
}]

Response:

Copy
{
   "bulk_uuid": "98c46050-cd66-4b49-9d45-69bfa04efc78",
   "request_items": [
       {
           "id": 0,
           "data_hash": "17c5e6b0d6fdf98ea83f600c8cc7e9f5a437e7f51e21a9c40070bb6208e1334c",
           "status": "accepted"
       }
   ],
   "errors": false
}
Copied to your clipboard
{
   "bulk_uuid": "98c46050-cd66-4b49-9d45-69bfa04efc78",
   "request_items": [
       {
           "id": 0,
           "data_hash": "17c5e6b0d6fdf98ea83f600c8cc7e9f5a437e7f51e21a9c40070bb6208e1334c",
           "status": "accepted"
       }
   ],
   "errors": false
}

Link the simple products to the configurable product

Now that you have set the configurable attribute to be sku, you can link all simple products to the configurable product and execute a single call with a payload that contains an array of simple products. To do this, specify the sku of the configurable product, and the childSku of each simple product.

Endpoint:

POST <host>/rest/default/async/bulk/V1/configurable-products/bySku/child

Payload:

Copy
[
 {
   "sku": "MS-Champ",
   "childSku": "MS-Champ-S"
 },
 {
   "sku": "MS-Champ",
   "childSku": "MS-Champ-M"
 },
 {
   "sku": "MS-Champ",
   "childSku": "MS-Champ-L"
 },
 // .... you can link as many products at the same time as required ....
]
Copied to your clipboard
[
 {
   "sku": "MS-Champ",
   "childSku": "MS-Champ-S"
 },
 {
   "sku": "MS-Champ",
   "childSku": "MS-Champ-M"
 },
 {
   "sku": "MS-Champ",
   "childSku": "MS-Champ-L"
 },
 // .... you can link as many products at the same time as required ....
]

Response:

Copy
{
   "bulk_uuid": "e78042d1-de13-4260-8f56-d5dd13f89e3c",
   "request_items": [
       {
           "id": 0,
           "data_hash": "b4cfe401d84fbfadc94dd86782f18104dcaa162649f032fe105420037a44f795",
           "status": "accepted"
       },
       {
           "id": 1,
           "data_hash": "b4cfe401d84fbfadc94dd86782f18104dcaa162649f032fe105420037a44f795",
           "status": "accepted"
       },
       {
           "id": 2,
           "data_hash": "b4cfe401d84fbfadc94dd86782f18104dcaa162649f032fe105420037a44f795",
           "status": "accepted"
       }
   ],
   "errors": false
}
Copied to your clipboard
{
   "bulk_uuid": "e78042d1-de13-4260-8f56-d5dd13f89e3c",
   "request_items": [
       {
           "id": 0,
           "data_hash": "b4cfe401d84fbfadc94dd86782f18104dcaa162649f032fe105420037a44f795",
           "status": "accepted"
       },
       {
           "id": 1,
           "data_hash": "b4cfe401d84fbfadc94dd86782f18104dcaa162649f032fe105420037a44f795",
           "status": "accepted"
       },
       {
           "id": 2,
           "data_hash": "b4cfe401d84fbfadc94dd86782f18104dcaa162649f032fe105420037a44f795",
           "status": "accepted"
       }
   ],
   "errors": false
}

Verify this step

• Log in to the Luma website and select Catalog > Products. Click on the Champ Tee configurable product and expand the Configurations section.

  

• On the Luma storefront page, search for Champ.

  

• Call GET <host>/rest/default/V1/products/MS-Champ. The response includes the configurable_product_options and configurable_product_links arrays.

  Copy
  ...
  "configurable_product_options": [
     {
         "id": 338,
         "attribute_id": "141",
         "label": "Size",
         "position": 0,
         "values": [
             {
                 "value_index": 168
             },
             {
                 "value_index": 169
             },
             {
                 "value_index": 170
             }
         ],
         "product_id": 2078
     }
  ],
  "configurable_product_links": [
     2079,
     2080,
     2081
  ]
  },
  ...
  Copied to your clipboard
  ...
  "configurable_product_options": [
     {
         "id": 338,
         "attribute_id": "141",
         "label": "Size",
         "position": 0,
         "values": [
             {
                 "value_index": 168
             },
             {
                 "value_index": 169
             },
             {
                 "value_index": 170
             }
         ],
         "product_id": 2078
     }
  ],
  "configurable_product_links": [
     2079,
     2080,
     2081
  ]
  },
  ...

Copy

export const _frontmatter = {}
Copied to your clipboard


export const _frontmatter = {}

Last updated 9/8/2023

Was this helpful?

Yes

No