Manual de utilização

Gestão de Produtos

Guia completo para criar e configurar produtos, categorias, tags e composições no backoffice — incluindo menus com escolhas personalizadas.

Tags Categorias Produtos Composição
1

Como os módulos se relacionam

O sistema de produtos é composto por quatro módulos que funcionam em conjunto. Antes de criar qualquer produto, é importante perceber como cada módulo depende dos outros.

Os quatro módulos e o seu papel

Tags — o elo de ligação Etiquetas em formato de código (ex: acomp_med) que são atribuídas a produtos e usadas nos slots de composição para filtrar quais produtos aparecem como opção de escolha. São o mecanismo central de ligação entre produtos e menus.
Categorias — o agrupador Organizam os produtos em grupos visíveis no site e no callcenter. Cada produto pertence a uma categoria. As categorias têm visibilidade independente para site e callcenter — podem existir categorias internas usadas apenas na composição que o cliente final nunca vê.
Produtos — o item base Cada produto pode ser simples (vendido sozinho) ou composto (um menu que contém escolhas). Um produto tem sempre uma categoria e pode ter várias tags. Pode ser simultaneamente "pai" (menu) e "filho" (componente de outro menu).
Composição — os slots de escolha Define os momentos de personalização de um produto composto. Cada slot especifica uma categoria e uma tag — o sistema apresenta ao cliente apenas os produtos que correspondam a ambas. É aqui que se constrói a lógica de um menu.
Regra fundamental: Um slot de composição filtra produtos pela combinação de Categoria + Tag. Para que um produto apareça como opção num slot, tem de ter a mesma categoria e a mesma tag que esse slot define. Se faltar um dos dois, o produto não aparece.
2

Ordem de criação — o que fazer primeiro

Tags e categorias têm de existir antes de serem usadas num produto ou numa composição. Sempre que precisar de criar um novo produto ou menu, confirme que as tags e categorias necessárias já existem — pode ter uma aba do backoffice aberta para as criar em simultâneo.

1º Tags
Criar as etiquetas necessárias
2º Categorias
Criar os grupos de produtos
3º Produtos
Criar produtos simples e filhos
4º Composição
Criar o produto pai e os slots
Dica prática: Abra duas abas do backoffice em simultâneo — uma para criar o produto, outra para criar tags ou categorias que ainda não existam. Não precisa de voltar atrás para criar tudo antes de começar.
3

Tags

As tags são etiquetas em formato de código que identificam o papel de um produto no sistema. São o mecanismo que permite a um slot de composição saber quais produtos deve apresentar como opção ao cliente.

Backoffice › Tags

Cada tag é um código curto, geralmente em formato snake_case (palavras ligadas por underscore, sem espaços, sem acentos). Por exemplo: acomp_med, molho, bebida_menu.

Campos do formulário de Tag

CampoObrig.?Descrição
Tag Obrigatório O código da tag. Use sempre formato snake_case: minúsculas, sem espaços, sem acentos, palavras separadas por underscore. Ex: acomp_med
Ordem Opcional Define a prioridade de apresentação quando várias tags aparecem listadas. Número mais baixo = aparece primeiro.
Ativo Obrigatório Se a tag está disponível para ser usada. Uma tag inativa não aparece para seleção nos produtos ou composições.
Atenção à nomenclatura: O código da tag tem de ser exatamente igual no produto e no slot de composição. acomp_med e Acomp_Med são tags diferentes. Use sempre minúsculas e seja consistente na nomenclatura que escolher.

Criar uma nova tag

1
Aceda a Backoffice → TagsClique em "Novo +" no canto superior direito.
2
Preencha o campo TagEscreva o código em snake_case. Pense num nome descritivo e curto que identifique o papel do produto — por exemplo sobremesa_menu para sobremesas incluídas em menus.
3
Defina a Ordem e o estado AtivoColoque Ativo: Sim para que a tag fique disponível de imediato.
4
Clique em GuardarA tag fica disponível para ser atribuída a produtos e usada em slots de composição.
4

