> ## 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.

# Categorias

> Organize o catálogo nos blocos com que o cliente percorre o cardápio, e decida quais aparecem, quando e em qual canal.

Uma categoria é o bloco com que o cliente percorre o cardápio: *Combos*, *Bebidas*, *Sobremesas*. É a primeira coisa que ele vê e a ordem em que vê, então não é uma etiqueta administrativa: é como o seu menu se navega.

É aqui que esses blocos se definem uma única vez, para todo o catálogo. Vá em **Restaurant OS → Menu e Produtos → Categorias**.

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

***

## O mínimo que você precisa saber

<Note>
  **1. A categoria vive no catálogo, não em um menu.** É criada uma vez e todos os menus a herdam. O que você mudar aqui chega a todo lugar.

  **2. Um produto pode estar em várias categorias.** Essa relação se monta na ficha do produto, não aqui.

  **3. Se você marcar como exclusiva de canal, ela desaparece do Golden Menu** — e os produtos dela herdam essa exclusividade.
</Note>

***

## O caminho simples

Criar uma categoria são três campos: **Nova categoria**, dá um nome, salva.

Com isso ela já existe, aparece no Golden Menu e você pode começar a atribuir produtos a ela pela ficha de cada um.

<Tip>
  Se o seu cardápio é *Entradas, Pratos, Bebidas, Sobremesas* e ele é igual em todo lugar, isso é tudo de que você precisa. O resto do manual é para quando uma categoria tem que aparecer só em certos horários ou só em um canal.
</Tip>

***

## O que a lista te diz

| Coluna          | O que olhar                                         |
| --------------- | --------------------------------------------------- |
| **Name**        | O nome da categoria.                                |
| **Parent**      | De qual categoria ela pende, se pender de alguma.   |
| **Position**    | A ordem em que é exibida. Vazio = ordem automática. |
| **Featured**    | Se está marcada como destaque.                      |
| **Visibility**  | **Visible in menu** ou **Hidden**.                  |
| **Products**    | Quantos produtos ela tem atribuídos.                |
| **Active**      | Ativa ou inativa.                                   |
| **External ID** | O identificador dela no sistema externo (X-MART).   |

***

## Os dois textos de uma categoria

Ao criá-la você verá que há duas descrições, e não são a mesma coisa:

| Campo                       | Quem lê                                                                        |
| --------------------------- | ------------------------------------------------------------------------------ |
| **Operational description** | Ninguém de fora. É para a sua equipe: *"só de segunda a sexta, cozinha fria"*. |
| **Marketing description**   | O cliente. É publicada nos menus.                                              |

<Frame>
  <img src="https://mintcdn.com/firepos/fMgbql6u0dMQH9DE/images/manuals/backoffice/categories/02-general.png?fit=max&auto=format&n=fMgbql6u0dMQH9DE&q=85&s=351e0805269dae959ae34973f60bb662" alt="Formulário geral de uma categoria" width="3200" height="2000" data-path="images/manuals/backoffice/categories/02-general.png" />
</Frame>

Os nomes e as descrições se preenchem **nos três idiomas** (espanhol, inglês e português) na mesma tela.

<Warning>
  **Não coloque notas internas na descrição de marketing.** Esse texto viaja para o menu publicado e o cliente lê. A separação entre as duas descrições existe justamente para isso não acontecer.
</Warning>

***

## Onde aparece e em que ordem

Três controles que se confundem entre si:

* **Display in menu** — se desligado, a categoria **não aparece no cardápio do cliente**. Os produtos que ela tem continuam existindo.
* **Featured** — a marca para os blocos de destaque do menu, aqueles que vão no topo ou num carrossel.
* **Position** — a ordem global. Se deixar vazio, a ordem é gerenciada automaticamente.

<Info>
  **Position é a ordem no catálogo, não em um menu específico.** Dentro de um menu custom você pode reordenar as categorias arrastando, e essa ordem manda para aquele menu. O que você põe aqui é o ponto de partida do qual todos herdam.
</Info>

***

## Categoria exclusiva de canal

Este é o interruptor com mais consequências, e vale entendê-lo antes de mexer.

<Frame>
  <img src="https://mintcdn.com/firepos/fMgbql6u0dMQH9DE/images/manuals/backoffice/categories/03-exclusiva.png?fit=max&auto=format&n=fMgbql6u0dMQH9DE&q=85&s=7f82a6fbb8722add812620436185e85a" alt="Cartão de categoria exclusiva de canal, acima dos controles de status do catálogo" width="3200" height="2000" data-path="images/manuals/backoffice/categories/03-exclusiva.png" />
</Frame>

Por padrão uma categoria **faz parte do Golden Menu** e todos os canais e todas as lojas a herdam. Ao ativar a exclusividade, isso se inverte: a categoria **deixa de aparecer no Golden Menu** e só existe nos menus onde alguém a adicionar na mão.

Serve para o que o nome diz: uma categoria que só faz sentido num agregador, ou uma promoção que só vai no app.

<Warning>
  **Os produtos de uma categoria exclusiva herdam a exclusividade.** Não é só a categoria que some do Golden Menu: ela leva os produtos junto. Se você marcar como exclusiva uma categoria que já tinha produtos vendendo, esses produtos deixam de estar no menu base.
</Warning>

***

## Quando está disponível

