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

# Produtos

> O catálogo do qual sai todo o resto: o que você vende, quanto custa, como se personaliza e onde pode aparecer.

O produto é a peça da qual pende todo o resto. Um menu não inventa nada: apenas escolhe produtos do catálogo e os ordena. Uma lista de preços não cria nada: coloca preço em produtos que já existem. Um grupo de modificadores também não: as opções dele **são** produtos.

Por isso esta tela é o ponto de partida. Vá em **Restaurant OS → Menu e Produtos → Produtos**.

<Frame>
  <img src="https://mintcdn.com/firepos/fMgbql6u0dMQH9DE/images/manuals/backoffice/products/01-listado.png?fit=max&auto=format&n=fMgbql6u0dMQH9DE&q=85&s=78b87795d52be6f202e65d56f914cd00" alt="Lista do catálogo de produtos" width="3200" height="2000" data-path="images/manuals/backoffice/products/01-listado.png" />
</Frame>

***

## O mínimo que você precisa saber

<Note>
  **1. O tipo se escolhe ao criar o produto.** Product, Combo, Modifier ou Packaging. Os três primeiros podem ser trocados depois pelo cabeçalho da ficha; **Packaging é definitivo**.

  **2. Desligar "Mostrar no menu" não desabilita o produto.** Ele deixa de aparecer no cardápio, mas continua servindo dentro de combos e como opção de modificadores.

  **3. Criar o produto não o coloca à venda.** Ele precisa estar em um menu, e esse menu precisa ser sincronizado.
</Note>

***

## O caminho simples

**Novo produto**, nome e código, salvar. Com isso o produto existe e entra no Golden Menu.

Depois, na aba **Pricing**, você coloca o preço. E já pode ser vendido assim que o menu que o contém for sincronizado.

<Tip>
  Se você vende pratos avulsos sem personalização, com a aba **General** e a de **Pricing** já terminou. O resto do manual é para combos, modificadores e preços por canal.
</Tip>

***

## Os quatro tipos de produto

O botão **New Product** cria diretamente um produto; o caret ao lado oferece os outros três tipos. A diferença importa desde o primeiro dia.

<Frame>
  <img src="https://mintcdn.com/firepos/fMgbql6u0dMQH9DE/images/manuals/backoffice/products/02-tipos.png?fit=max&auto=format&n=fMgbql6u0dMQH9DE&q=85&s=f72b492f8060cc754a6b9f77fd667e27" alt="Seletor de tipo ao criar um produto" width="3200" height="2000" data-path="images/manuals/backoffice/products/02-tipos.png" />
</Frame>

| Tipo          | O que é                                 | Exemplo                           |
| ------------- | --------------------------------------- | --------------------------------- |
| **Product**   | Um item vendido diretamente.            | Um hambúrguer, um refrigerante.   |
| **Combo**     | Um pacote composto por vários produtos. | *2 Tiras + Batata + Bebida*.      |
| **Modifier**  | Uma opção que modifica outro produto.   | *Queijo extra*, *Tamanho grande*. |
| **Packaging** | A embalagem associada a um produto.     | Uma caixa, um copo.               |

No cabeçalho da ficha há um seletor com três pastilhas — **Modifier**, **Product**, **Combo** — para passar de um a outro mais adiante. **Packaging** não aparece ali: esse é definitivo, e se você errar tem que criar o produto de novo.

<Warning>
  **Mudar de tipo não é de graça.** Passar para **Combo** **apaga os preços** que o produto tinha. Passar para **Modifier** **elimina os grupos de modificadores** dele, porque um modificador é uma resposta e não pode ter perguntas penduradas; a tela pergunta antes de fazer isso.

  A mudança fica pendente — com a marca **Unsaved** — até você salvar.
</Warning>

***

## O que a lista te diz