Categorias

As categorias organizam os produtos em grupos. São usadas tanto na apresentação ao cliente (site e callcenter) como na lógica interna de composição. Uma categoria pode ser visível no site mas invisível no callcenter, ou existir apenas como agrupador interno sem aparecer em nenhum canal.

Backoffice › Loja › Categorias

Campos do formulário de Categoria

CampoObrig.?Descrição
NomeObrigatórioO nome da categoria. Aparece no site e no callcenter conforme as definições de visibilidade.
DescriçãoOpcionalTexto descritivo da categoria, visível para o cliente.
OrdemOpcionalDefine a sequência de apresentação das categorias na interface. Número mais baixo = aparece primeiro.
AtivoObrigatórioSe a categoria está ativa. Uma categoria inativa não aparece em nenhum canal.
Visível no SiteOpcionalControla se a categoria aparece no site/app para o cliente. Pode estar ativa mas invisível — útil para categorias usadas apenas internamente na composição.
Visível no CallcenterOpcionalControla se a categoria aparece na interface de callcenter, de forma independente do site.
ImagemOpcionalImagem representativa da categoria, apresentada no site.
Categorias invisíveis: Uma categoria pode ter Visível no Site: Não e Visível no Callcenter: Não e ainda assim ser essencial — é usada como agrupador interno nos slots de composição. O cliente nunca a vê diretamente, mas o sistema usa-a para filtrar as opções dos menus. Exemplo: "Acompanhamentos Invisíveis".

Criar uma nova categoria

1
Aceda a Backoffice → Loja → CategoriasClique em "Novo +" no canto superior direito.
2
Preencha o NomeUse um nome claro que identifique o grupo de produtos. Se for uma categoria interna, pode usar um nome descritivo como "Molhos de Composição".
3
Configure a visibilidadeDecida se a categoria aparece no site, no callcenter, em ambos, ou em nenhum (categoria puramente interna).
4
Defina a Ordem e clique em GuardarA categoria fica disponível para ser atribuída a produtos.
5

Produtos

Um produto é qualquer item do catálogo — desde um artigo simples vendido individualmente até um menu completo com escolhas personalizadas. Antes de criar um produto, confirme que a categoria e as tags que vai atribuir já existem.

Backoffice › Loja › Produtos

Campos do formulário de Produto

CampoObrig.?Descrição
NomeObrigatórioNome do produto tal como aparece no site e no callcenter.
CategoriaObrigatórioA categoria a que pertence. Deve já existir antes de criar o produto. Campo com autocomplete.
PreçoObrigatórioPreço de venda ao público. Para produtos componentes de menus (filhos), este é o preço individual do produto — o preço adicional cobrado no menu é definido na Composição.
LojasOpcionalAs lojas onde o produto está disponível. Se não selecionar nenhuma, o produto não aparece em nenhuma loja.
Plataformas de entregaObrigatórioOs canais onde o produto aparece: delivery, takeaway, FH-Takeaway, FH-Delivery, Plataformas. Sem pelo menos uma plataforma selecionada, o produto não aparece em nenhum canal.
TagsOpcionalAs etiquetas que identificam o papel do produto. São usadas pelos slots de composição para filtrar este produto. Um produto pode ter várias tags — aparece em todos os slots que correspondam a qualquer uma delas.
PeríodosOpcionalSe o produto está disponível ao Almoço, ao Jantar, ou em ambos.
Dias da semanaOpcionalDias específicos em que o produto está disponível. Útil para promoções ou produtos sazonais.
AtivoOpcionalSe o produto está visível e disponível para encomenda. Um produto inativo não aparece aos clientes.
OrdemOpcionalPosição de apresentação dentro da categoria. Número mais baixo = aparece primeiro.
DescriçãoOpcionalDescrição curta do produto, visível na listagem.
Descrição longaOpcionalDescrição detalhada, visível na página de detalhe do produto.
Nota rodapéOpcionalNota adicional apresentada no rodapé da página do produto.
ImagemOpcionalFotografia do produto. Recomendado para todos os produtos visíveis ao cliente.
Peso / VolumeOpcionalPeso do produto e volume que ocupa na caixa de entrega — usados para cálculos logísticos.
Unidade de incrementoOpcionalO passo de quantidade ao adicionar ao carrinho. Por defeito é 1.
Unidade produtoOpcionalA unidade de medida apresentada ao cliente (ex: "un", "kg").
Hot / Saco / VOLTAEspecialCampos com comportamentos específicos — ver secção 6 para descrição detalhada.

