> ## Documentation Index
> Fetch the complete documentation index at: https://tutoriais.clickescale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Complementos e adicionais

> Crie grupos de complementos, defina opções, preços e regras de escolha mínima e máxima.

Os **complementos** são as escolhas que o cliente faz dentro do produto: sabor da pizza, borda recheada, ponto da carne, adicionais, refrigerante do combo. Você cria o grupo **uma vez** e vincula a quantos produtos quiser.

<Card title="Abrir Complementos" icon="puzzle-piece" href="https://app.clickescale.com/complementos">
  Acesse **Cardápio Digital → Complementos** no menu lateral para acompanhar este tutorial na prática.
</Card>

## Onde encontrar

No menu lateral esquerdo, em **Cardápio Digital → Complementos**. A tela tem duas colunas: a **lista de grupos** à esquerda (com busca e filtro) e o **grupo selecionado** à direita, com todas as suas opções.

<Frame caption="Tela Complementos: lista de grupos à esquerda e opções do grupo selecionado à direita.">
  ![Tela de complementos](https://id-preview--97ba6806-e888-42e2-883e-2ae30b35af3b.lovable.app/__l5e/assets-v1/25d245aa-93d9-4080-a7c1-950bef772601/10_complementos.png)
</Frame>

Cada item da lista mostra o **nome do grupo**, quantas **opções** ele tem e se é **Obrigatório**. O botão de liga/desliga ao lado ativa ou desativa o grupo inteiro — desativado, ele deixa de aparecer no cardápio digital e nos pedidos manuais.

<Tip>
  A alça de arrastar à esquerda de cada grupo define a **ordem em que as perguntas aparecem** para o cliente. Coloque primeiro o que é obrigatório (sabor, tamanho) e deixe os adicionais no fim.
</Tip>

## Anatomia de um grupo

Ao clicar em um grupo, o painel da direita mostra o cabeçalho com o nome, o status **Ativo**, a regra de escolha (ex.: *Apenas uma opção*) e a lista de **Opções**.

<Frame caption="Grupo “Adicionais” com 5 opções, cada uma com valor adicional e disponibilidade.">
  ![Detalhe do grupo de complementos](https://id-preview--97ba6806-e888-42e2-883e-2ae30b35af3b.lovable.app/__l5e/assets-v1/c48a31c0-af0b-4ee3-bae3-b92bbc41d933/11_complemento_detalhe.png)
</Frame>

| Elemento             | Para que serve                                                                 |
| -------------------- | ------------------------------------------------------------------------------ |
| **Nome do grupo**    | É a pergunta que o cliente lê no cardápio (“Adicionais”, “Escolha o tamanho”). |
| **Ativo / Inativo**  | Desliga o grupo em todos os produtos de uma vez.                               |
| **Regra de escolha** | Quantas opções o cliente pode marcar.                                          |
| **Opções**           | As respostas possíveis, com valor adicional e disponibilidade individual.      |
| **Adicionar Opção**  | Cadastra uma nova opção dentro do grupo.                                       |
| **Excluir**          | Remove o grupo (e desvincula dos produtos).                                    |

## Criar um grupo de complementos

<Steps>
  <Step title="Clique no botão + no topo da lista">
    Ele fica ao lado do título **COMPLEMENTOS**, na coluna da esquerda. Abre o modal **Novo Complemento**.

    <Frame caption="Modal Novo Complemento: nome, regra de escolha e obrigatoriedade.">
      ![Novo complemento](https://id-preview--97ba6806-e888-42e2-883e-2ae30b35af3b.lovable.app/__l5e/assets-v1/58e7d0fd-c12c-433b-9ddc-8caa60576346/12_novo_complemento.png)
    </Frame>
  </Step>

  <Step title="Dê um nome claro">
    Escreva como uma pergunta: “Escolha o Tamanho”, “Ponto da Carne”, “Molhos”, “Adicionais”. Esse texto aparece exatamente assim para o cliente.
  </Step>

  <Step title="Escolha o que o cliente poderá escolher">
    * **Apenas uma das opções** — o cliente marca 1 (sabor, tamanho, ponto da carne).
    * **Mais de uma opção sem repetição** — pode marcar várias, cada uma uma vez (molhos, adicionais).
    * **Mais de uma opção com repetição** — pode repetir a mesma opção (2× bacon extra).
    * **Opção já selecionada, cliente não pode desmarcar** — você marca item por item o que já vem incluso e fica bloqueado.
  </Step>

  <Step title="Defina se é obrigatório">
    Com **Obrigatório** ligado, o cliente não fecha o produto sem escolher. Deixe desligado para adicionais opcionais.
  </Step>

  <Step title="Clique em Criar Complemento">
    O grupo entra na lista da esquerda, pronto para receber opções.
  </Step>
</Steps>

<Info>
  No mesmo modal existem ainda **Usar como driver de variações** e **Regras de exibição** — explicados nas seções seguintes.
</Info>

## Adicionar opções ao grupo

<Steps>
  <Step title="Selecione o grupo e clique em Adicionar Opção">
    O botão verde fica no topo direito da lista de opções.

    <Frame caption="Modal Nova Opção: foto, nome, descrição, valor adicional e disponibilidade.">
      ![Nova opção](https://id-preview--97ba6806-e888-42e2-883e-2ae30b35af3b.lovable.app/__l5e/assets-v1/6fa40717-5d7e-4430-bcb8-2f8f9606312a/13_nova_opcao.png)
    </Frame>
  </Step>

  <Step title="Preencha nome e descrição">
    **Nome** é obrigatório (“Bacon Extra”, “Pequeno”, “Ao ponto”). A **descrição** é opcional e ajuda em bebidas e porções (“serve 1 pessoa, 300ml”).
  </Step>

  <Step title="Informe o valor adicional">
    Digite quanto o item soma no preço final. Deixe **0,00** (ou em branco) para opções sem custo, como “Sem cebola”.
  </Step>

  <Step title="Confira a disponibilidade">
    **Opção disponível para pedidos** ligada = aparece em todos os canais. Desligada, ela some do cardápio digital, das mesas/comandas e dos pedidos manuais — sem precisar excluir nada.
  </Step>

  <Step title="Adicione a foto (opcional)">
    A foto aparece no cardápio digital e ajuda muito em bordas, sabores e sobremesas.
  </Step>

  <Step title="Clique em Adicionar Opção">
    A opção entra na lista com o preço à direita e o botão de disponibilidade.
  </Step>
</Steps>

<Tip>
  Um grupo **“Adicionais”** com 3 a 6 itens de boa margem (bacon, queijo extra, molho especial) é o upsell mais barato que existe. Vincule em todos os produtos onde faz sentido.
</Tip>

## Drivers de variação

Ligue **Usar como driver de variações** quando a escolha daquele grupo muda as outras perguntas. O exemplo clássico é **tamanho da pizza**: escolhendo “Grande”, as opções de borda e recheio se ajustam ao tamanho selecionado.

<Warning>
  Use driver de variações em apenas um grupo por produto (normalmente tamanho). Mais de um driver deixa a combinação confusa para o cliente e difícil de manter.
</Warning>

## Regras de exibição

Ainda no modal do grupo, as **Regras de exibição** permitem mostrar aquele grupo somente em certos casos — por exemplo, apenas quando o cliente escolheu um determinado tamanho ou sabor. Isso evita perguntas que não fazem sentido para a combinação atual.

## Vincular ao produto

Criar o grupo **não** o coloca automaticamente no produto. O vínculo é feito na ficha do produto:

<Steps>
  <Step title="Abra Cardápio Digital → Cardápios e selecione o produto" />

  <Step title="Vá até a aba Complementos do produto">
    À esquerda fica a **Biblioteca** com todos os grupos criados; à direita, os grupos já vinculados àquele produto.
  </Step>

  <Step title="Clique no grupo para vincular">
    Ele passa para a lista de vinculados. Ali você também define a ordem em que as perguntas aparecem para esse produto específico.
  </Step>
</Steps>

<Info>
  O mesmo grupo pode ser **obrigatório em um produto e opcional em outro** — a obrigatoriedade padrão vem do grupo, mas cada produto tem o seu vínculo.
</Info>

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Editei o preço de uma opção. Muda em todos os produtos?">
    Sim. O grupo é único e compartilhado: alterou o valor de “Bacon Extra”, todos os produtos que usam aquele grupo passam a cobrar o novo valor.
  </Accordion>

  <Accordion title="O cliente não consegue adicionar o produto ao carrinho. Por quê?">
    Quase sempre é um **grupo obrigatório sem opções disponíveis**. Verifique se as opções daquele grupo estão com a disponibilidade ligada.
  </Accordion>

  <Accordion title="O adicional não está sendo cobrado no pedido.">
    Confira o **valor adicional** da opção. Se estiver 0,00, ela é registrada como gratuita — inclusive nos pedidos de mesas e comandas.
  </Accordion>

  <Accordion title="Posso baixar estoque dos adicionais?">
    Sim. Vincule ingredientes à opção nas configurações avançadas e a baixa de estoque e o custo entram pela ficha técnica.
  </Accordion>

  <Accordion title="Quantos grupos obrigatórios devo usar por produto?">
    No máximo 2 ou 3. Muitas perguntas obrigatórias cansam o cliente e derrubam a conversão do cardápio.
  </Accordion>
</AccordionGroup>

<Card title="Gerenciar produtos do cardápio" icon="burger" href="/tutoriais/cardapio/produtos">
  Veja como cadastrar produtos, preços promocionais e vincular os grupos de complementos.
</Card>