| Coluna              | O que olhar                                                                  |
| ------------------- | ---------------------------------------------------------------------------- |
| **Code**            | O código operacional do ponto de venda (PLU).                                |
| **Name** · **Type** | Nome e tipo, com o chip colorido.                                            |
| **Category**        | Em quais categorias está.                                                    |
| **Price**           | O preço base. Nos combos aparece como **ref.** — é uma referência calculada. |
| **VAT**             | O imposto aplicado.                                                          |
| **Status**          | **Draft** · **Published** · **Partial** · **Archived**.                      |
| **Sync**            | **Synced** · **Pending** · **Error**.                                        |
| **Modifiers**       | Quantos grupos de modificadores tem.                                         |
| **Exclusive**       | Se está fora do Golden Menu.                                                 |

No topo há busca e três filtros: status, tipo e categoria.

***

## A ficha do produto

O editor é dividido em abas, e várias ficam bloqueadas até você salvar pela primeira vez: *"Save the product first to access this section"*.

<Frame>
  <img src="https://mintcdn.com/firepos/fMgbql6u0dMQH9DE/images/manuals/backoffice/products/03-general.png?fit=max&auto=format&n=fMgbql6u0dMQH9DE&q=85&s=418fa4dd795457ed33daa2278ab34184" alt="Aba General da ficha de produto" width="3200" height="2000" data-path="images/manuals/backoffice/products/03-general.png" />
</Frame>

| Aba                 | Para quê                                                                                             |
| ------------------- | ---------------------------------------------------------------------------------------------------- |
| **General**         | Nomes em três idiomas, códigos, classificação, e os interruptores de status, visibilidade e horário. |
| **Pricing**         | Preço base, impostos, descontos e preço por tipo de serviço.                                         |
| **Categories**      | Em quais categorias está. Pode estar em várias.                                                      |
| **Images**          | As fotos, com a opção de atribuí-las por tipo de serviço.                                            |
| **Modifier Groups** | As perguntas que se fazem ao cliente ao pedir.                                                       |
| **Suggestions**     | Upselling e cross-selling.                                                                           |

### Nem todas as abas estão sempre

Quais você vê depende do tipo, e isso diz bastante sobre o que cada tipo é:

| Tipo          | Abas                                                                    |
| ------------- | ----------------------------------------------------------------------- |
| **Product**   | General · Pricing · Categories · Images · Modifier Groups · Suggestions |
| **Combo**     | General · Categories · Images · **Composition** · Suggestions           |
| **Modifier**  | General · Pricing · Categories · Images                                 |
| **Packaging** | General · Pricing · Categories · Images · Modifier Groups               |

Três coisas que se leem nessa tabela:

* **Um combo não tem aba de preço.** Não é esquecimento: o preço de um combo não vive no produto, sai da lista de preços do destino.
* **Composition é a aba de Modifier Groups, renomeada.** Um combo se monta com a mesma mecânica de grupos e opções: cada grupo é uma decisão — *escolha sua bebida* — e o mínimo diz quantas vão incluídas.
* **Um Modifier não tem grupos nem sugestões.** É uma resposta, não uma pergunta, e não é vendido como linha própria do pedido.

### As duas descrições

Como nas categorias, há uma **descrição operacional** — interna, para a sua equipe — e uma **descrição de marketing**, que é a que se publica e o cliente lê. Não misture uma com a outra.

A de marketing tem um botão **Generate with AI**: propõe três versões por idioma e **não aplica nada até você escolher**. A tela diz isso explicitamente.

***

## Os três interruptores que decidem se vende

Parecem iguais e fazem coisas diferentes. É onde mais gente erra.

| Interruptor                          | O que faz                                                                                                     |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| **Product status** *(ativo/inativo)* | Inativo: **fica fora de todos os menus e não pode ser vendido**.                                              |
| **Show in menu**                     | Desligado: não aparece no cardápio, **mas continua servindo dentro de combos e como opção de modificadores**. |
| **Out of stock**                     | Temporariamente sem disponibilidade. Pode aparecer em cinza no cardápio.                                      |

<Info>
  **"Show in menu" desligado é o que torna os modificadores possíveis.** Um produto *queijo extra* não deve aparecer no cardápio como um prato, mas precisa estar disponível quando alguém personaliza um hambúrguer. Desligar a visibilidade e deixar o produto ativo é exatamente essa combinação.
</Info>

### O estado comercial não se edita