Criar um novo produto

1
Confirme que categoria e tags já existemVerifique nos módulos Tags e Categorias. Se necessário, crie-as numa aba separada antes de continuar.
2
Aceda a Backoffice → Loja → Produtos e clique em "Novo +"Será aberto o formulário de criação.
3
Preencha Nome, Categoria e PreçoCampos obrigatórios. A categoria deve já existir — use o autocomplete para a encontrar.
4
Selecione as Plataformas de entregaCampo obrigatório. Sem plataformas, o produto não aparece em nenhum canal.
5
Atribua as Tags necessáriasSe este produto vai aparecer como opção num menu, atribua as tags correspondentes aos slots onde deve aparecer.
6
Configure os restantes campos e clique em GuardarO produto fica disponível no catálogo e poderá ser referenciado na Composição.
Usar Copiar para criar variações: Se precisar de criar vários produtos semelhantes (ex: Arroz P, Arroz M, Arroz G), crie um, guarde, e use a acção Copiar no menu ⚙️. Ajuste apenas o nome, preço e tags necessários.
6

Campos especiais do produto

Três campos do formulário de produto têm comportamentos específicos que afetam a operação, a cozinha e a interface do cliente. Por defeito, os três estão a Não — apenas ative os que se aplicam.

Hot
Padrão: Não
Indica que o produto requer preparação adicional na cozinha. No ecrã de cozinha, estes produtos aparecem a vermelho e exigem um checkmark de confirmação antes de seguirem para entrega. Usado tipicamente em pratos que necessitam de tempo extra de preparação ou atenção especial.
É um saco?
Padrão: Não
Marca o produto como obrigatório e automático. Quando ativo, o produto é adicionado automaticamente ao carrinho do cliente e não pode ser removido — mesmo que o cliente tente apagá-lo, o sistema volta a adicioná-lo. Usado para embalagens ou sacos de entrega com custo obrigatório.
VOLTA
Padrão: Não
Identifica produtos com tara retornável (Sistema VOLTA em Portugal). Quando ativo, é necessário indicar o código de taxa do POS correspondente. O produto mostra na interface do site uma indicação de embalagem retornável, informando o cliente sobre o depósito.
Hot está habitualmente a Não. Só ative para produtos que genuinamente requerem sinalização especial na cozinha. Ativar desnecessariamente cria ruído no ecrã de cozinha e atrasa o processo de validação.
7

Composição

A Composição é o módulo que transforma um produto simples num menu com escolhas. Define os momentos em que o cliente faz seleções — por exemplo, escolher o ponto do frango, selecionar acompanhamentos, ou adicionar molhos. Cada momento de escolha é um slot.

Backoffice › Loja › Composição
Antes de criar slots de composição, o produto pai (o menu) e todos os produtos filhos (as opções de escolha) têm de já existir. Tags e categorias também têm de estar criadas. A composição é sempre o último passo.

Campos do formulário de Composição

