{"section":"tutorials","requestedLocale":"pt","requestedSlug":"assembly-options","locale":"pt","slug":"assembly-options","path":"docs/pt/tutorials/catálogo/campos-personalizados/assembly-options.md","branch":"main","content":"> ⚠️ Esta funcionalidade está disponível apenas para lojas desenvolvidas usando [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\nUma Assembly Option é um [anexo](/pt/docs/tutorials/o-que-e-um-anexo) para cenários complexos, como a customização de produtos, em que é necessário gerenciar diferentes combinações de produtos, quantidade, itens adicionais, custos e estoque.\n\nNo exemplo abaixo, uma loja oferece várias Assembly Options para o produto _Custom Bell_. Essas opções são mostradas na página do produto, onde o cliente pode selecionar as opções desejadas. Dependendo das escolhas, pode haver um custo adicional.\n\n![assembly-option-PT](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/catálogo/campos-personalizados/assembly-options_1.png)\n\nVocê pode combinar [SKUs](/pt/docs/tutorials/o-que-e-um-sku) para oferecer Assembly Options, como o _Bells add-ons Roman_ ou o _Bells add-ons 1-3 lines_ no exemplo acima. Se um item estiver esgotado, ele será exibido como indisponível.\n\nNeste artigo, explicamos como começar a utilizar Assembly Options na sua loja.\n\n## Implementação das Assembly Options\n\nExistem duas formas de implementar Assembly Options: utilizando o [app Assembly Options](#app-assembly-options) ou utilizando a interface nativa de [Campos personalizados](#campos-personalizados) do Catálogo.\n\n> ⚠️ Ao implementar Assembly Options 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 implementar a funcionalidade em uma [conta de marketplace](/pt/docs/tutorials/o-que-e-um-marketplace).\n\n### App Assembly Options\n\nO app [Assembly Options](https://apps.vtex.com/vtex-admin-assembly-options/p), disponível para lojas desenvolvidas usando [VTEX IO](https://vtex.com/br-pt/store-framework/), oferece uma interface para configuração e gerenciamento das opções de customização. Nesse caso, a sintaxe da Assembly Option e o anexo são gerados automaticamente. Para saber mais sobre esse aplicativo, leia a documentação [App Assembly Options](/pt/docs/tutorials/app-assembly-options).\n\n### Campos personalizados\n\nPara criar Assembly Options utilizando **Campos personalizados** no Admin VTEX, você precisa primeiro criar uma [sintaxe](#sintaxe-das-assembly-options) de forma manual para definir as regras de customização do produto. Em seguida, é necessário inserir essa sintaxe na [configuração do anexo](#configuracao-do-anexo). Confira as seções a seguir para mais detalhes.\n\n#### Sintaxe das Assembly Options\n\nPara implementar uma Assembly Option, primeiro é necessário criar uma sintaxe, como ilustrado no exemplo abaixo, alterando cada valor de acordo com o seu cenário.\n\n`[0-3]#10000[1-2][1]pricetable1;#20000[0-2][0]pricetable2;#30000[0-2][0]pricetable3`\n\nO primeiro trecho`[x-y]` se refere às regras aplicadas ao grupo, e entre cada `#` e `;` estão as regras que se aplicam a cada SKU. Saiba mais sobre os segmentos da sintaxe na tabela abaixo.  \n\n| Segmento            | Descrição           |\n|------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n|**\\[0-3\\]**#10000\\[1-2\\]\\[1\\]pricetable1;#20000\\[0-2\\]\\[0\\]pricetable2;#30000\\[0-2\\]\\[0\\]pricetable3       | A quantidade mínima e máxima de itens que podem ser selecionados no grupo. O primeiro segmento determina quantas escolhas essa Assembly Option aceita no total. `[0-3]` significa que você pode selecionar um mínimo de zero e um máximo de três itens. Se o valor for `[1-1]`, isso significa que você só pode selecionar um item entre todas as opções. |\n| \\[0-3\\]#**10000**\\[1-2\\]\\[1\\]pricetable1;**#20000**\\[0-2\\]\\[0\\]pricetable2;#**30000**\\[0-2\\]\\[0\\]pricetable3 | Após cada `#`, você deve incluir o ID do SKU do componente. Você deve usar pelo menos um SKU.|\n| \\[0-3\\]#10000**\\[1-2\\]**\\[1\\]pricetable1;#20000**\\[0-2\\]**\\[0\\]pricetable2;#30000**\\[0-2\\]**\\[0\\]pricetable3 | Esse segmento define a quantidade mínima e máxima de cada SKU que o cliente final pode selecionar. O valor `[0-1]` significa que pode haver no máximo um desse SKU.|\n|\\[0-3\\]#10000\\[1-2\\]**\\[1\\]**pricetable1;#20000\\[0-2\\]**\\[0\\]**pricetable2;#30000\\[0-2\\]**\\[0\\]**pricetable3 | Esse segmento define a quantidade padrão selecionada para cada SKU.                                    |\n| \\[0-3\\]#10000\\[1-2\\]\\[1\\]**pricetable1**;#20000\\[0-2\\]\\[0\\]**pricetable2**;#30000\\[0-2\\]\\[0\\]**pricetable3** | O segmento final indica a tabela de preços para cada item. |\n\n![assembly-option-exemplo-PT](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/catálogo/campos-personalizados/assembly-options_2.png)\n\n#### Configuração do Anexo\n\nPara adicionar uma Assembly Option, é necessário ter um anexo já cadastrado. Consulte o artigo [Cadastrar um anexo](/pt/docs/tutorials/cadastrar-um-anexo) para saber mais.\n\nApós criar um anexo e [associá-lo a um SKU](/pt/docs/tutorials/cadastrar-um-anexo#associar-o-anexo-a-um-sku), siga os passos abaixo para configurar a Assembly Option.\n\n1. No Admin VTEX, acesse __Catálogo__, ou digite __Catálogo__ na barra de busca no topo da página.\n2. Clique em **Campos personalizados**.\n3. Na aba **Serviço e SKUs**, selecione o anexo ao qual você deseja adicionar a Assembly Option e clique em `Alterar`.\n4. No campo **Valores permitidos**, insira a sintaxe que você criou, conforme explicado na seção [Sintaxe das Assembly Options](#sintaxe-das-assembly-options).\n5. Clique em `Salvar`."}