Na aba **General**, junto a esses interruptores, há um **estado comercial** — **Available**, **Out of stock** ou **Not sellable** — que **o sistema calcula** cruzando tudo o que veio antes. A própria tela esclarece: *"Automatically calculated by the snapshot engine. Not editable."*

É o semáforo para saber o que realmente está acontecendo com um produto sem ter que checar interruptor por interruptor.

***

## Produto exclusivo de canal

O mesmo interruptor que existe nas categorias. Por padrão o produto **faz parte do Golden Menu** e todos os canais e lojas o herdam. Ao ativá-lo, ele sai do Golden Menu e só existe nos menus onde alguém o adicionar na mão.

<Note>
  Se a **categoria** dele já for exclusiva, o produto herda essa exclusividade sem você precisar marcar. Ver [Categorias](/pt/manuals/backoffice/categories).
</Note>

***

## Preço

<Frame>
  <img src="https://mintcdn.com/firepos/fMgbql6u0dMQH9DE/images/manuals/backoffice/products/04-precios.png?fit=max&auto=format&n=fMgbql6u0dMQH9DE&q=85&s=03ef63a8bd7f9a7d8a169f28e1c682d2" alt="Aba Pricing no Brasil: moeda, preço final e categoria fiscal" width="3200" height="2000" data-path="images/manuals/backoffice/products/04-precios.png" />
</Frame>

O **preço base** é o da lista base do catálogo: *"Default price from the base price list"*.

<Warning>
  **Esta aba não é igual em todos os países.** No **Brasil** ela é simplificada de propósito: só a moeda, o **Price after taxes** — o preço final, com impostos incluídos — e a **categoria fiscal (NCM)**.

  Nos países onde essa simplificação não se aplica aparecem também o **Net amount** (sem impostos), o detalhe de **impostos**, os **descontos** e as **moedas adicionais**. Se você seguir uma instrução e não encontrar um campo, provavelmente é isso, e não um erro.
</Warning>

Onde estão os dois campos de preço, a tela explica qual manda: *"Enter Net Amount to auto-calculate Gross from taxes. Or enter Gross directly — it takes priority."* Ou seja: se você digitar o bruto na mão, ele ganha do cálculo.

### Preços por tipo de serviço

Quando está habilitado — e **só em produtos**, não em combos — aparece um cartão para dar preço próprio a um serviço: delivery mais caro que o salão, por exemplo. Os serviços que você não toca ficam marcados como **Inherits base price**; os que toca, **Customized**.

<Info>
  **Este é o preço do catálogo, não o único preço que existe.** O que cada loja cobra em cada canal sai da lista de preços atribuída àquele destino. O que você põe aqui aterrissa na lista base e é o ponto de partida do qual as demais pendem. Ver [Listas de preços](/pt/manuals/backoffice/price-lists).
</Info>

***

## Modificadores: o que se ajusta por produto

Na aba **Modifier Groups** você adiciona os grupos que já definiu em [Grupos de modificadores](/pt/manuals/backoffice/modifier-groups). E aqui — só para este produto — dá para se afastar do grupo:

<Frame>
  <img src="https://mintcdn.com/firepos/fMgbql6u0dMQH9DE/images/manuals/backoffice/products/05-modificadores.png?fit=max&auto=format&n=fMgbql6u0dMQH9DE&q=85&s=c1dcff6f083f4a9ea8884804586a9e58" alt="Aba Modifier Groups com os overrides por produto" width="3200" height="2000" data-path="images/manuals/backoffice/products/05-modificadores.png" />
</Frame>

* O **título** com que o grupo é exibido.
* O **mínimo** e o **máximo**.
* O **preço de cada opção** dentro deste produto.

O que você deixar no valor do grupo é herdado; o que mudar fica marcado como **Custom for this product**. A tela resume: *"Leave a field as the group default to inherit"*.

***

## Combos: o que levam e quanto valem

Um combo se monta na aba **Composition**, agrupando os produtos que o compõem. É a mesma aba de **Modifier Groups** com outro nome: cada grupo é uma decisão do combo — *escolha sua bebida*, *escolha seu acompanhamento* — e o mínimo de cada grupo diz quantas unidades vão incluídas.