CampoObrig.?Descrição
ProdutoObrigatórioO produto pai — o menu ao qual este slot pertence. Por exemplo: "Menu 2 Frangos".
CategoriaObrigatórioA categoria dos produtos disponíveis para escolha neste slot. O sistema filtra por esta categoria em conjunto com a Tag.
OrdemObrigatórioA sequência em que este slot aparece ao cliente. O slot com Ordem 1 é apresentado primeiro.
Quantidade MínimaObrigatórioO mínimo de opções que o cliente tem de selecionar. Se for 1, a escolha é obrigatória. Se for 0, é opcional.
Quantidade MáximaObrigatórioO máximo de opções que o cliente pode selecionar. Para escolha única, coloque 1. Para múltipla escolha, coloque o número máximo permitido.
Preço UnitárioObrigatórioDefine se os produtos deste slot têm custo adicional:
0 — incluído no preço do menu, sem custo extra.
-1 — cobra o preço do produto selecionado ao preço individual.
TagsOpcionalA tag que filtra os produtos dentro da categoria. Só aparecem os produtos que tenham esta tag atribuída. Se não definir tag, aparecem todos os produtos da categoria.
DescriçãoOpcionalTexto apresentado ao cliente no momento da escolha. Ex: "Escolha os seus 2 acompanhamentos:"
Compra rápidaOpcionalSe ativo, permite ao cliente adicionar este componente sem entrar no detalhe do produto.
Quantidade ofertaOpcionalQuantidade disponível como oferta neste slot.
Resumo do Preço Unitário: Use 0 quando o produto está incluído no preço do menu (ex: o acompanhamento faz parte do menu). Use −1 quando o produto tem custo adicional e o sistema deve cobrar o preço individual do produto (ex: molhos extra, batatas extra, itens opcionais).

Como criar um slot de composição

1
Aceda a Backoffice → Loja → Composição e clique em "Novo +"Cada slot é um registo independente na composição.
2
Selecione o Produto paiO menu ao qual este slot pertence. Use o autocomplete para o encontrar pelo nome.
3
Defina a Categoria e a TagA combinação Categoria + Tag determina quais produtos o cliente verá como opção. Os produtos filhos têm de ter exatamente esta categoria e esta tag para aparecerem.
4
Configure Qtd. Mínima, Qtd. Máxima e Preço UnitárioMínimo 0 = opcional. Mínimo 1 = obrigatório. Preço 0 = incluído. Preço −1 = cobra o preço do produto.
5
Adicione a Descrição para o cliente e defina a OrdemA descrição aparece no momento da escolha. A ordem determina a sequência dos slots no fluxo de personalização.
6
Clique em Guardar e repita para cada slotCada momento de escolha é um slot separado. Um menu complexo pode ter vários slots.

Exemplo real — Menu 2 Frangos

Este menu tem 9 slots de composição que guiam o cliente pelas escolhas de personalização:

Menu 2 Frangos — 25,50€
9 slots de composição · Categoria: Menus
1
Ponto do 1º Frango
Ponto do Frango 1 de 1 Incluído sem tag — todos os produtos da categoria
2
Molho do 1º Frango
Molhos de Composição molho 1 de 1 Incluído
3
Picante no 1º Frango
Molhos de Composição picante 1 de 1 Incluído
4
Ponto do 2º Frango
Ponto do Frango 1 de 1 Incluído sem tag — todos os produtos da categoria
5
Molho do 2º Frango
Molhos de Composição molho 1 de 1 Incluído
6
Picante no 2º Frango
Molhos de Composição picante 1 de 1 Cobra preço do produto
7
Acompanhamentos
Acompanhamentos Invisíveis acomp_med 2 de 2 Incluído
8
Molhos extra
Molhos 1 a 2 Cobra preço do produto sem tag — todos os produtos da categoria
9
Batatas fritas extra
Extra Batatas 1 a 2 Cobra preço do produto sem tag — todos os produtos da categoria
8

O ciclo completo — do produto filho ao menu

Este é o percurso completo que explica como um produto filho aparece como opção de escolha num menu. O exemplo usa o Arroz M no slot de Acompanhamentos do Menu 2 Frangos.

