Documentação Commerce Vídeos e tutoriais

Criar um produto configurável

Última atualização: 5 de maio de 2025

Criado para:

Iniciante
Desenvolvedor
Usuário

Um produto configurável é um produto principal de vários produtos simples. Defina um produto configurável para exigir que o comprador faça uma ou mais escolhas para selecionar uma variação de produto específica. Por exemplo, se o produto for uma camisa, o comprador deverá escolher as opções de tamanho e cor para selecionar a camisa.

Embora um produto configurável use mais SKUs e possa, inicialmente, levar um pouco mais para ser configurado, ele pode economizar seu tempo no final. Se você planeja expandir seu negócio, o tipo de produto configurável é uma boa escolha para produtos com várias opções.

Antes de criar um produto configurável, verifique se todos os produtos simples a serem incluídos no produto configurável estão disponíveis no Adobe Commerce. Crie qualquer um que não exista.

Neste tutorial, saiba como criar um produto configurável usando a API REST e o administrador do Adobe Commerce.

Use a REST API para criar um produto configurável:

Obtenha os atributos de um conjunto de atributos para usar os números de identificação para chamadas de API subsequentes.
Crie produtos simples para usar no produto configurável.
Crie um produto configurável vazio e associe os produtos simples.
Defina os atributos do produto para o produto configurável.
Preencha o produto configurável vazio com produtos simples.
Obtenha o produto configurável e todos os atributos.
Obtenha os produtos secundários atribuídos para o produto configurável.
Exclua a associação de produtos simples a produtos configuráveis.

Ao criar produtos configuráveis no Adobe Commerce Admin, você pode criar os produtos simples primeiro ou usar a ferramenta automatizada que cria novos produtos simples para usar usando o assistente.

Para quem é este vídeo?

Gerentes de sites
Merchandisers de comércio eletrônico
Novos desenvolvedores do Adobe Commerce que desejam aprender como criar produtos configuráveis no Adobe Commerce usando a REST API

Conteúdo de vídeo

https://video.tv.adobe.com/v/3426381?learn=on

Obter os atributos de cor usando cURL

Neste exemplo, o conjunto de atributos inteiro com todos os atributos individuais é retornado para o conjunto de atributos 10. Pode ser longo, centenas de linhas não são incomuns. Ao revisar a resposta, a ID do atributo para cor provavelmente estará no meio. Acelere a pesquisa desses valores usando grep ou outros métodos para pesquisar os resultados. Minha resposta estava próxima à linha 665 e está incluída no seguinte trecho da resposta 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"
            }
        ],
...

Para recuperar as IDs de atributo para definir seu produto configurável, atualize a parte attribute-sets/10/attributes da seguinte solicitação de cURL para substituir 10 pela ID do conjunto de atributos em seu ambiente. Essa solicitação usa o método GET.

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

Criar o primeiro produto simples usando o cURL

Ajustar IDs de ambiente e detalhes do produto

Crie o primeiro produto simples usando a API para enviar a seguinte solicitação de POST usando cURL.

Antes de enviar a solicitação, atualize o exemplo com os valores do seu ambiente.

Altere "attribute-set": 10 para substituir 10 pela ID do conjunto de atributos de seu ambiente.
Altere "value": "13" para substituir 13 pelo valor do seu ambiente.

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"
        }
    ]
  }
}
'

Criar o segundo produto simples usando o cURL

Crie o segundo produto simples usando a API para enviar a seguinte solicitação de POST usando cURL.

Antes de enviar a solicitação, atualize o exemplo com os valores do seu ambiente.

Altere "attribute_set_id": 10, e substitua 10 pela ID do conjunto de atributos de em seu ambiente.
Altere "value": "14" e substitua 14 pelo valor do seu ambiente.

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"
        }
    ]
  }
}
'

Criar o terceiro produto simples usando o cURL

Crie o terceiro produto simples enviando a seguinte solicitação de POST usando cURL.

Antes de enviar a solicitação, atualize o exemplo com os valores do seu ambiente.

Altere "attribute_set_id": 10, para substituir 10 pela ID do conjunto de atributos de seu ambiente.
Altere "value": "15" e substitua 15 pelo valor do seu ambiente.

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"
        }
    ]
  }
}
'

Criar um produto configurável vazio usando o cURL

Crie um produto configurável vazio enviando a seguinte solicitação de POST usando cURL.

Antes de enviar a solicitação, atualize o exemplo com os valores do seu ambiente.

Altere "attribute_set_id": 10, e substitua 10 pela ID do conjunto de atributos de seu ambiente.
Altere "value": "93" e substitua 93 pelo valor do seu ambiente.

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"
        }
    ]
  }
}'

Definir as opções disponíveis para o produto configurável

Defina as opções disponíveis para o produto configurável, enviando a solicitação POST a seguir usando cURL.

Antes de enviar a solicitação, altere "attribute_id": 93, para substituir 93 pela ID de atributo do seu ambiente.

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
      }
    ]
  }
}'

Se você esquecer de definir as opções do produto configurável (principal), receberá um erro ao tentar associar um produto secundário ao produto configurável. A mensagem de erro é semelhante ao seguinte exemplo:

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

Vincular o produto derivado ao configurável

Agora, você criou três produtos simples:

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

Adicione esses produtos simples como filhos do produto configurável enviando a solicitação POST a seguir. Envie uma solicitação separada para cada produto.

Para cada solicitação, atualize o valor childSKU com o valor do produto filho que você está adicionando. O exemplo a seguir atribui o produto simples kids-Hawaiian-Ukulele-red ao produto configurável com o 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"
}
'

Obter um produto configurável usando o cURL

Agora que você criou um produto configurável com três SKUs secundárias atribuídas. Você pode ver as IDs vinculadas dos produtos atribuídos enviando a seguinte solicitação do GET usando o cURL. Esta solicitação retorna informações detalhadas sobre o produto configurável.

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

O seguinte usa o método GET

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

Obter o produto filho associado a um produto configurável

Retorne somente os filhos associados ao produto configurável enviando a solicitação GET a seguir. A resposta incluirá todos os atributos do produto secundário, incluindo SKU e preço.

O seguinte usa o método GET

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

Excluir ou remover um produto filho do configurável pai

Você pode remover um produto filho de um produto configurável sem excluir o produto do catálogo enviando a seguinte solicitação de DELETE usando 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}}'

Recursos adicionais

recommendation-more-help