Um combo **não tem aba de preço**, e isso é de propósito.

<Warning>
  **O preço que um combo mostra é uma referência, não o que você cobra.** Aparece com a etiqueta **ref.** e é calculado como *a soma dos primeiros itens de cada grupo até a seleção mínima dele*. Serve para você se orientar enquanto monta o combo.

  O que se cobra de verdade sai da lista de preços do destino. Ver [Listas de preços](/pt/manuals/backoffice/price-lists).
</Warning>

***

## Sugestões: upselling e cross-selling

Duas coisas diferentes, e a diferença está no que acontece com o pedido:

|                   | O que faz                                           |
| ----------------- | --------------------------------------------------- |
| **Upselling**     | **Substitui** a linha do pedido. *"Quer grande?"*   |
| **Cross-selling** | **Adiciona** uma linha nova. *"Leva batata junto?"* |

<Warning>
  **Uma sugestão que não está no menu não viaja.** Ao sincronizar, se o produto sugerido não fizer parte daquele cardápio, a sugestão cai do envio e fica anotada nos avisos. Ver [Atribuição de menus](/pt/manuals/backoffice/menu-assignments).
</Warning>

***

## Imagens

**WebP, JPEG ou PNG, até 5 MB.** Uma imagem é a principal, e é a que se usa quando não há nenhuma específica.

O interessante é que dá para **etiquetar imagens por tipo de serviço**: uma foto para o quiosque, outra para o app. A tela explica isso e traz uma pré-visualização de qual imagem sai em cada serviço. A principal é o reserva para todos os que não tiverem a sua.

***

## Receitas: como os casos reais se resolvem

<AccordionGroup>
  <Accordion title="Cadastrar um prato novo e colocá-lo à venda">
    1. **Novo produto → New Product**. Nome, código e salvar.
    2. Aba **Categories**: atribua a categoria dele.
    3. Aba **Pricing**: o preço base.
    4. Aba **Images**: a foto, marcada como principal.
    5. Vá em [Atribuição de menus](/pt/manuals/backoffice/menu-assignments) e sincronize as linhas do menu que o contém.

    Se o menu for o Golden e já estivesse atribuído, o produto entra sozinho: só falta sincronizar.
  </Accordion>

  <Accordion title="Criar um adicional que não deve aparecer no cardápio">
    1. **Novo produto → New Modifier**. Nome *Queijo extra*, com o preço dele.
    2. Em **General**, desligue **Show in menu**. O produto continua ativo.
    3. Vá em [Grupos de modificadores](/pt/manuals/backoffice/modifier-groups) e adicione-o como opção do grupo *Adicionais*.

    Não aparece como prato, mas sim quando o cliente personaliza.
  </Accordion>

  <Accordion title="Montar um combo">
    1. **Novo produto → New Combo**.
    2. Aba **Composition**: agrupe os produtos que o compõem e defina quantos se escolhem de cada grupo.
    3. Olhe o **Reference price** para se orientar, mas fixe o preço real na [lista de preços](/pt/manuals/backoffice/price-lists).

    Se você converteu um produto existente em combo, atenção: ao passar para Combo os preços que ele tinha são apagados.
  </Accordion>

  <Accordion title="Cobrar delivery mais caro que o salão">
    Há dois caminhos e não são intercambiáveis:

    * **Um produto pontual**: se a sua conta tem os preços por tipo de serviço habilitados, na aba **Pricing** você dá preço próprio ao delivery. Fica **Customized**.
    * **O cardápio inteiro**: não faça produto por produto. Crie uma [lista de preços](/pt/manuals/backoffice/price-lists) conectada à base com uma fórmula, e atribua-a às linhas de delivery.

    O segundo caminho é o que escala e o que se mantém sozinho.
  </Accordion>

  <Accordion title="Tirar um produto da venda">
    Depende de por quanto tempo:

    * **Hoje, porque acabou**: [Esgotados](/pt/manuals/backoffice/out-of-stock). Volta sozinho no fechamento.
    * **Esta temporada**: desligue **Show in menu**. Continua disponível dentro de combos.
    * **Para sempre**: deixe o produto **inativo**, o que o tira de todos os menus. Excluir é permanente e não dá para desfazer.
  </Accordion>
