> 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-tokmenu/novo-painel-do-autoatendimento-food-tokmenu.md).

# Novo painel do Autoatendimento Food (TokMenu)

Conheça o novo painel de gestão do Autoatendimento Food: acesso, vendas, cardápio, terminais, KDS, formas de pagamento e configurações da loja.

O novo painel do **Autoatendimento Food** é onde você configura o totem (produtos, preços, categorias e formas de pagamento), acompanha as vendas e mantém a operação da loja em dia.

Tudo o que você ajusta neste painel aparece no totem de autoatendimento da loja.

Em relação à retaguarda anterior, o painel mantém todas as funcionalidades e traz navegação mais simples, perfis de acesso separados para a loja e para a gestão e novas opções para agilizar o cadastro, como **Duplicar** e **Replicar para lojas**.

{% hint style="info" %}
Este manual vale para as lojas que usam o **novo painel**. Se a loja ainda usa a retaguarda anterior do Autoatendimento Food, siga os manuais do [passo a passo de ativação](https://ajuda.pdvlegal.com.br/integracoes/autoatendimento-food).
{% endhint %}

## 1. Entrar no painel

Acesse o painel pelo endereço `https://pdvlegal.tokmenu.com.br`.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F7tU5tOwp1asPrzjLGMEb%2Ftokmenu-01-login.png?alt=media&amp;token=405fc89b-1658-4984-9806-96e950024ccb" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Em **Usuário**, digite o seu e-mail.
{% endstep %}

{% step %}
Em **Senha**, digite a sua senha.
{% endstep %}

{% step %}
Clique em **Entrar**.

Se o seu usuário tiver acesso a mais de uma loja, o painel pede para você escolher com qual loja quer trabalhar. Com uma única loja, você entra direto.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Os usuários são criados com uma **senha padrão**. Depois do primeiro acesso, troque a senha na tela **Trocar Senha**.

**Esqueceu a senha?** Peça a um administrador para redefinir.
{% endhint %}

***

## 2. Conhecendo a tela e os perfis de acesso

Depois de entrar, a tela se divide em duas partes:

* **Menu lateral (à esquerda)** — logotipo e nome da loja no topo, lista de funcionalidades no meio e botão **Sair** embaixo.
* **Área principal (à direita)** — conteúdo da funcionalidade escolhida.

### Perfis de acesso

O que aparece no menu depende do perfil do usuário:

* **Perfil Loja** — criado automaticamente junto com a loja. É o usuário que fica logado no totem. Tem um menu reduzido, com telas do dia a dia como **Visibilidade**, e não altera dados cadastrais. Isso evita mudanças que afetem o funcionamento do totem.
* **Perfil Gerenciamento** — dá acesso à gestão completa: produtos, categorias, modificadores, terminais, formas de pagamento e configurações. É criado à parte para quem administra as lojas.

{% hint style="success" %}
**Várias lojas no mesmo usuário:** um usuário de gerenciamento pode reunir todas as lojas sob responsabilidade de um canal ou de uma franquia. Assim, não é preciso trocar de usuário para atender cada loja.
{% endhint %}

### Trocar de loja

{% stepper %}
{% step %}
Clique no nome da loja, no topo do menu lateral.
{% endstep %}

{% step %}
Na janela que abrir, selecione a loja desejada.

A janela lista todas as lojas vinculadas ao seu usuário.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Com o mesmo login, você também pode abrir lojas diferentes em abas diferentes do navegador. Isso ajuda a comparar ou copiar informações de uma loja para outra.
{% endhint %}

Para encerrar a sessão, clique em **Sair**, no rodapé do menu.

***

## 3. Dashboard

É a primeira tela ao entrar no painel. Mostra um resumo rápido da operação.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2Ftk7vZ8RR9ARRA3rt0tY6%2Ftokmenu-03-dashboard.png?alt=media&amp;token=c3837089-e104-47c4-8698-6c5bc210378a" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Escolha o período

Por padrão, o Dashboard abre com os **últimos 30 dias**.

Para mudar, selecione **Hoje**, **7 dias**, **30 dias** ou informe um intervalo personalizado nos campos de data.

Os números se atualizam sozinhos. O painel exibe **Atualizado há Agora**.
{% endstep %}

{% step %}

### Leia os cartões

* **Total Vendas** — faturamento no período.
* **Pedidos** — quantidade de pedidos.
* **Ticket Médio** — valor médio por pedido.
* **Cancelados** — pedidos cancelados.
  {% endstep %}

{% step %}

### Analise os gráficos

* **Vendas Diárias** — evolução de quantidade e valor, dia a dia.
* **Vendas por Local** — proporção entre consumo no local e para levar.
* **Vendas por Forma de Pagamento** — quanto entrou por dinheiro, cartão, PIX e demais formas.
* **Produtos mais vendidos** — ranking dos itens com mais saída no período.
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}
Use o **Dashboard** para a leitura rápida do dia. Para analisar vendas específicas, use a tela **Vendas**.
{% endhint %}

