Produtos
Produtos são itens comerciais simples — sem data, sem capacidade e sem ocorrência própria — vendidos junto das atrações: pipoca, foto impressa, aluguel de armário, seguro.
Produto ou atração?
Se o item tem data, capacidade, ocorrência, acesso ou controle operacional próprio, ele é uma atração (que pode ser oferecida como complemento). Se é um item comercial simples, é um produto.
Quem pode acessar
products.view— ver produtos e categorias.products.manage— criar, editar, arquivar e movimentar estoque.
Como acessar
Menu lateral → Produtos. O submenu Categorias organiza o catálogo.
Visão geral da tela
Listagem com busca, filtros, seletor de colunas e listas salvas de sistema: Todos, Ativos, Inativos, Com retirada, Operacionais, Digitais, Com estoque controlado, Esgotados e Excluídos.
Tipos operacionais
O tipo define como o item é entregue e se ele obriga a emissão de voucher.
| Tipo | Significado | Voucher |
|---|---|---|
| Simples | Item entregue na hora, sem controle adicional. | Opcional |
| Com retirada | O cliente retira depois, em um balcão. | Obrigatório (tipo retirada) |
| Operacional | Item de controle interno da operação. | Obrigatório (tipo operacional) |
| Digital | Entrega digital. | Obrigatório (tipo digital) |
Vouchers de produto não consomem a capacidade do parque e são validados por retirada: valem pelo status, independentemente da data. Produto com “gera voucher” desligado não emite ingresso algum.
Onde o produto é vendido
Duas chaves independentes controlam a exposição:
- Vendido online — aparece no checkout público.
- Vendido no PDV — aparece na frente de caixa.
O produto pode ainda ser vinculado a uma atração, o que exige que a atração esteja com “aceita produtos” ligada.
Controle de estoque
- A opção controla estoque habilita o acompanhamento de saldo.
- O saldo é alterado por movimentações, com razões: ajuste manual, venda, cancelamento e outros.
- Produtos sem saldo aparecem na lista salva Esgotados.
Categorias
Categorias organizam o catálogo (Alimentação, Suvenir, Serviços). Têm nome, status, descrição e ordem de exibição, e também usam arquivamento em vez de exclusão. Todo produto pertence a uma categoria — o campo é obrigatório.
Regras de negócio
- Nome e categoria são obrigatórios; o preço base também.
- Preço negativo é recusado.
- SKU é opcional, mas quando informado deve ser exclusivo.
- Tipos com retirada, operacional e digital forçam a emissão de voucher.
- Vincular a uma atração exige a flag “aceita produtos” naquela atração (
attraction_no_products). - Arquivamento em vez de exclusão, preservando o histórico de vendas.
- Imagem segue o mesmo limite das demais: JPG, PNG, WEBP ou GIF, até 5 MB.
Passo a passo: cadastrar um produto
- Crie a categoria, se ainda não existir (Produtos → Categorias).
- Clique em Novo produto e informe nome e categoria.
- Escolha o tipo operacional. Ele determina se o voucher é obrigatório.
- Defina o preço base e o status.
- Marque onde ele é vendido: online, no PDV ou nos dois.
- Vincule a uma atração, se fizer sentido (exige a flag na atração).
- Ative o controle de estoque, se houver quantidade limitada, e lance o saldo inicial.
- Salve e confira como o item aparece na loja.
Erros e dúvidas comuns
| Mensagem | Causa | Solução |
|---|---|---|
| Nome é obrigatório | Campo em branco | Preencher |
| Selecione uma categoria | Categoria não escolhida | Escolher ou criar a categoria |
| Preço inválido | Valor negativo ou não numérico | Corrigir |
attraction_no_products | A atração não aceita produtos | Ligar a flag na atração |
| Produto não aparece na loja | Status inativo ou “vendido online” desligado | Revisar status e canal |
Boas práticas
- Use o SKU para conciliar com sistemas de estoque externos.
- Ative o controle de estoque só onde houver contagem real — ele exige disciplina de lançamento.
- Nomeie pensando no cliente final; o nome aparece no carrinho e no voucher.
- Revise periodicamente os esgotados para não deixar item indisponível na vitrine.