</AccordionGroup>

***

## Erros que saem caro

<Warning>
  **Mudar o tipo sem olhar o custo.** Passar para **Combo** apaga os preços do produto e passar para **Modifier** elimina os grupos dele. E com **Packaging** não há volta: ele não está no seletor.
</Warning>

<Warning>
  **Deixar um modificador com "Show in menu" ligado.** *Queijo extra* aparece no cardápio como se fosse um prato.
</Warning>

<Warning>
  **Colocar o preço aqui e esperar que chegue ao canal.** Este é o preço do catálogo. O que cada destino cobra sai da lista de preços dele, e não chega a lugar nenhum até a linha ser sincronizada.
</Warning>

<Warning>
  **Escrever notas internas na descrição de marketing.** Esse texto é publicado e o cliente lê.
</Warning>

<Warning>
  **Sugerir um produto que não está no menu.** A sugestão cai do envio em silêncio: só fica anotada nos avisos do sync.
</Warning>

***

## Glossário

| Termo                            | O que significa                                                                       |
| -------------------------------- | ------------------------------------------------------------------------------------- |
| **Product**                      | Um item vendido diretamente.                                                          |
| **Combo**                        | Um pacote composto por vários produtos.                                               |
| **Modifier**                     | Um produto que existe para ser opção de outro.                                        |
| **Packaging**                    | A embalagem associada a um produto.                                                   |
| **Code / PLU**                   | O código operacional do ponto de venda.                                               |
| **Show in menu**                 | Se aparece no cardápio. Desligado, continua servindo em combos e modificadores.       |
| **Estado comercial**             | **Available**, **Out of stock** ou **Not sellable**. O sistema calcula; não se edita. |
| **Channel Exclusive**            | O produto sai do Golden Menu e só existe onde você o adicionar na mão.                |
| **Preço de referência** *(ref.)* | Num combo, a soma orientativa dos componentes. Não é o que se cobra.                  |
| **Upselling / Cross-selling**    | Substituir a linha do pedido, ou adicionar uma nova.                                  |

***

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Criei o produto e ele não aparece no app">
    Percorra em ordem: está ativo e com **Show in menu** ligado? está numa categoria visível? está no menu atribuído àquela loja e canal? aquela linha foi sincronizada depois de você criá-lo? O último passo é o mais esquecido — ver [Atribuição de menus](/pt/manuals/backoffice/menu-assignments).
  </Accordion>

  <Accordion title="Por que o combo mostra um preço com 'ref.'?">
    Porque não é o que você cobra: é a soma orientativa dos componentes, calculada tomando os primeiros itens de cada grupo até a seleção mínima. O preço real sai da lista de preços do destino.
  </Accordion>

  <Accordion title="Errei o tipo, como mudo?">
    Com o seletor do cabeçalho da ficha, se for entre **Modifier**, **Product** e **Combo**. Tenha em conta o custo: passar para Combo apaga os preços e passar para Modifier elimina os grupos de modificadores.

    Se você errou com **Packaging**, não há seletor: é preciso criar o produto de novo.
  </Accordion>

  <Accordion title="As abas de preços e imagens estão cinzas">
    Falta salvar. Até esse momento o produto não existe: *"Save the product first to access this section"*.
  </Accordion>

  <Accordion title="Qual é a diferença entre inativo, oculto e esgotado?">
    **Inativo** o tira de todos os menus e ele não pode ser vendido. **Oculto** (**Show in menu** desligado) o tira do cardápio mas o deixa disponível dentro de combos e modificadores. **Esgotado** é temporário e pode aparecer em cinza. Para o que acabou no meio da operação, o correto é [Esgotados](/pt/manuals/backoffice/out-of-stock), que volta sozinho.
  </Accordion>
</AccordionGroup>

***

## O que vem por aí

* **Variantes**: criar produtos filhos por tamanho ou sabor. Está previsto, mas ainda não há tela.
* **Listas de preços a partir da ficha**: hoje a aba de preços trabalha sobre a lista base e o resto se maneja em [Listas de preços](/pt/manuals/backoffice/price-lists).