Produto filho — Arroz M
Categoria: Acompanhamentos Invisíveis
Tags: menu2 acomp_teste acomp_med
Preço individual: 3,75€ (só cobrado se o slot tiver Preço −1)
Slot de Composição nº 7 — Acompanhamentos
Produto pai: Menu 2 Frangos
Categoria do slot: Acompanhamentos Invisíveis corresponde
Tag do slot: acomp_med corresponde
Qtd. mín/máx: 2 / 2 · Preço unitário: 0 (incluído no menu)
Produto pai — Menu 2 Frangos
Categoria: Menus · Preço total: 25,50€
O Arroz M aparece como uma das opções de acompanhamento porque a sua categoria e a tag acomp_med coincidem com as do slot.
Um produto filho pode aparecer em vários menus. O Arroz M tem a tag acomp_med e a categoria "Acompanhamentos Invisíveis" — por isso aparece automaticamente em qualquer menu que tenha um slot com essa mesma combinação categoria + tag. Não é necessário ligar o produto a cada menu individualmente.
Se um produto não aparece como opção no menu, verifique:
1. O produto tem a categoria correta?
2. O produto tem a tag correta atribuída?
3. O produto está Ativo?
4. O produto tem as Plataformas de entrega configuradas?
Todos os quatro têm de estar corretos em simultâneo.
9

Gerir a listagem de produtos

A listagem de produtos permite pesquisar, filtrar e realizar ações rápidas sobre o catálogo sem entrar em cada produto individualmente.

Filtros disponíveis

FiltroO que permite encontrar
LojaProdutos disponíveis numa loja específica.
CategoriaTodos os produtos de uma categoria.
Métodos de entregaProdutos disponíveis em delivery, takeaway, etc.
ImagemProdutos com ou sem imagem atribuída — útil para identificar o que falta fotografar.
SincronizarProdutos com ou sem código de sincronização com sistema externo.
TagProdutos com uma tag específica — útil para gerir grupos de componentes.
AtivoProdutos ativos ou inativos.

Ações disponíveis por produto (menu ⚙️)

AçãoO que faz
EditarAbre o formulário completo de edição do produto.
Ativar / DesativarAltera o estado ativo sem entrar no formulário. Ação rápida para ligar ou desligar um produto.
CopiarDuplica o produto com todos os seus campos. Útil para criar variações (ex: tamanhos diferentes do mesmo produto).
Apagar imagemRemove a imagem do produto sem apagar o produto em si.
ApagarElimina o produto permanentemente. Esta ação é irreversível.

Botão Sincronizar global

O botão Sincronizar no topo direito da listagem é exclusivo para clientes com integração com sistema externo (POS/caixa). Se não tiver esta integração, não precisa de utilizar este botão.

10

Boas práticas

Crie na ordem certa
Tags → Categorias → Produtos filhos → Produto pai → Slots de composição. Respeitar esta ordem evita bloqueios.
Duas abas em simultâneo
Abra o backoffice em duas abas — uma para o produto, outra para criar tags ou categorias que ainda não existam.
Use Copiar para variações
Para produtos semelhantes, crie um e use a ação Copiar. Ajuste apenas os campos que diferem (nome, preço, tags).
Nomenclatura consistente
Tags em snake_case, sempre minúsculas. Uma tag com nome diferente é uma tag diferente — o sistema não as liga automaticamente.
Prefira desativar a apagar
Um produto desativado pode ser reativado. Um produto apagado é permanente e pode quebrar composições existentes que o referenciem.
Imagem em todos os visíveis
Use o filtro "Imagem: Não" na listagem para identificar produtos sem fotografia. Produtos sem imagem têm menor taxa de conversão.
Não apague produtos que façam parte de composições activas. Se um produto filho for apagado, os menus que o incluem como opção ficam com um slot em falta. Desative o produto em vez de o apagar — o cliente deixa de o ver, mas a estrutura do menu mantém-se íntegra.
Em caso de dúvida, contacte o suporte antes de fazer alterações a composições ativas. Uma configuração incorreta pode afetar o fluxo de encomenda dos clientes.

Telefone / WhatsApp: +351 211 519 969 · Seg–Dom, 9h às 23h
Manual de Gestão de Produtos · Backoffice 2026