Cadastro de passaporte
O passaporte é o tipo de ingresso que o cliente escolhe: “Adulto”, “Infantil”, “VIP”, “Pacote 3 dias”.
Onde fica
Menu lateral → Passaportes → Novo passaporte.
Quem pode manter
passports.manage para criar, editar e arquivar; passports.view para consultar.
Campos
| Campo | Obrigatório | Descrição | Formato ou exemplo | Observações |
|---|---|---|---|---|
| Nome * | sim | Como o ingresso aparece para o cliente. | “Adulto”, “Infantil”, “VIP” | Único por atração, sem diferenciar maiúsculas. Erros: “Nome é obrigatório” e “Já existe um passaporte com este nome nesta atração.” |
| Atração * | sim | A qual atração o ingresso pertence. | Seleção | A atração precisa ter “aceita passaportes” ligada. Erro: “Selecione uma atração”. |
| Status * | sim | Interruptor de venda. | Ativo · Inativo | Padrão: Ativo. Só ingressos ativos aparecem na loja. |
| Descrição | não | Explicação exibida junto da oferta. | “Válido para maiores de 12 anos.” | Texto livre. |
| Preço base | não (na prática, sim) | Valor de referência quando nenhuma regra de preço se aplica. | 0,00 |
Sem preço base e sem regra, o ingresso fica “Preço indisponível” e não vende. Para pacote, o rótulo muda para “Preço do pacote”. Erro: “Preço inválido”. |
| Gera voucher | não | Se emite ingresso com código e QR ao vender. | Ligado por padrão | Desligado, a venda acontece sem emitir ingresso. |
| Consome capacidade | não | Se cada unidade ocupa uma vaga da ocorrência. | Ligado por padrão | Desligue para categorias isentas (por exemplo, criança de colo). |
| Tipo de consumo * | sim | Se vale para uma data ou para várias. | Padrão (1 ocorrência) · Pacote (várias ocorrências) | Padrão: Padrão. |
| Ocorrências do pacote | sim (quando tipo = pacote) | Quais datas estão incluídas. | Seleção múltipla de ocorrências | Só aparece quando o tipo de consumo é Pacote. Gera um voucher por data. |
O que acontece ao salvar
- O ingresso passa a ser vendável nas datas da atração, desde que esteja ativo e tenha preço calculável.
- Se for pacote, as datas vinculadas passam a compor a oferta.
- As regras de preço criadas para ele passam a valer imediatamente.
- Autor e data ficam registrados na auditoria.
O que impede a conclusão
- Nome em branco ou repetido dentro da mesma atração.
- Atração não escolhida.
- Preço negativo ou não numérico.
- Atração com “aceita passaportes” desligada — erro
attraction_no_passport, exibido sem tradução.
Como arquivar e o que isso causa
Aqui o sistema avisa, mas não bloqueia
Diferente de atrações e ocorrências, arquivar um passaporte com ingressos vendidos é permitido — o sistema apenas alerta. Foi uma decisão de produto. Os vouchers já emitidos continuam válidos.
- Arquivado, o passaporte some da listagem ativa e pode ser restaurado.
- Não há exclusão definitiva: vouchers e itens de venda continuam apontando para ele.
- Para tirar de venda temporariamente, prefira o status Inativo.
Relacionamentos
- Atração — dona do passaporte.
- Regras de preço — penduradas nele; resolvem o valor do dia.
- Ocorrências — fornecem data e capacidade; no pacote, ficam vinculadas.
- Vouchers e vendas — histórico que impede a exclusão.
Exemplos de preenchimento (fictícios)
Ingresso comum
| Nome | Adulto |
|---|---|
| Atração | Piscinas |
| Status | Ativo |
| Preço base | R$ 90,00 |
| Gera voucher | Ligado |
| Consome capacidade | Ligado |
| Tipo de consumo | Padrão |
Pacote de vários dias
| Nome | Passaporte 3 dias |
|---|---|
| Atração | Festival Exemplo |
| Preço do pacote | R$ 240,00 |
| Tipo de consumo | Pacote |
| Ocorrências do pacote | 18/01/2027, 19/01/2027, 20/01/2027 |
| Resultado da venda | 3 vouchers, um por data, cada um consumindo a capacidade do seu dia |