{"section":"tutorials","requestedLocale":"pt","requestedSlug":"app-assembly-options","locale":"pt","slug":"app-assembly-options","path":"docs/pt/tutorials/apps/app-assembly-options.md","branch":"main","content":"> ⚠️ Este aplicativo está disponível apenas para lojas que utilizam [VTEX IO](https://vtex.com/br-pt/store-framework/). Antes de prosseguir, você deve [instalar e configurar o Product Customizer](https://developers.vtex.com/vtex-developer-docs/docs/vtex-product-customizer) na sua loja.\n\nNa VTEX, é possível disponibilizar opções de customização de produtos utilizando [Assembly Options](/pt/docs/tutorials/assembly-options). Essa solução consiste em criar [anexos](/pt/docs/tutorials/o-que-e-um-anexo) para cenários complexos, em que é necessário gerenciar diferentes combinações de produtos, quantidades, itens adicionais e custos.\n\nO [app Assembly Options](https://apps.vtex.com/vtex-admin-assembly-options/p) disponibiliza uma interface para configurar e gerenciar as opções de customização em lojas que utilizam [VTEX IO](https://vtex.com/br-pt/store-framework/), como alternativa à implementação de Assembly Options pelos anexos do Catálogo.\n\n## Instalação \n\nVocê pode instalar o aplicativo gratuitamente pela [VTEX App Store](https://apps.vtex.com/vtex-admin-assembly-options/p) ou pelo [VTEX IO CLI](https://developers.vtex.com/vtex-developer-docs/docs/vtex-io-documentation-vtex-io-cli-installation-and-command-reference), seguindo os passos do [guia para desenvolvedores Assembly Options](https://developers.vtex.com/vtex-developer-docs/docs/assembly-options-app).\n\n> ⚠️ Quando o aplicativo Assembly Options é instalado em uma [conta de seller](/pt/docs/tutorials/o-que-e-um-seller), as opções de customização do produto são exibidas para os clientes da sua loja no checkout. Para que as opções sejam exibidas na página do produto, você precisa instalar o aplicativo em uma [conta de marketplace](/pt/docs/tutorials/o-que-e-um-marketplace).\n\nApós a instalação, a página **Catálogo > Assembly Options** se torna disponível no Admin VTEX. Veja a seguir as funcionalidades disponíveis uma vez que o aplicativo é instalado.\n\n## Lista de Assembly Options\n\nNo Admin VTEX, em **Catálogo > Assembly options**, você tem acesso a uma lista com todas as Assembly Options cadastradas na sua loja utilizando o aplicativo.\n\n![assembly-options-app](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/apps/app-assembly-options_1.png)\n\nAs informações exibidas na lista são:\n\n* **ID:** exibe o ID da Assembly Option, que equivale ao ID do [anexo](/pt/docs/tutorials/o-que-e-um-anexo) no **Catálogo**.\n* **Nome:** indica o nome do anexo de tipo Assembly Option.\n* **Obrigatório:** quando marcada com um <i class=\"far fa-check-circle\"></i>, esta coluna indica que o anexo de tipo Assembly Option é obrigatório. Se o campo estiver vazio, não é obrigatório.\n* **Status:** indica o status da Assembly Option, que pode ser:\n    * **Ativa**: significa que as opções de customização estão ativadas, então elas serão exibidas na sua loja [se forem associadas a um SKU](/pt/docs/tutorials/cadastrar-um-anexo#associar-o-anexo-a-um-sku).\n    * **Inativa**: significa que as opções de customização estão desativadas, portanto não estarão disponíveis para seleção.\n* **Menu** <i class=\"fas fa-ellipsis-v\"></i>: exibe as opções a seguir:\n    * <i class=\"far fa-pencil\"></i> **Editar**: permite acessar a página de edição da Assembly Option.\n    * <i class=\"far fa-trash-alt\"></i> **Deletar**: permite excluir uma Assembly Option.\n\nVocê pode buscar por uma Assembly Option pelo nome, utilizando a barra de busca. Também é possível filtrar os resultados exibidos na lista por **Status**(**Ativa** ou **Inativa**).\n\nPara configurar uma nova Assembly Option, você precisa clicar no botão `Criar Assembly option`, no canto superior direito da página.\n\n## Criar ou editar Assembly Option\n\nA página **Produtos > Assembly options > Novas Assembly options** contém um formulário com as informações necessárias para criar ou editar uma Assembly Option. Siga os passos abaixo para criar uma Assembly Option.\n\n1. Preencha os campos de **Informações básicas**:\n    * **Nome:** nome da Assembly Option. Exemplo: Ingredientes.\n    * <i class=\"fas fa-toggle-on\"></i> **Ativa:** define se a Assembly Option ficará ativa, ou seja, disponível para uso na sua loja.\n    * <i class=\"far fa-square\"></i> **Obrigatório:** define se é obrigatório que seus clientes selecionem uma das opções disponibilizadas pela Assembly Option ou não.\n2. Em **Grupos de SKU**, clique em `Adicionar novo grupo`.\n    Um grupo sem nome será criado. Cada grupo irá reunir as opções de SKU disponibilizadas para escolha dos clientes.\n3. Preencha as informações do grupo criado:\n    * **Nome**: nome do grupo que será mostrado na página do produto. Exemplo: Ingredientes extras.\n    * **Quantidade mínima:** define a quantidade mínima de itens do grupo que o cliente da sua loja pode selecionar.\n    * **Quantidade máxima:** define a quantidade máxima de itens do grupo que o cliente da sua loja pode selecionar.\n4. Clique em `Adicionar SKU` para incluir um SKU existente no grupo.\n5. Preencha as seguintes informações sobre o SKU:\n    * **ID do SKU:** identificador do SKU.\n    * **Nome da tabela de preço vinculada:** nome da tabela de preço a ser considerada para o SKU selecionado. Quando esse campo for deixado vazio, o SKU vai assumir o preço da política comercial cadastrada.\n    * **Quantidade mínima:** quantidade mínima do item que o cliente da sua loja pode selecionar.\n    * **Quantidade máxima:** quantidade máxima do item que o cliente da sua loja pode selecionar.\n    * **Quantidade inicial:** quantidade do item que será selecionada por padrão.\n6. Clique em `Adicionar`.\n    As informações do SKU adicionado serão exibidas em uma tabela, a partir da qual é possível editar as informações ou deletar o SKU do grupo.\n    Se desejar, adicione outros SKUs ao grupo repetindo o passo 4 em diante. Você também pode criar outros grupos repetindo o passo 2 em diante.\n7. Quando todos os grupos estiverem configurados, clique em `Salvar`.\n\nAo salvar a Assembly Option, um anexo é criado automaticamente em **Catálogo > Anexos**, com o prefixo `vtex.assembly-option.` adicionado ao nome da Assembly Option criada. Exemplo: `vtex.assembly-option.Ingredientes`.\n\n> ⚠️ Para que as opções de customização cadastradas na Assembly Option apareçam no storefront, é necessário associar o anexo criado a um SKU em* **Catálogo > Produtos e SKUs > SKU > Configurações Avançadas > Anexos***. Para isso, siga os passos descritos em [Associar o anexo a um SKU](/pt/docs/tutorials/cadastrar-um-anexo#associar-o-anexo-a-um-sku).\n\n## Saiba mais\n\n* [Assembly Options](/pt/docs/tutorials/assembly-options)\n* [O que é um Anexo?](/pt/docs/tutorials/o-que-e-um-anexo)"}