> For the complete documentation index, see [llms.txt](https://ajuda.pdvlegal.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.pdvlegal.com.br/integracoes/autoatendimento-food/produtos-e-modificadores-no-autoatendimento-food.md).

# Produtos e modificadores no Autoatendimento Food

{% hint style="danger" %}

#### Pré-requisitos:

* Módulos do autoatendimento **ativados** (veja [**Ativação de módulos**](/integracoes/autoatendimento-food/ativacao-de-modulos.md)).
* [Produtos cadastrados no **PDV Legal**](/retaguarda/produtos/cadastro-de-produtos.md) (Retaguarda Cloud).
* Imagens dos produtos em formato `.jpg`/`.png` (até 2MB).
  {% endhint %}

{% hint style="warning" %}
É possível realizar a cópia de produtos/modificadores de uma base antiga para uma outra base nova. Caso necessite abra um chamado de solicitação no suporte.

Obs: Só é realizado este processo apenas 1 vez na base de destino e a mesma precisa ser nova, ou seja, sem nada cadastrado.
{% endhint %}

## Configurar produtos e modificadores

{% stepper %}
{% step %}

### **Cadastrar Produtos no PDV Legal**

* Acesse **Retaguarda Cloud > Produtos > Novo+**.

<figure><img src="/files/nEJnxs7B23EXmo8Iq41a" alt=""><figcaption></figcaption></figure>

* Na aba "Obrigatório, preencha:
  * *Descrição cupom*: Nome do produto (ex: "Spaghetti com Frango").
  * *Grupo*: Categoria (ex: "Pratos Principais").
* Na aba "Configurações"
  * O produto precisará estar marcado como: Autoatendimento = Sim.
* Na aba: Preços, Impostos e Modificadores, preencha:
  * *Valor*: Preço de venda.
  * *Código NCM/CEST*: Para emissão fiscal (se aplicável).

<figure><img src="/files/TFrq7bixUfLitI6a1vOq" alt=""><figcaption></figcaption></figure>

* Na aba **Autoatendimento**:
  * Faça upload da imagem (formato: `.jpg`/`.png`, até 2MB).
  * Clique em **Gravar**.

<figure><img src="/files/8LJYz5YURkEfdEoDrgrF" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Sincronizar Produtos no Autoatendimento**

* Acesse a retaguarda do Autoatendimento Food:
  * Login: `[Código da Filial]@aa.com`
  * Senha: `[Código da Filial]@123`
* Navegue até **Sincronizar Cardápio > Produtos**.
* Aparecerá um Pop-up para a sincronização:

  * Selecione a Opção "**Trazer imagem do PDV**" para sincronizar a imagem direto da Gestão Legal (Retaguarda Cloud)
  * Selecione "**Sincronizar o nome dos produtos**" para sincronização dos produtos cadastrados.
  * Confirme a atualização dos Grupos e Produtos, clicando em: **Sim**

  <figure><img src="/files/ni9mTdGqpWsHhVuJBPhl" alt=""><figcaption></figcaption></figure>
* Verifique se os produtos cadastrados aparecem com:
  * Nome
  * Preço
  * Disponibilidade
  * Link da imagem
    {% endstep %}

{% step %}

### **Configurar produtos**

* Acesse **Produtos**
* Clique em: **Editar (ícone de lápis)**.
* Personalize:
  * *Ordem*: Posição na tela (ex: 1 = primeiro grupo).
  * *Descrição*: Informe detalhes do item. A descrição aparece após selecionar o produto.
  * *Imagem*: Faça upload, informe um link público ou escolha uma imagem disponível.
  * *Grupo de Produto*: Informe em quais grupos os produtos aparecerão.
  * *Produto Visível*: Marque para exibir no autoatendimento.
  * *Controlar estoque*: Ative para controlar a disponibilidade no totem.
    * Informe o saldo inicial.
    * Cada venda reduz esse saldo.
    * Ao chegar a zero, o item fica indisponível.

<figure><img src="/files/37aXNvy5dEdmBd4pQkm4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Configurar Grupo de Produtos**

* Acesse **Grupo de Produtos**
* Clique em: **Editar (ícone de lápis)**.
* Personalize:
  * *Nome do grupo*
  * *Ordem*: Posição na tela (ex: 1 = primeiro grupo).
  * *Imagem*: Insira o link da imagem (ex: copie do produto).
  * *Grupo Visível*: Marque para exibir no autoatendimento.
  * *Mostrar Nome do grupo:* Sim ou Não
  * *Grupo de combos*: Ative quando o grupo compor um combo.
  * *Exibir valor dos produtos*: Defina se os itens somam ao valor base do combo.
  * *Seleção múltipla*: Ative quando o cliente puder escolher vários itens.
  * *Quantidade mínima e máxima*: Defina os limites de escolha do grupo.
  * *Mensagem*: Inclua uma orientação para a escolha, se necessário.

![](/files/2o4x1xsN4uQaXBWOUJmH)
{% endstep %}

{% step %}

### **Criar Modificadores**

{% hint style="info" %}
Os **modificadores** são opções adicionais que permitem ao cliente personalizar um pedido de acordo com suas preferências. Eles ajudam a oferecer uma experiência mais flexível e alinhada ao gosto do consumidor.

#### **Exemplo:**

Imagine um hambúrguer no cardápio. Com os modificadores, o cliente pode escolher:\
🍔 **Ponto da carne**: malpassada, ao ponto ou bem-passada.\
🧀 **Adicionais**: queijo cheddar, mussarela ou gorgonzola.\
🌶️ **Remover ingredientes**: sem cebola, sem picles, sem pimenta.

Os modificadores garantem mais controle para o cliente e tornam a experiência de compra mais dinâmica e personalizada!
{% endhint %}

#### **Passo 1: Modificadores individuais**

* Acesse **Complementos** e clique em **+**.
* Preencha:
  * *Nome*: Ex.: “Adicional de queijo”.
  * *Ordem*: Define a posição do modificador na tela.
  * *Preço*: Informe o adicional ou mantenha zero.
  * *Quantidade máxima*: Limita unidades daquele modificador.
  * *Descrição*: Opcional. Aparece para o cliente.
  * *Visível*: Define se o item aparece na seleção.
  * *Selecionado*: Pré-seleciona o item ao abrir o produto.
* Vincule o modificador a grupos existentes, se necessário.
* Clique em **Confirmar**.

{% hint style="info" %}
Use **Selecionado** para escolhas mais comuns. Por exemplo, “sem pimenta”. O cliente ainda pode alterar a seleção.
{% endhint %}

<figure><img src="/files/vG1O8NloyYLvfCnygEll" alt=""><figcaption></figcaption></figure>

#### **Passo 2: Grupos de modificadores**

* Acesse **Grupo de Modificadores > +**.
* Configure:
  * *Título*: Ex: "Personalize seu prato".
  * *Ordem*: Se ela será o primeiro, segundo, terceiro, etc.
  * *Descrição*: Opcional. Aparece para o cliente.
  * *Exibição*: Escolha o formato mais adequado à seleção.
  * *Qtd. Mín/Máx*: Defina se a escolha é opcional, obrigatória ou limitada.

{% tabs %}
{% tab title="Check" %}

<figure><img src="/files/mLAt8kXprzau4XcZxIhC" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Radio" %}

<figure><img src="/files/GYtb4WZkWAMcxNALPAYW" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Quantity" %}

<figure><img src="/files/jjL6nqdfYpkSuvRJcUyB" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Button" %}

<figure><img src="/files/Q7jpJyaZKvWPdmW9sYin" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

* Vincule os modificadores criados ao grupo.
  * Selecione os itens desejados no botão **+**.
  * Retorne e clique em **Confirmar**.
* Você também pode vincular o grupo a vários produtos nessa mesma configuração.

<figure><img src="/files/w6h3xmR1qCgqBD9ubQtU" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Vincular Modificadores aos Produtos**

* Retorne à **tela inicial** da retaguarda do atendimento food.
* Clique em **Complementos > Adicionar Grupos e Complementos**.

<figure><img src="/files/BnKutsBg1njVdBkliAf9" alt=""><figcaption></figcaption></figure>

* Selecione os grupos de modificadores desejados.

<figure><img src="/files/8mcavcfVK1iXP3Q3HnBz" alt=""><figcaption></figcaption></figure>

<mark style="background-color:blue;">Exemplo da tela final:</mark>

<figure><img src="/files/K3Qdh21P9rfgdsNIEBAC" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Estoque no Autoatendimento Food

O estoque do Autoatendimento Food controla a disponibilidade exibida no totem.

Ative **Controlar estoque** no produto e informe a quantidade disponível. Cada venda reduz esse saldo. Ao chegar a zero, o produto fica indisponível.

{% hint style="warning" %}
Esse controle é independente do saldo da Retaguarda Cloud. Alterações de estoque no PDV Legal não atualizam o totem em tempo real. Atualize a quantidade no Autoatendimento Food quando o item for reposto.
{% endhint %}

***

## <mark style="background-color:red;">Resolver problemas comuns</mark>

{% hint style="danger" %}

* **Problema:** Produto não aparece após sincronização.

**Solução:** Verifique se o produto está vinculado a um grupo visível.

* **Problema:** Imagem não carrega no autoatendimento.

**Solução:** Redimensione a imagem (formato: 500x500 pixels).

* **Problema:** Modificadores não são exibidos.

**Solução:** Confira se o grupo de modificadores está vinculado ao produto.

* **Problema:** Produto esgotado continua disponível no totem.

**Solução:** Atualize o controle de estoque ou desmarque **Produto Visível** no Autoatendimento Food.
{% endhint %}

***

## <mark style="background-color:green;">Dicas rápidas</mark>

{% hint style="success" %}

* **Imagens**: Use fundo branco para destacar os produtos.
* **Atualização**: Sincronize o cardápio após cada alteração.
* **Teste**: Realize um pedido-teste para validar modificadores.
  {% endhint %}

***

### Manuais relacionados

* [O que é o Autoatendimento Food?](/integracoes/autoatendimento-food.md)
* [Sugestão de produtos no Autoatendimento Food](/integracoes/autoatendimento-food/sugestao-de-produtos-no-autoatendimento-food.md)
* [Combos e subprodutos no Autoatendimento Food](/integracoes/autoatendimento-food/combos-e-subprodutos-no-autoatendimento-food.md)
* [Como cadastrar produtos?](/retaguarda/produtos/cadastro-de-produtos.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.pdvlegal.com.br/integracoes/autoatendimento-food/produtos-e-modificadores-no-autoatendimento-food.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.