A aba **Availability** define os dias e os horários em que a categoria é oferecida. É onde se resolve *"o café da manhã só até as 11"* sem ter que montar um menu à parte.

<Frame>
  <img src="https://mintcdn.com/firepos/fMgbql6u0dMQH9DE/images/manuals/backoffice/categories/04-horarios.png?fit=max&auto=format&n=fMgbql6u0dMQH9DE&q=85&s=e308202062a8606a5555c119aa133e82" alt="Aba Availability com os horários da categoria" width="3200" height="2000" data-path="images/manuals/backoffice/categories/04-horarios.png" />
</Frame>

Uma categoria com horário próprio recebe a etiqueta **Schedule**, e no editor de menus a lente de dia a esconde quando o dia e a hora que você escolher não a cobrem.

***

## Imagens

A aba **Media** aceita **WebP, JPEG ou PNG, até 5 MB**. Uma das imagens é marcada como principal.

<Note>
  **As abas Availability e Media ficam bloqueadas até você salvar.** A própria tela diz: *"Save the category first to access this section"*. É porque até esse momento não existe categoria em que pendurar um horário ou uma foto.
</Note>

***

## Receitas: como os casos reais se resolvem

<AccordionGroup>
  <Accordion title="Montar o cardápio de café da manhã que se apaga às 11">
    1. **Nova categoria**, nome *Café da manhã*.
    2. Salve: até esse momento a aba de horários está bloqueada.
    3. Aba **Availability**: os dias e a faixa de horário, até as 11:00.
    4. Atribua os produtos pela ficha de cada um.

    A categoria fica marcada com **Schedule** e deixa de ser oferecida sozinha depois daquele horário. Não é preciso um menu separado para o café da manhã.
  </Accordion>

  <Accordion title="Uma promoção que só vai em um agregador">
    1. Crie a categoria e ative o **Channel Exclusive**.
    2. Atribua a ela os produtos da promoção.
    3. Vá em [Menus](/pt/manuals/backoffice/menus), abra o menu custom daquele agregador e adicione-a com **Add category**.

    Como é exclusiva, não suja o Golden Menu nem aparece nos demais canais.
  </Accordion>

  <Accordion title="Tirar uma categoria do cardápio sem excluí-la">
    Desligue **Display in menu**. A categoria deixa de aparecer no cardápio do cliente mas continua existindo, com seus produtos e suas relações intactos.

    É o correto para algo sazonal que vai voltar. Excluir é permanente e não dá para desfazer.
  </Accordion>

  <Accordion title="Mudar a ordem em que o cliente vê os blocos">
    Se a ordem tem que ser a mesma em todo lugar, use **Position** aqui.

    Se muda só em um canal, não mexa nisto: abra aquele menu custom em [Menus](/pt/manuals/backoffice/menus) e reordene as categorias arrastando. Assim os demais canais nem ficam sabendo.
  </Accordion>
</AccordionGroup>

***

## Erros que saem caro

<Warning>
  **Marcar como exclusiva uma categoria que já estava vendendo.** Ela e todos os seus produtos saem do Golden Menu na hora. Se esse é o menu que suas lojas usam, você parou de vender esses produtos.
</Warning>

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

<Warning>
  **Excluir em vez de ocultar.** **Delete** é permanente: *"This action cannot be undone"*. Se a categoria pode voltar, desligue **Display in menu**.
</Warning>

***

## Glossário

| Termo                 | O que significa                                                                                                   |
| --------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Categoria**         | O bloco pelo qual o cardápio se agrupa e se navega. Vive no catálogo.                                             |
| **Parent**            | A categoria da qual outra pende.                                                                                  |
| **Position**          | A ordem global no catálogo. Vazio = automático.                                                                   |
| **Featured**          | Marca para os blocos de destaque do menu.                                                                         |
| **Display in menu**   | Se aparece ou não no cardápio do cliente.                                                                         |
| **Channel Exclusive** | A categoria sai do Golden Menu e só existe onde você a adicionar na mão. Os produtos dela herdam a exclusividade. |
| **Schedule**          | O horário próprio da categoria: os dias e as horas em que é oferecida.                                            |
| **External ID**       | O identificador dela no sistema externo (X-MART).                                                                 |

***

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Como atribuo produtos a uma categoria?">
    Pela ficha do produto, na aba **Categories** — não daqui. Um produto pode estar em várias categorias ao mesmo tempo. Ver [Produtos](/pt/manuals/backoffice/products).
  </Accordion>

  <Accordion title="Criei a categoria e as abas de horários e imagens estão cinzas">
    É preciso salvar primeiro. Até esse momento a categoria ainda não existe e não há em que pendurar um horário ou uma foto: *"Save the category first to access this section"*.
  </Accordion>

  <Accordion title="Mudei a ordem e em um canal continua diferente">
    Aquele menu tem a ordem dele. **Position** é o ponto de partida do catálogo; dentro de um menu custom, a ordem que alguém deixou arrastando manda para aquele menu.
  </Accordion>

  <Accordion title="Ocultei a categoria e os produtos dela continuam aparecendo">
    Desligar **Display in menu** esconde o bloco, mas um produto que também está em outra categoria visível continua aparecendo por ali. Um produto pode pertencer a várias.
  </Accordion>
</AccordionGroup>

***

## O que vem por aí

* **Atribuir produtos a partir da categoria**: hoje a relação se monta sempre pela ficha do produto.
