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

# Complementos

> Crie complementos com opções e preços, defina mínimo, máximo e obrigatório e ligue cada um aos produtos e pizzas do cardápio.

Complementos são os grupos de escolhas que aparecem quando o cliente abre um item do cardápio, como os molhos de um lanche ou os adicionais de um açaí. Na aba **Complementos** você cria e edita esses grupos e as opções de cada um, com preço. Cada complemento fica numa lista única da loja: você cria uma vez e liga aos produtos e pizzas em que ele deve aparecer.

Na tela, o complemento às vezes aparece com o nome de variação, como em **Título da variação** e **Pesquisar variações**.

<Note>
  Todos os papéis abrem e alteram os complementos: Dono, Gerente, Gestor de Tráfego e Operador. Uma parte está em liberação e só aparece nas lojas que a Brendi já liberou: o canal **Presencial**, do pedido na mesa.
</Note>

## Onde encontrar

**Editor de cardápio › Complementos**

A aba fica no topo do editor, ao lado de **Produtos**, e lista todos os complementos da loja. As outras abas estão em [Editor de cardápio](/funcionalidades/editor-de-cardapio).

Os complementos também aparecem dentro do produto, na seção **Complementos / Adicionais** (veja [Produtos](/funcionalidades/editor-de-cardapio/produtos#adicionar-complemento)), e na aba **Complementos** das categorias de pizza, que no celular se chama **Variações** (veja [Pizzas](/funcionalidades/editor-de-cardapio/pizzas#complementos)). Como eles funcionam ali está em [Complementos no produto e na pizza](#complementos-no-produto-e-na-pizza).

## Configurações

Cada complemento existe uma vez só na loja. A aba **Complementos**, a janela do complemento e as listas dentro dos produtos e das pizzas mexem sempre no mesmo complemento: uma mudança nele vale em todos os lugares em que ele está.

## Aba Complementos

A aba mostra a **Lista de complementos**, do mais novo para o mais antigo. Cada cartão traz o nome do complemento e, embaixo, os nomes das opções. Complemento desligado ganha **(Inativo)** no nome; em falta, **(Em falta)**. Nos dois casos, o cartão fica acinzentado.

Para achar um complemento, digite em **Pesquisar variações**: a busca olha o nome do complemento e o nome das opções.

### Novo complemento

Abre a janela **Criar novo complemento**, com os campos de [Criar ou editar um complemento](#criar-ou-editar-um-complemento). Depois de salvo, o complemento entra no topo da lista.

No computador, o botão fica no alto, à direita da lista. No celular, fica embaixo e ocupa a largura da tela.

### Ligar e desligar

A chave de cada cartão liga e desliga o complemento na hora, sem abrir a janela e sem salvar. Vale para todos os produtos e pizzas que usam o complemento.

* **Desligar** deixa o complemento **Inativo**: ele sai do cardápio.
* **Ligar** deixa o complemento **Ativo**.
* Complemento **Em falta** aparece com a chave ligada, mas continua fora do cardápio. Para ele voltar, escolha **Ativo** na janela do complemento, ou desligue e ligue a chave.

A mesma chave aparece na lista de complementos de um produto ou de uma pizza e nos [resultados da busca](/funcionalidades/editor-de-cardapio/produtos#resultados-da-busca) do editor.

### Editar e apagar

O lápis de cada cartão abre a janela **Editar complemento**. A lixeira apaga o complemento: confirme em **Deletar**, na janela **Deletar variação**.

<Warning>
  Apagar não tem volta. O complemento sai de todos os produtos, categorias de pizza e tamanhos de pizza em que estava. Se alguma opção tinha **Código PDV**, ela também sai do [Estoque](/funcionalidades/editor-de-cardapio/estoque). Para tirar o complemento de um produto só, sem apagar, use a lixeira dentro do produto (veja [Complementos do produto ou da pizza](#complementos-do-produto-ou-da-pizza)).
</Warning>

## Criar ou editar um complemento

A janela se chama **Criar novo complemento** quando o complemento é novo e **Editar complemento** quando ele já existe. No celular, ela ocupa a largura da tela. Fechar a janela sem salvar descarta as mudanças.

### Opção única, Opção múltipla e Opção somável

Define como o cliente escolhe as opções. Cada tipo aparece num cartão com um desenho de exemplo.

* **Opções:**
  * **Opção única:** o cliente escolhe uma opção só. Tocar de novo na opção marcada desmarca, se o complemento não for obrigatório.
  * **Opção múltipla:** o cliente marca opções diferentes, cada uma uma vez, até o máximo que você definir.
  * **Opção somável:** o cliente escolhe a quantidade de cada opção nos botões de mais e de menos e pode repetir a mesma opção. O preço da opção é cobrado por unidade.
* **Padrão:** **Opção única**.
* **O que o cliente vê:** quando ele termina a escolha de um complemento (a opção da **Opção única** ou o máximo das outras), o cardápio rola sozinho até o próximo.

Trocar o tipo mantém as opções. Só a [Quantidade máxima dessa opção](#quantidade-m%C3%A1xima-dessa-op%C3%A7%C3%A3o) some quando o tipo deixa de ser **Opção somável**.

### Título da variação

O nome do complemento. Obrigatório.

* **O que o cliente vê:** o título em cima das opções, na página do item.

### Quantidade para escolha

Só aparece em **Opção múltipla** e **Opção somável**. Na frase **O cliente escolherá de … até … unidades**, o primeiro campo é o mínimo e o segundo, o máximo.

* **Mínimo:** 0 ou mais. Acima de 0, o complemento fica obrigatório, e a janela avisa **Esta variação será obrigatória**.
* **Máximo:** maior que zero e não menor que o mínimo. Fora disso, o campo mostra o erro e o complemento não é salvo. Com o máximo em 0, aparece **A quantidade máxima de escolhas deve ser maior que zero!**.
* **Padrão:** 0 nos dois campos. Preencha o máximo antes de salvar.
* Na **Opção somável**, o máximo vale para a soma das unidades de todas as opções.
* **O que o cliente vê:** um selo com a regra, como **Escolha até 3 opções**, **Escolha 2 opções** (mínimo igual ao máximo) ou **Escolha de 1 a 3**, e um contador do que ele já escolheu. No máximo, ele não consegue escolher mais nada nesse complemento. Abaixo do mínimo, o item não entra no pedido: o cardápio volta até o complemento e mostra um aviso. Com mínimo maior que 0, também aparece o selo **Obrigatório** até o cliente chegar ao mínimo.

### Tornar essa variação obrigatória

Só aparece em **Opção única**. Marcada, o cliente precisa escolher uma opção para colocar o item no pedido.

* **Padrão:** desmarcada.
* **O que o cliente vê:** o selo **Obrigatório** até ele escolher. Se tentar adicionar o item sem escolher, o cardápio volta até o complemento e mostra um aviso pedindo a escolha.

### Ativo, Inativo e Em falta

O status do complemento, embaixo de **Delivery**.

* **Opções:** **Ativo**, **Inativo** e **Em falta**.
* **Padrão:** **Ativo**.
* **O que o cliente vê:** **Inativo** e **Em falta** têm o mesmo efeito no cardápio digital: o complemento some do item. Diferente do produto em falta, que continua aparecendo como esgotado, o complemento em falta não aparece para o cliente. No editor, o nome ganha **(Inativo)** ou **(Em falta)**.
* O status só é gravado quando você salva. Para ligar e desligar sem abrir a janela, use a [chave da lista](#ligar-e-desligar).
* Nas lojas com o canal **Presencial**, aparece também a coluna **Presencial**. Veja [Delivery e Presencial](#delivery-e-presencial).

### Opção pré definida

Só aparece quando o [Pedido conversacional](/funcionalidades/atendimento/configuracoes#pedido-conversacional) está ligado e o complemento tem pelo menos uma opção. É a opção que o atendente usa como padrão nos pedidos tirados na conversa. O selo **Pedido tirado na conversa** lembra que ela só vale para esses pedidos.

* **Opções:** **Nenhuma** ou uma das opções do complemento.
* **Padrão:** **Nenhuma**.
* Se você apagar a opção escolhida aqui, o campo volta para **Nenhuma**.

## Opções

A lista **Opções** traz as escolhas do complemento, na ordem em que o cliente vê. Cada opção aparece com o nome (ou **Nova opção**, enquanto não tem nome), o preço e o status. Use o ícone de arrastar para mudar a ordem, a seta para abrir e fechar os detalhes e a lixeira para apagar a opção.

A opção nova já vem aberta. Ao salvar, as opções sem nome abrem sozinhas para você completar. No computador, o preço e o status ficam na mesma linha do nome; no celular, ficam embaixo dele.

<Warning>
  Num complemento já salvo, a lixeira de uma opção com **Código PDV** tira a opção do [Estoque](/funcionalidades/editor-de-cardapio/estoque) na hora do clique, mesmo que você feche a janela sem salvar.
</Warning>

### Preço e status da opção

Na linha **Delivery** de cada opção ficam o preço, em R\$, e o status: **Ativo**, **Inativo** ou **Em falta**.

* **Preço:** o valor somado ao item quando o cliente escolhe a opção. Na **Opção somável**, ele é cobrado por unidade.
* **Status:** **Inativo** e **Em falta** tiram só essa opção do cardápio. Complemento sem nenhuma opção ativa não aparece.
* **Padrão:** R\$ 0,00 e **Ativo**.
* **O que o cliente vê:** o preço embaixo do nome da opção, com um sinal de mais na frente, como **+R\$ 2,00**. Opção de R\$ 0,00 aparece sem preço.

Se o item tem complemento com opção paga, a página dele mostra **A partir de** e o preço do item somado ao mínimo que os complementos obrigatórios exigem, sempre pelas opções mais baratas.

### Nome da opção

O nome que o cliente vê na opção. Obrigatório: com alguma opção sem nome, o botão de salvar fica desativado.

### Código PDV

O código da opção no seu sistema de PDV, usado no controle de [Estoque](/funcionalidades/editor-de-cardapio/estoque). O ícone de informação ao lado do nome avisa que o código ainda não tem todas as funções de PDV. Numa opção nova, vem vazio.

Se você troca o código de uma opção e o código antigo também é usado por outros produtos ou complementos, ao salvar aparece a janela **Alterar Código PDV**, a mesma do [produto](/funcionalidades/editor-de-cardapio/produtos#c%C3%B3digo-pdv):

* **Atualizar todos os itens relacionados:** troca o código em todos eles e mantém o estoque ligado.
* **Alterar apenas este item:** troca o código só nesta opção e tira ela do estoque atual.
* Cancelar volta o código antigo e não salva o complemento.

### Descrição

Um texto curto embaixo do nome da opção, no cardápio. Opcional. Na busca **Pesquisar** da página do item, o cliente também acha a opção pelas palavras da descrição.

### Quantidade máxima dessa opção

Só aparece na **Opção somável**. Quantas unidades dessa opção o cliente pode pedir, dentro do máximo do complemento.

* **Padrão:** o máximo do complemento no momento em que a opção foi criada ou em que o tipo mudou para **Opção somável**.
* Se ficar em 0 ou vazio, ao salvar o campo passa a valer o máximo do complemento.
* **O que o cliente vê:** o botão de mais dessa opção fica desativado quando ela chega no limite.

### Foto

Cada opção pode ter uma foto, de até 10 MB. Ela só é enviada quando você salva o complemento. No cardápio, aparece em miniatura ao lado da opção.

### Adicionar nova opção

Põe uma opção em branco no fim da lista, já aberta, com preço R\$ 0,00 e status **Ativo**.

## Salvar e duplicar

Os botões ficam no rodapé da janela do complemento.

### Salvar

Grava o complemento: **Salvar complemento** quando ele é novo e **Salvar** quando você edita um que já existe.

* O botão fica desativado até o **Título da variação** e o **Nome da opção** de todas as opções estarem preenchidos. Enquanto isso, a dica dele diz **Preencha todos os campos obrigatórios**.
* Sem nenhuma opção, aparece **Adicione pelo menos 1 opção!** e nada é gravado.
* Depois de salvar, aparece **Variação criada com sucesso!** ou **Variação atualizada com sucesso!**, e a janela fecha.
* Se você mudou o [Código PDV](#c%C3%B3digo-pdv) de uma opção, antes de gravar pode aparecer a janela **Alterar Código PDV**.

### Complemento em uso

Aparece ao salvar um complemento que você abriu de dentro de um produto, quando ele também está em outros produtos. A janela lista esses produtos. **Sim, editar** grava a mudança, que vale para todos eles; **Cancelar** volta para a edição sem gravar. A lista conta só produtos: categorias e tamanhos de pizza que usam o complemento não entram.

Fora de um produto (na aba **Complementos**, na **Lista de complementos** ou numa pizza), o topo da janela mostra **Produtos usando este complemento:**, com o nome de cada produto que usa o complemento.

### Duplicar

Só aparece ao editar um complemento que já existe. Abre a janela **Duplicar complemento**, com o campo **Nome do novo complemento**, que já vem com o nome atual seguido de **(cópia)**. **Duplicar** cria a cópia; **Cancelar** desiste.

* A cópia leva o tipo, as quantidades, o status e as opções, com preço, **Código PDV**, descrição e foto.
* A cópia sai do que está na janela naquele momento, inclusive mudanças que você ainda não salvou. O complemento original fica como estava da última vez que foi salvo.
* A **Opção pré definida** não vai para a cópia. Escolha de novo nela, se precisar.
* Deu certo: aparece **Variação duplicada com sucesso!** e a janela do complemento fecha. Deu errado: aparece **Erro ao duplicar variação!**.
* Onde a cópia aparece: na aba **Complementos**, no topo da lista; dentro de um produto, a cópia já entra no produto, junto com o original; na **Lista de complementos**, ela já vem marcada.

## Delivery e Presencial

<Badge>Em liberação</Badge>

Esta parte está em liberação: só aparece nas lojas liberadas para o pedido na mesa e com a opção [Aceitar pedidos na mesa (QR Code)](/funcionalidades/administrar-loja/dados-da-loja#aceitar-pedidos-na-mesa-qr-code) ligada. Nessas lojas, o status do complemento e o de cada opção ganham o canal **Presencial**, junto do **Delivery**, e cada opção ganha um segundo preço. O canal funciona como no [produto](/funcionalidades/editor-de-cardapio/produtos#presencial).

**Presencial** vale para o pedido feito na mesa. **Delivery** vale para todos os outros pedidos.

* **Status:** os dois canais têm **Ativo**, **Inativo** e **Em falta**. Nesta janela, mudar o **Delivery** não muda o **Presencial**. O ícone de seta circular ao lado de **Presencial**, **Voltar a herdar do Delivery**, faz o Presencial voltar a seguir o Delivery.
* **Preço da opção:** enquanto você não digita um preço no Presencial, o campo mostra o preço do Delivery em cinza, e é esse o preço cobrado na mesa. Ao digitar, a opção passa a ter preço próprio na mesa. O ícone **Voltar a herdar do Delivery**, ao lado do campo, volta a usar o preço do Delivery.
* **Chave da lista:** desligar pela [chave](#ligar-e-desligar) desliga o complemento ou a opção nos dois canais. Ligar de novo reativa só o Delivery: se o Presencial tinha status próprio, ele continua desligado até você mudar na janela do complemento.

## Complementos no produto e na pizza

Dentro de um produto, na seção **Complementos / Adicionais**, e na aba **Complementos** de uma categoria de pizza, você escolhe quais complementos da loja aparecem ali. Onde fica cada seção está em [Produtos](/funcionalidades/editor-de-cardapio/produtos#adicionar-complemento) e [Pizzas](/funcionalidades/editor-de-cardapio/pizzas#complementos). A escolha só vale depois que você salva o produto, em **Salvar produto**, ou a pizza, em **Salvar alterações**.

### Adicionar complemento

Abre a janela **Lista de complementos**, com todos os complementos da loja. Marque a caixa dos complementos que devem aparecer e clique em **Pronto**. Desmarcar tira o complemento daqui, sem apagar.

* **Novo complemento** cria um complemento na hora, e ele volta para a lista já marcado.
* Na janela também dá para pesquisar, editar e apagar complementos, como na [aba Complementos](#aba-complementos). Apagar aqui apaga o complemento da loja.
* No celular, os botões **Novo complemento** e **Pronto** ocupam a largura da tela.

### Complementos do produto ou da pizza

Os complementos escolhidos aparecem em lista, na ordem em que o cliente vê. Sem nenhum, aparece **Nenhum complemento adicionado**.

* Arraste pelo ícone de arrastar para mudar a ordem.
* A [chave](#ligar-e-desligar) liga e desliga o complemento na hora, em todos os produtos e pizzas.
* O lápis, ou um clique no cartão, abre **Editar complemento**. Num produto, se o complemento também está em outros produtos, ao salvar aparece [Complemento em uso](#complemento-em-uso).
* A lixeira tira o complemento só deste produto ou deste bloco da pizza: confirme em **Remover**, na janela **Remover complemento**. O complemento continua na loja.

## Na busca do editor

### Chave das opções

Quando você digita em **Buscar produtos e complementos...**, no topo do editor, os [resultados da busca](/funcionalidades/editor-de-cardapio/produtos#resultados-da-busca) mostram cada produto com os complementos dele e, embaixo de cada complemento, as opções que batem com a busca. Cada opção tem uma chave que liga e desliga só aquela opção, na hora, em todos os produtos e pizzas que usam o complemento.

* A opção desligada ou em falta aparece com **(Inativo)** ou **(Em falta)** e fundo cinza.
* O complemento tem a própria [chave](#ligar-e-desligar), no cartão acima das opções.
* No celular, a descrição da opção não aparece nos resultados.

## Como fazer

### Criar um complemento e colocar num produto

<Steps>
  <Step title="Abra o produto">
    Em **Editor de cardápio**, abra o produto e vá até a seção **Complementos / Adicionais**. Veja [Produtos](/funcionalidades/editor-de-cardapio/produtos#adicionar-complemento).
  </Step>

  <Step title="Abra a lista de complementos">
    Clique em [Adicionar complemento](#adicionar-complemento). Se o complemento já existe, marque a caixa dele e vá direto para o último passo.
  </Step>

  <Step title="Crie o complemento">
    Clique em **Novo complemento**, escolha o tipo e preencha o [Título da variação](#t%C3%ADtulo-da-varia%C3%A7%C3%A3o). Na **Opção múltipla** e na **Opção somável**, preencha também a [Quantidade para escolha](#quantidade-para-escolha).
  </Step>

  <Step title="Cadastre as opções">
    Em cada opção, preencha o [Nome da opção](#nome-da-op%C3%A7%C3%A3o) e o preço. Use **Adicionar nova opção** para incluir outras. Clique em **Salvar complemento**: ele volta para a lista já marcado.
  </Step>

  <Step title="Confirme e salve o produto">
    Clique em **Pronto** e depois em **Salvar produto**.
  </Step>
</Steps>

### Cobrar por adicional que o cliente pode repetir

<Steps>
  <Step title="Escolha Opção somável">
    Na aba **Complementos**, clique em [Novo complemento](#novo-complemento) e marque **Opção somável**.
  </Step>

  <Step title="Defina o total">
    Em [Quantidade para escolha](#quantidade-para-escolha), deixe o mínimo em 0 e ponha no máximo o total de unidades que o cliente pode pedir, somando todas as opções.
  </Step>

  <Step title="Cadastre os adicionais">
    Em cada opção, preencha o nome e o preço de uma unidade. Se um adicional tem limite próprio, abra a opção e preencha a [Quantidade máxima dessa opção](#quantidade-m%C3%A1xima-dessa-op%C3%A7%C3%A3o).
  </Step>

  <Step title="Salve e ligue aos produtos">
    Clique em **Salvar complemento** e ligue o complemento aos produtos com [Adicionar complemento](#adicionar-complemento).
  </Step>
</Steps>

### Tirar uma opção do cardápio por um tempo

<Steps>
  <Step title="Busque a opção">
    No topo do editor, digite o nome da opção em **Buscar produtos e complementos...**.
  </Step>

  <Step title="Desligue a chave da opção">
    A opção sai do cardápio na hora, em todos os produtos e pizzas que usam o complemento. Veja [Chave das opções](#chave-das-op%C3%A7%C3%B5es).
  </Step>

  <Step title="Ligue de novo quando voltar">
    Busque a opção outra vez e ligue a chave.
  </Step>
</Steps>

## Dúvidas frequentes

<AccordionGroup>
  <Accordion title="Mudei um complemento e ele mudou em outros produtos. Por quê?">
    Cada complemento existe uma vez só na loja: todos os produtos e pizzas que usam ele mostram a mesma versão. Para ter uma versão diferente num produto, use [Duplicar](#duplicar), ajuste a cópia e troque o original pela cópia nesse produto.
  </Accordion>

  <Accordion title="Por que o complemento não aparece no cardápio?">
    Confira se ele está marcado no produto e se o produto foi salvo, se o complemento está **Ativo** e se ele tem pelo menos uma opção **Ativo**. Complemento **Inativo**, **Em falta** ou sem nenhuma opção ativa não aparece. Veja [Ativo, Inativo e Em falta](#ativo-inativo-e-em-falta).
  </Accordion>

  <Accordion title="Qual a diferença entre remover e apagar um complemento?">
    Remover, pela lixeira dentro do produto ou da pizza, tira o complemento só dali. Apagar, pela lixeira da aba **Complementos** ou da **Lista de complementos**, apaga o complemento da loja e tira ele de todos os produtos e pizzas. Veja [Editar e apagar](#editar-e-apagar).
  </Accordion>

  <Accordion title="Como deixo um complemento obrigatório?">
    Na **Opção única**, marque [Tornar essa variação obrigatória](#tornar-essa-varia%C3%A7%C3%A3o-obrigat%C3%B3ria). Na **Opção múltipla** e na **Opção somável**, ponha um mínimo maior que 0 em [Quantidade para escolha](#quantidade-para-escolha).
  </Accordion>

  <Accordion title="Complemento e variação são a mesma coisa?">
    Sim. A aba e os botões falam em complemento, e alguns campos e avisos falam em variação, como **Título da variação**.
  </Accordion>
</AccordionGroup>

## Relacionados

<CardGroup cols={2}>
  <Card title="Produtos" href="/funcionalidades/editor-de-cardapio/produtos">
    Ligue complementos a cada produto na seção Complementos / Adicionais.
  </Card>

  <Card title="Pizzas" href="/funcionalidades/editor-de-cardapio/pizzas">
    Ponha complementos em todos os tamanhos da pizza ou só em um.
  </Card>

  <Card title="Estoque" href="/funcionalidades/editor-de-cardapio/estoque">
    Controle o estoque das opções pelo Código PDV.
  </Card>

  <Card title="Configurações do atendimento" href="/funcionalidades/atendimento/configuracoes">
    Ligue o Pedido conversacional e use a Opção pré definida.
  </Card>
</CardGroup>