***

## 4. Vendas

Lista os pedidos da loja em um período e permite acompanhar as vendas em tempo real.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FAIM7fT876IctYJEbb51b%2Ftokmenu-04-vendas.png?alt=media&amp;token=e1110b2d-a521-4960-85ff-e57d67837d5f" alt=""><figcaption></figcaption></figure>

### Como a venda chega ao PDV Legal

1. O cliente finaliza o pedido e o pagamento no totem.
2. A venda é enviada para o **PDV Legal (Gestão Legal)**.
3. Se a venda é fiscal, o PDV Legal devolve a **NFC-e**, que é impressa no totem.

### Consultar as vendas

{% stepper %}
{% step %}
No menu lateral, clique em **Vendas**.
{% endstep %}

{% step %}
Informe a **Data Início** e a **Data Fim**.
{% endstep %}

{% step %}
Clique em **Buscar**.

A cada busca, o painel traz as vendas atualizadas, inclusive as que acabaram de acontecer.
{% endstep %}

{% step %}
Clique na venda para abrir o detalhe.

O detalhe mostra os produtos vendidos, as formas de pagamento e, se houver, a indicação de problema. Quando necessário, atualize o status do pedido.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Se o painel exibir **Nenhum pedido encontrado**, ajuste as datas e busque novamente.
{% endhint %}

### Resolver falhas de envio ou de NFC-e

Quando houver problema no envio da venda ao PDV Legal ou no retorno da NFC-e, aparece um **ícone de alerta** na frente da venda.

{% stepper %}
{% step %}
Clique no ícone de alerta para ver qual foi o problema.

Exemplo: a nota fiscal não retornou porque a Sefaz estava instável.
{% endstep %}

{% step %}
Abra o detalhe da venda.
{% endstep %}

{% step %}
Use o botão exibido no detalhe para:

* **reenviar a venda**, se ela não chegou ao PDV Legal; ou
* **buscar a nota fiscal novamente**, se a NFC-e não retornou.
  {% endstep %}
  {% endstepper %}

***

## 5. Pedidos KDS

Para lojas que usam KDS (monitor da cozinha). Mostra, no painel, tudo o que está sendo produzido.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F900vjwhyNP8I8KR0VS5s%2Ftokmenu-05-pedidos-kds.png?alt=media&amp;token=d09bdebe-d070-4295-a49f-0c8b0f7e98c7" alt=""><figcaption></figcaption></figure>

Assim que o cliente conclui o pagamento no totem, o pedido entra no KDS e segue o fluxo da cozinha: **em preparo**, **pronto** e **finalizado**.

{% stepper %}
{% step %}
No menu lateral, clique em **Pedidos KDS**.
{% endstep %}

{% step %}
Preencha os filtros:

* **Data** — dia dos pedidos.
* **Nº Pedido** — para localizar um pedido específico.
* **Status** — todos ou um status específico.
* **Terminal KDS** — monitor de cozinha.
  {% endstep %}

{% step %}
Clique em **Buscar**.

Para zerar os filtros, clique em **Limpar**.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Quando o cliente pergunta no balcão "como está o meu pedido?", a equipe consulta o status e a posição na fila por aqui, sem precisar ir até a cozinha.
{% endhint %}

***

## 6. Visibilidade

Controla, de forma rápida, quais produtos aparecem no totem, sem precisar editar o produto inteiro.

Esta tela está disponível também no **Perfil Loja**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FHUdX5yGql4q4Fq3soZwm%2Ftokmenu-06-visibilidade.png?alt=media&amp;token=a2dc630f-f95d-4ae2-b6c5-47f6e49588fb" alt=""><figcaption></figcaption></figure>

Cada linha é um produto, com imagem, código, nome, preço e categoria. À direita fica a chave **Visível**:

* **Verde (ligada)** — o produto aparece no totem.
* **Cinza (desligada)** — o produto fica escondido.

{% stepper %}
{% step %}
No menu lateral, clique em **Visibilidade**.
{% endstep %}

{% step %}
Localize o produto pelos campos **Filtrar** do cabeçalho (código, nome, preço ou categoria).
{% endstep %}

{% step %}
Clique na chave **Visível** para ligar ou desligar.

O botão **Atualizar** recarrega a lista.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Ideal para quando um item acaba no meio do expediente. Exemplo: acabou o cappuccino. Desligue a visibilidade e ele some do totem na hora. Para repor, ligue de novo.
{% endhint %}

***

## 7. Estoque

Controla a quantidade disponível de produtos **no totem**.

{% hint style="warning" %}
**Importante:** este estoque é um controle local do autoatendimento. Ele **não** é o estoque do PDV Legal.
{% endhint %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FD32pMJISnPlozDdq8OUD%2Ftokmenu-07-estoque.png?alt=media&amp;token=727bca2c-70af-44df-8645-21aff4dc6434" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
No menu lateral, clique em **Estoque**.
{% endstep %}

{% step %}
Se quiser, busque o produto por nome ou código.
{% endstep %}

{% step %}
Digite a quantidade disponível na coluna **Estoque**.

Você pode ajustar vários produtos antes de salvar.
{% endstep %}

{% step %}
Clique em **Salvar**.

A cada venda no totem, a quantidade diminui. Ao zerar, o totem exibe o produto como **temporariamente indisponível**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Exemplo:** a loja produz 20 salgados por manhã. No início da operação, informe `20`. O totem vende até 20 unidades e depois sinaliza o item como indisponível. Isso evita que o cliente pague por um produto que já acabou no balcão.
{% endhint %}

***

## 8. Produtos

Aqui você cadastra e edita os produtos vendidos no totem.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F31iSkna8KKpYbInJxnNQ%2Ftokmenu-08-produtos.png?alt=media&amp;token=debec710-728c-452c-8d0d-595c9dc65cc7" alt=""><figcaption></figcaption></figure>

A lista mostra, para cada produto: **prioridade** (ordem de exibição), **código**, **imagem**, **nome**, **descrição**, **unidade**, **preço**, se está **visível** e a **categoria**.

Use os campos **Filtrar** no cabeçalho de cada coluna para buscar por nome, código, valor ou categoria. Clique no título da coluna para ordenar. A lista é paginada: use as setas do rodapé para navegar.

**Ações disponíveis:**

* **Adicionar Produto** — cadastra um novo produto.
* **Editar** (ícone de lápis) — abre o cadastro completo do produto.
* **Sincronizar Produtos** — atualiza a lista a partir do PDV Legal.
* **Exportar CSV** — baixa a lista de produtos em planilha.

### 8.1. Dados do produto

Ao editar um produto, a primeira aba traz os dados principais:

* **Nome** — nome exibido no totem.
* **Código externo** — código do produto no PDV Legal. É ele que liga o produto do totem ao PDV Legal.
* **Descrição** — texto que descreve o produto. Aparece no totem quando o layout é **Minimalista**.
* **Descrição 2** — a mesma descrição em um segundo idioma. O totem pode funcionar em dois idiomas, como português e espanhol ou português e inglês.
* **Prioridade** — ordem de exibição no totem. Números menores aparecem primeiro.
* **Preço** — valor do produto.
* **Categorias** — em quais categorias o produto aparece. Um mesmo produto pode estar em mais de uma categoria.
* **Imagem** — cole a URL da imagem ou abra a **galeria de imagens** para escolher.
* **Texto para valor** — texto exibido antes do preço. Exemplo: `A partir de`, para produtos cujo valor muda conforme o cliente personaliza.
* **Visível** — define se o produto aparece no totem.
* **É combo / contém subprodutos** e **Combo especial** — veja o item 8.3.

{% hint style="info" %}
**Prioridade:** produtos com a mesma prioridade (por exemplo, todos com `0`) aparecem na ordem definida pelo sistema. Para destacar um produto, use um número menor que o dos demais. Para levar um produto para o fim da lista, use um número alto, como `99`.
{% endhint %}

{% hint style="success" %}
**Mais de uma categoria:** use para montar vitrines. Exemplo: o produto fica em **Burgers** e também em **Mais vendidos**.
{% endhint %}

### 8.2. Modificadores do produto

No cadastro do produto, vincule os grupos de modificadores que o cliente vai responder. Exemplo para um sanduíche: **Ponto da carne**, **Adicionais**, **Peça mais um + combo** e **Remoção**.

Cada grupo vinculado tem uma **prioridade**, que define a ordem em que aparece para o cliente. Exemplo: primeiro o ponto da carne, depois os adicionais e, por último, a remoção.

Para criar os grupos e as opções, veja o item **11. Modificadores**.

### 8.3. Combos

Há duas formas de montar combos.

**É combo / contém subprodutos**

O cliente toca em um produto e o totem lança automaticamente vários itens no carrinho.

{% stepper %}
{% step %}
Marque **É combo / contém subprodutos**.
{% endstep %}

{% step %}
Na área de **subprodutos**, adicione os produtos que compõem o combo.

Exemplo: o combo nº 1 lança um sanduíche, uma batata média e um refrigerante médio.
{% endstep %}
{% endstepper %}

**Combo especial**

O cliente monta o combo em etapas, escolhendo um item de cada grupo.

{% stepper %}
{% step %}
Marque **Combo especial**.
{% endstep %}

{% step %}
Selecione as **categorias** que serão as etapas do combo.

Exemplo: **Burgers**, **Molhos** e **Refri e Sucos**.
{% endstep %}

{% step %}
No totem, ao escolher o combo, o cliente passa por cada etapa: "Selecione o seu hambúrguer", "Selecione o seu molho", "Selecione a bebida".

A mensagem, as quantidades e a cobrança de cada etapa são configuradas na categoria. Veja o item **9.2. Categorias usadas em combo especial**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Diferença:** em **contém subprodutos**, os itens entram prontos no carrinho. Em **combo especial**, o cliente escolhe cada item.
{% endhint %}

### 8.4. Duplicar e Replicar para lojas

Os botões **Duplicar** e **Replicar para lojas** estão disponíveis em **Produtos** e em **Categorias**.

* **Duplicar** — cria uma cópia completa na mesma loja, inclusive com os modificadores vinculados. A cópia recebe a indicação `Copy` no nome. Depois, ajuste nome, código, preço e o que mais mudar.
* **Replicar para lojas** — copia o produto ou a categoria para outras lojas vinculadas ao seu usuário.

{% hint style="success" %}
**Exemplos:**

* Você configurou um X-Burger com todas as etapas e modificadores e vai cadastrar mais cinco lanches parecidos: duplique e altere só o que muda.
* Uma franquia com várias lojas e o mesmo cardápio: monte o produto em uma loja e replique para as demais.
  {% endhint %}

{% hint style="info" %}
A lista de lojas em **Replicar para lojas** mostra apenas as lojas vinculadas ao seu usuário.
{% endhint %}

***

## 9. Categorias

As categorias agrupam os produtos no totem. Exemplos: Burgers, Bebidas, Sobremesas.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FHsJxa5LOO95etDpN0mOJ%2Ftokmenu-09-categorias.png?alt=media&amp;token=337d2e5e-028a-48dd-ac52-eda0877eb15f" alt=""><figcaption></figcaption></figure>

Cada linha mostra: **prioridade** (ordem no totem), **código**, **imagem**, **nome**, **descrição**, **nível**, **categoria pai** e se está **visível**.

**Ações disponíveis:**

* **Adicionar Categoria** — cria uma categoria nova.
* **Editar** (ícone de lápis) — abre o cadastro da categoria.
* **Excluir** (ícone de lixeira) — remove a categoria.
* **Duplicar** e **Replicar para lojas** — veja o item 8.4.

### 9.1. Dados da categoria

* **Nome**, **Código externo** e **Prioridade** — identificação e ordem de exibição.
* **Nível** — define se a categoria é **principal** ou **secundária** (subcategoria).
* **Categoria pai** — para subcategorias, indica dentro de qual categoria principal ela aparece.
* **Visível** — define se a categoria aparece no totem.
* **Exibir nome embaixo da imagem** — mostra o nome da categoria abaixo da imagem.
* **Imagem** — imagem da categoria no totem.

{% hint style="info" %}
**Categorias principais e subcategorias:** as categorias principais aparecem na barra lateral do totem. As subcategorias aparecem quando o cliente entra na principal.

Exemplo: a categoria principal **Bebidas** abre as subcategorias **Refrigerantes**, **Sucos** e **Cervejas**. O cliente entra em **Refrigerantes** e vê só os refrigerantes. Ele pode voltar a qualquer momento.
{% endhint %}

{% hint style="success" %}
**Exibir nome embaixo da imagem:** se a imagem da categoria já traz o nome escrito, desmarque esta opção. Assim o nome não aparece duas vezes.
{% endhint %}

### 9.2. Categorias usadas em combo especial

Os campos abaixo só têm efeito quando a categoria é usada como etapa de um **Combo especial**:

* **Mensagem** — texto exibido ao cliente na etapa. Exemplo: `Selecione o molho desejado`.
* **Quantidade mínima** e **Quantidade máxima** — quantos itens o cliente deve escolher. Exemplo: mínimo `2` e máximo `2` obriga a escolha de dois hambúrgueres.
* **Múltipla seleção** — permite escolher mais de um item na etapa. Desmarcada, o cliente escolhe apenas um.
* **Exibir valor dos produtos** — define se os itens da etapa são cobrados à parte:
  * **desmarcado** — o valor fica embutido no preço do combo;
  * **marcado** — o valor do item escolhido é exibido e somado ao combo.

{% hint style="info" %}
**Exemplo:** crie uma categoria **Molho incluso**, com **Exibir valor dos produtos** desmarcado e máximo `1`. O cliente escolhe um molho sem custo. Depois, crie a categoria **Molho adicional**, com **Exibir valor dos produtos** marcado. O molho escolhido nessa etapa é cobrado.
{% endhint %}

{% hint style="warning" %}
**Regra do totem:** todo valor que aparece na tela é somado ao pedido. Se o valor não aparece, não é cobrado.
{% endhint %}

***

## 10. Cardápios

Sem cardápio configurado, o totem exibe todas as categorias e produtos marcados como **Visível**, o tempo todo.

Use os cardápios para exibir categorias apenas em **dias da semana** e **horários** definidos.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FnLZZpbtmYFbypfQVLtOE%2Ftokmenu-10-cardapios.png?alt=media&amp;token=4a7f58a3-ff87-4aa9-8160-c54f47267575" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
No menu lateral, clique em **Cardápios**.
{% endstep %}

{% step %}
Clique em **Adicionar Cardápio** e informe um nome. Exemplo: `Happy Hour`.
{% endstep %}

{% step %}
Selecione os **dias da semana** e o **horário** de início e fim.

Exemplo: de segunda a sexta, das `18:00` às `20:00`.
{% endstep %}

{% step %}
Selecione as **categorias** que farão parte do cardápio.

Exemplo: **Cervejas** e **Chopes**.

Fora dos dias e horários definidos, essas categorias não aparecem no totem.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Exemplos de uso:**

* categoria de café da manhã exibida só até as `10:00`;
* happy hour com preço diferente: cadastre um produto à parte, como **Chope Happy Hour**, com o preço promocional, e coloque-o em uma categoria exibida só pelo cardápio de happy hour.
  {% endhint %}

***

## 11. Modificadores

Modificadores são as perguntas que o totem faz ao cliente sobre um produto. Exemplos: "Qual o ponto da carne?", "Quer adicionais?", "Escolha o molho".

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FCgnMBxqUVlluh4s9hQFW%2Ftokmenu-11-modificadores.png?alt=media&amp;token=ad259d47-3390-4bf7-9c0f-fa4b2eec78ed" alt=""><figcaption></figcaption></figure>

Cada grupo mostra:

* **Título** e **Descrição** — o que o cliente vê.
* **Qtd mín** / **Qtd máx** — quantas opções o cliente é obrigado a escolher e quantas pode escolher no máximo.
* **Exibição** — como as opções aparecem:
  * `radio` — escolha única. Exemplo: ponto da carne.
  * `check` — múltipla escolha. Exemplo: adicionais.
  * `quantity` — permite escolher a quantidade de cada opção.
* **# Comp.** — quantos complementos o grupo tem.

**Ações disponíveis:** **Adicionar Grupo**, **Editar** (ícone de lápis) e **Excluir** (ícone de lixeira).

{% stepper %}
{% step %}

### Crie o grupo

Clique em **Adicionar Grupo** e defina título, quantidades e tipo de exibição.

Exemplo: **Ponto da Carne**, exibição `radio`, mínimo `0` e máximo `1`.
{% endstep %}

{% step %}

### Cadastre os complementos

Inclua as opções do grupo e, se for o caso, o preço de cada uma.

Informe também o **código** do complemento no PDV Legal. O código é enviado ao PDV Legal junto com a venda.
{% endstep %}

{% step %}

### Vincule ao produto

No cadastro do produto, adicione o grupo e ajuste a prioridade. Veja o item **8.2. Modificadores do produto**.

Um mesmo grupo pode ser usado em vários produtos. Exemplo: X-Salada, X-Bacon e Cheeseburger com os mesmos modificadores.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Preço dos complementos:**

* **com preço** — o valor aparece na tela e é somado ao produto. Exemplo: adicional de queijo `+ R$ 4,00`.
* **sem preço** — a opção não altera o valor. Exemplo: ponto da carne ou **Remoção** (sem cebola, sem alface).

A escolha do cliente aparece na impressão da cozinha junto com o produto.
{% endhint %}

{% hint style="success" %}
**Venda adicional com modificador:** um grupo como **Transforme em combo** (batata + refrigerante por um valor a mais) ou **Peça mais um** funciona como um adicional com preço.
{% endhint %}

***

## 12. Terminais

Os terminais são os equipamentos da loja: totens de autoatendimento, PDVs e monitores de cozinha (KDS).

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F80g7rQhpc033lWXNdCVI%2Ftokmenu-12-terminais.png?alt=media&amp;token=b1a605c7-da7e-41eb-9302-afa09a975c72" alt=""><figcaption></figcaption></figure>

A lista mostra, para cada terminal:

* **Nome** e **Descrição**.
* **Tipo** — exemplo: `AA` para autoatendimento.
* **Smart POS** — a maquininha. Exemplo: `SITEF`.
* **Ativo** — se o terminal está em uso.
* **KDS Master** — se o terminal é o KDS principal.
* **Tam. Imp.** — tamanho de impressão.
* **Device** — versão do app instalado.

**Ações disponíveis:** **Adicionar Terminal**, **Editar** (ícone de lápis) e **Excluir** (ícone de lixeira).

### 12.1. Configurações do terminal

Ao editar um terminal, você ajusta:

* **Nome** e **Tipo**.
* **Impressão** — tamanho da impressora, endereço da impressora de produção e impressão com estilos (quando a impressora permite).
* **TEF** — configurações de pagamento e endereço do TEF.
* **Ativo** — desmarque para desativar o terminal e tirá-lo da lista.
* **Telas do totem** — quais telas o cliente percorre depois de montar o pedido, e em que ordem.

### 12.2. Telas do totem

As telas disponíveis são:

* **Confirmação** — lista os produtos para o cliente conferir o pedido.
* **Local de consumo** — pergunta se o cliente vai comer no local ou levar.
* **Nome do cliente**.
* **CPF**.
* **Celular do cliente**.
* **Pager** — número do localizador entregue ao cliente.

{% stepper %}
{% step %}
Edite o terminal e localize a configuração das telas.
{% endstep %}

{% step %}
Mantenha apenas as telas que a operação usa.
{% endstep %}

{% step %}
Ajuste a ordem em que as telas aparecem.

Exemplo: exibir o **Pager** antes do **Celular**.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Peça só o necessário.** Cada tela a mais aumenta o tempo do cliente no totem.

* A loja não chama o cliente pelo nome? Remova **Nome do cliente**.
* Não envia nada por celular? Remova **Celular do cliente**.
* Todo consumo é no local? Remova **Local de consumo**.
  {% endhint %}

{% hint style="info" %}
As telas ficam no **terminal**, e não na loja, para permitir configurações diferentes. Exemplo: um totem do lado de fora da loja não pergunta o local de consumo, porque tudo é para levar. Um totem dentro da loja pode trabalhar com **Pager**.
{% endhint %}

***

## 13. Produtos x KDS

Define quais produtos são enviados para cada KDS ou **impressora de cozinha**. Assim, cada setor recebe só o que lhe diz respeito. Exemplo: a chapa vê os burgers e o bar vê as bebidas.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FwWh4IQXSsov2FpA3QYhJ%2Ftokmenu-13-produtos-x-kds.png?alt=media&amp;token=abd36b08-af8d-44b9-b016-b5a625d7a96c" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Escolha o KDS ou a impressora

No menu lateral, clique em **Produtos x KDS**.

Em **KDS/Impressora**, selecione o terminal de cozinha.

{% hint style="warning" %}
Se o painel exibir **Nenhum terminal do tipo KDS cadastrado nesta loja**, cadastre o terminal em **Terminais** primeiro.
{% endhint %}
{% endstep %}

{% step %}

### Localize os produtos

Use os filtros **Código**, **Nome**, **Visível** e **Grupo/SubGrupo**.
{% endstep %}

{% step %}

### Vincule os produtos

Marque a caixa **VINC.** nos produtos que devem ir para aquele KDS ou impressora.
{% endstep %}

{% step %}

### Grave

Clique em **Gravar Dados**.

Para desfazer as marcações ainda não salvas, clique em **Limpar Dados**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Cozinha com várias estações:** cada estação (grelhados, saladas, bebidas) pode ter o seu KDS. O **KDS Master** (ou de conferência) reúne os itens de cada pedido para a entrega ao cliente.
{% endhint %}

***

## 14. Formas de Pagamento

Define quais formas de pagamento o totem oferece ao cliente.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FIykI0IQCXkpbXlrm2egw%2Ftokmenu-14-formas-de-pagamento.png?alt=media&amp;token=2ce85945-9d28-475f-b84f-7eca65a79083" alt=""><figcaption></figcaption></figure>

Cada linha mostra: **ID**, **tipo**, **descrição**, **prioridade** (ordem de exibição) e se está **visível**.

Os tipos possíveis são:

* **Dinheiro** — `MONEY`
* **Crédito** — `CREDIT`
* **Débito** — `DEBIT`
* **Voucher** — `VOUCHER`
* **PIX** — `PIX`

**Ações disponíveis:** **Adicionar Forma Pgto**, **Editar** (ícone de lápis) e **Excluir** (ícone de lixeira).

{% hint style="danger" %}
**Importante:** o **ID** de cada forma de pagamento deve ser igual ao código da forma de pagamento cadastrada no PDV Legal. Se não bater, a venda pode ser rejeitada.
{% endhint %}

{% hint style="info" %}
Para tirar uma forma de pagamento do totem, deixe-a como **não visível**. Exemplo: a loja não trabalha com PIX no totem.
{% endhint %}

{% hint style="success" %}
Teste todas as formas de pagamento no totem antes de liberar para os clientes.
{% endhint %}

***

## 15. Configurações da loja

Reúne os dados gerais, a aparência e as integrações da loja no totem.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FVUrqHIj6L5B7LZaCQuJh%2Ftokmenu-15-configuracoes.png?alt=media&amp;token=dad7e5fb-e504-4808-a993-df666b5c47f7" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Informações Gerais

* **ID da Loja** — identificador interno do sistema. Não é editável.
* **Nome** — nome da loja. Pode ser alterado.
* **Descrição** — preenchida automaticamente quando a loja é incluída pelo módulo OEM.
* **Código Externo** — código da filial no PDV Legal.
* **Empresa**, **Código Empresa** e **CNPJ** — dados cadastrais.
* **Ativo** — indica se a loja está em operação.
* **Exibir ID Sequencial** — define como o número do pedido é gerado:
  * **marcado** — sequencial, reiniciando a cada dia (o primeiro pedido do dia é `1`, o segundo é `2`);
  * **desmarcado** — número aleatório.
    {% endstep %}

{% step %}

### Layout e Programa de Fidelidade

* **Tipo de Layout**:
  * **Tradicional** — cards com foto, valor e borda colorida;
  * **Minimalista** — cards sem borda, exibindo a **Descrição** do produto.
* **Programa de Fidelidade** — vincula um programa de fidelidade, como o [Fidelidade Legal](https://ajuda.pdvlegal.com.br/integracoes/autoatendimento-food/integracao-com-fidelidade-legal-no-autoatendimento-food).
  {% endstep %}

{% step %}

### Cores

Na seção **Cores**, escolha as cores do totem.
{% endstep %}

{% step %}

### Imagens da loja

Informe a URL das imagens:

* **Logo**;
* **Banner superior** — exibido no topo do totem;
* **Banners de rotação** — até 3 imagens que se alternam na tela de descanso.
  {% endstep %}

{% step %}

### Integração e acesso ao totem

* **Integração** — os códigos de integração são preenchidos automaticamente quando a integração é feita. Não altere.
* **Senha do ADM do totem** — senha para acessar a área administrativa no próprio totem.
  {% endstep %}

{% step %}

### Salve

Clique em **Salvar Configurações**.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Importante:** alguns campos, como endereço e contatos, podem não ser gravados dependendo da versão do sistema de retaguarda. Se um dado não persistir após salvar, fale com o suporte.
{% endhint %}

***

## 16. Imagens

Galeria de imagens para usar em produtos e categorias.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FOI1Wv1oGY731a3jBP3kL%2Ftokmenu-16-imagens.png?alt=media&amp;token=4f5ff0f7-060f-4fd6-8926-9add600fa2cc" alt=""><figcaption></figcaption></figure>

* Para filtrar, digite no campo **Parte do nome da imagem...** e clique em **Buscar**.
* Navegue pela galeria com as setas de paginação no topo.
* Para enviar novas imagens, clique em **Upload de Imagens**.

Cada miniatura mostra o nome do arquivo, o tamanho e a data.

{% hint style="danger" %}
**Regras de upload:**

* tamanho máximo de **100 KB** por imagem;
* alguns nomes de arquivo são bloqueados.

Imagens pesadas deixam o totem lento e podem travá-lo.
{% endhint %}

{% hint style="success" %}
**Dê nomes claros às imagens antes de enviar.** Exemplo: `copo-chope-pilsen`. Nomes genéricos, como os de arquivos recebidos pelo WhatsApp, dificultam encontrar a imagem depois.
{% endhint %}

{% hint style="warning" %}
**A galeria é compartilhada entre as lojas.** Para manter imagens exclusivas, como as de uma franquia, hospede-as em um repositório próprio e cole a **URL** no campo de imagem do produto ou da categoria.
{% endhint %}

***

## 17. Comparativo de Vendas

Compara as vendas de um período com o período equivalente anterior. Serve como referência para prever o movimento.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FpNiXgd8C1I5TnBr82it7%2Ftokmenu-17-comparativo.png?alt=media&amp;token=469a938b-d58a-431a-ab35-e13607fdb42c" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
No menu lateral, clique em **Comparativo**.
{% endstep %}

{% step %}
Escolha a **Data Referência** e o **Período**:

* **Dia** — compara com o mesmo dia da semana anterior. Exemplo: sexta-feira contra a sexta-feira passada.
* **Semana** — compara com a semana anterior.
* **Mês** — compara com o mês anterior.
  {% endstep %}

{% step %}
Clique em **Comparar**.
{% endstep %}
{% endstepper %}

***

## 18. Vendas Multi-Loja

Reúne em uma só tela as vendas de todas as lojas vinculadas ao seu usuário.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FfpwmZvy3zYGvOyNS4LuD%2Ftokmenu-18-vendas-multiloja.png?alt=media&amp;token=06d91337-6d43-4ace-bfb7-225588b91d77" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
No menu lateral, clique em **Vendas Multi-Loja**.
{% endstep %}

{% step %}
Informe a **Data Início** e a **Data Fim**.
{% endstep %}

{% step %}
Clique em **Buscar**.

O painel lista as vendas de cada loja do seu perfil.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Esta tela depende de um recurso do sistema de retaguarda que pode não estar disponível em todos os ambientes.
{% endhint %}

***

## 19. Trocar senha

Troque a senha do seu próprio usuário.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FAcgmxgUHddLar6z8Pma8%2Ftokmenu-19-trocar-senha.png?alt=media&amp;token=938ef9e8-a881-4cfd-8e73-018fbf1ac041" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
No menu lateral, clique em **Trocar Senha**.

O campo **Usuário** já vem preenchido com o seu e-mail e não pode ser editado.
{% endstep %}

{% step %}
Digite a **Nova Senha**.
{% endstep %}

{% step %}
Repita a senha em **Confirmar Senha**.
{% endstep %}

{% step %}
Clique em **Alterar Senha**.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Troque a senha padrão logo no primeiro acesso. Use uma senha que só você conheça e evite reutilizar senhas de outros sistemas.
{% endhint %}

***

## 20. Telas de administrador

Algumas telas aparecem apenas para usuários com perfil de **administrador**:

* **Usuários** — cadastro de usuários e vínculo de lojas.
* **Lojas x Vendas** — visão de todas as lojas com métricas de vendas.
* **Vendas por Hora** — distribuição das vendas por faixa de horário.

{% hint style="info" %}
Se você não vê essas opções no menu, seu usuário não tem perfil de administrador.
{% endhint %}

***

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

{% hint style="danger" %}

* **Problema:** Alterei um produto ou preço e não mudou no totem.

**Solução:** Confirme se a alteração foi salva e se o produto está visível. Em alguns casos, o totem leva alguns instantes para sincronizar.

* **Problema:** Um item acabou. Como tiro do totem rapidamente?

**Solução:** Use a tela **Visibilidade** e desligue a chave do produto. Para repor, ligue de novo.

* **Problema:** O adicional ou o molho do combo não está sendo cobrado.

**Solução:** Confira se o item tem preço cadastrado e, no caso de combo especial, se a categoria está com **Exibir valor dos produtos** marcado. Se o valor não aparece na tela do totem, ele não é cobrado.

* **Problema:** A venda aparece com ícone de alerta em **Vendas**.

**Solução:** Clique no ícone para ver o motivo. No detalhe da venda, reenvie a venda ou busque a nota fiscal novamente.

* **Problema:** A venda foi rejeitada por causa da forma de pagamento.

**Solução:** Confira se o **ID** da forma de pagamento no painel é igual ao código cadastrado no PDV Legal.

* **Problema:** O totem está lento ou travando.

**Solução:** Verifique o tamanho das imagens. Cada imagem deve ter no máximo **100 KB**.

* **Problema:** Como mudo a ordem em que as categorias e os produtos aparecem?

**Solução:** Ajuste o número da **prioridade** na edição da categoria ou do produto. Menor prioridade aparece primeiro.

* **Problema:** Trabalho em mais de uma loja. Como troco?

**Solução:** Clique no nome da loja, no topo do menu lateral, e selecione a loja.

* **Problema:** Não encontro uma tela de que preciso.

**Solução:** O menu mostra apenas o que o seu perfil permite. O **Perfil Loja** tem menu reduzido. Para a gestão completa, é preciso um usuário com **Perfil Gerenciamento**.

* **Problema:** O painel pediu login de novo.

**Solução:** A sessão expira por segurança. Basta entrar novamente.
{% endhint %}

{% hint style="info" %}
As telas podem variar levemente conforme a versão instalada e o perfil do seu usuário.
{% endhint %}

***

### Manuais relacionados

* [O que é o Autoatendimento Food](https://ajuda.pdvlegal.com.br/integracoes/autoatendimento-food)
* [Instalação de Totem, KDS e PINPAD](https://ajuda.pdvlegal.com.br/integracoes/autoatendimento-food/instalacao-de-totem-kds-e-pinpad-autoatendimento-food)
* [Configuração de KDS](https://ajuda.pdvlegal.com.br/integracoes/autoatendimento-food/configuracao-de-kds-autoatendimento-food)
* [Integração com o Fidelidade Legal](https://ajuda.pdvlegal.com.br/integracoes/autoatendimento-food/integracao-com-fidelidade-legal-no-autoatendimento-food)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.pdvlegal.com.br/integracoes/autoatendimento-food-tokmenu/novo-painel-do-autoatendimento-food-tokmenu.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.