Glossário

Vocabulário do TrackTickets. Muitos termos aparecem tanto na tela quanto nas mensagens de erro — conhecê-los encurta qualquer conversa com o suporte.

Conceitos do catálogo

Atração: A “coisa” vendável de uma empresa: Piscinas, Churrasqueiras, Show de Verão. Não carrega data nem preço; é o guarda-chuva de ocorrências, passaportes, produtos e complementos.
Ocorrência: Uma data de visita de uma atração. Manda no status do dia e na capacidade. Só existe uma ocorrência ativa por atração e data.
Passaporte: O tipo de ingresso de uma atração (Adulto, Infantil, VIP, Pacote 3 dias). Carrega o preço base e as flags de comportamento de venda.
Regra de preço: Regra pendurada em um passaporte que resolve quanto custa aquele ingresso em cada dia. Cinco tipos: fixa do passaporte, dia da semana, período, ocorrência específica e promocional.
Produto: Item comercial simples, sem data e sem capacidade própria (pipoca, foto impressa, aluguel de armário). Pode ou não gerar voucher.
Complemento: Uma atração oferecida junto de outra no checkout (“Complemente seu dia”). Tem calendário, capacidade e ingressos próprios, com título, ordem e limite de quantidade definidos no vínculo.
Pacote: Passaporte cujo tipo de consumo é package: vincula várias ocorrências e gera um voucher para cada uma delas.
Capacidade: Limite de pessoas de uma ocorrência. Só é consumida por passaportes marcados como “consome capacidade”. O sistema alterna a ocorrência entre aberta e esgotada automaticamente.
Reserva temporária (hold): Vaga segurada por um carrinho em andamento, para que duas pessoas não comprem a última entrada ao mesmo tempo.

Venda e entrega

Venda (pedido): O registro da compra: comprador, itens, subtotal, desconto, total, origem e status. Pode ter vários pagamentos.
Item da venda: Cada linha do pedido, com o preço congelado no momento da compra e o vínculo com atração, ocorrência, passaporte ou produto.
Voucher: O ingresso emitido — um por unidade de passaporte, gerado após o pagamento aprovado. Tem código de 8 caracteres, QR Code e status próprio.
Código do voucher: Oito caracteres maiúsculos, sem letras e números que se confundam (não usa I, L, O, 0 e 1). É único em toda a plataforma. O QR aponta para o endereço público /v/<código>.
Comprador × ingressante: O comprador é quem pagou; o ingressante é quem vai entrar. São vínculos separados no voucher — preencher o pré-check-in não altera o comprador.
Cortesia: Venda de total zero com motivo obrigatório, marcada como cortesia. Gera vouchers normalmente, respeita capacidade e fica fora da receita nos relatórios.
Cupom: Código de desconto gerado por uma campanha. O uso só é contabilizado quando a venda é confirmada.
Resgate: O registro de uso de um cupom. É a fonte de verdade dos limites (por código, por campanha e por CPF).
Promotor: Parceiro que divulga a loja com um link próprio (?promoter=CÓDIGO). Pode ter preço praticado diferente e recebe comissão sobre a venda.
Repasse: O pagamento da comissão ao promotor, registrado manualmente pela empresa.
Preço antecipado: Valor mais barato para compras feitas com antecedência. Compra para hoje paga o cheio; para data futura, paga o antecipado. A virada ocorre à meia-noite no fuso do parque.
Preço congelado: O valor gravado no item da venda, imutável. Mudar a regra depois não altera vendas antigas.
Preço decidido pelo servidor: Ao gravar a venda, o servidor recalcula cada item e descarta o valor enviado pela tela. Sem preço calculável, a venda não é criada.

Operação

PDV: Ponto de venda — a frente de caixa interna, em tela cheia, no endereço /pdv.
Sessão de caixa: O turno de dinheiro de um operador: abre com fundo de troco e fecha comparando o valor esperado com o contado. Só dinheiro entra no caixa.
Divergência de caixa: Diferença entre o valor contado e o esperado no fechamento. Não bloqueia, mas exige aceite do operador.
Contingência manual: Forma de pagamento usada quando a maquininha processou fora do sistema. Exige informar o identificador da transação.
PIN de supervisor: Senha numérica de 4 a 6 dígitos que libera uma ação sensível do PDV para um operador sem a permissão. Vale para um único uso e fica registrada.
Check-in: A validação da entrada no portão. Marca o voucher como usado e registra o atendimento.
Pré-check-in: Preenchimento antecipado dos dados do ingressante, feito pelo cliente por um link com validade, para agilizar a entrada.
Retirada (pickup): Modo de validação de vouchers de produto. Vale por status, independentemente da data.
Ocupação: Comparação, por ocorrência, entre ingressos gerados e check-ins realizados no dia.

Estrutura e acesso

Empresa (tenant): O cliente da plataforma. Todo dado pertence a uma empresa e nunca vaza para outra.
Impersonação: Recurso pelo qual um Super Admin opera dentro do contexto de uma empresa. Um banner deixa isso visível.
Papel de acesso: Conjunto de permissões atribuído a um usuário dentro de uma empresa. Cada usuário tem um único papel por empresa.
Permissão: Autorização nomeada no formato recurso.ação, validada no servidor.
Permissão sensível: Permissão marcada para supervisão — envolve dinheiro, dados pessoais ou acesso de terceiros.
Lista salva (vista): Combinação salva de colunas, filtros e ordenação de uma listagem. Pode ser global (toda a empresa) ou privada. As de sistema não podem ser excluídas.
Arquivar (soft-delete): Marcar um registro como removido sem apagá-lo, preservando o histórico. É reversível.
Auditoria: O rastro de quem alterou o quê e quando, exibido na aba Auditoria dos registros.
Slug da loja: O trecho do endereço que identifica a loja pública, como /loja/meu-parque.
Fuso do parque: O fuso horário configurado para a loja (padrão America/Sao_Paulo). Define o que é “hoje” em preços, disponibilidade e check-in.

Status de venda

Status	Rótulo na tela	Significa
`draft`	Rascunho	Venda iniciada e não finalizada.
`pending_payment`	Aguardando pagamento	Pedido criado, pagamento ainda não confirmado. Não gera voucher.
`paid`	Pago	Pagamento aprovado. Os vouchers foram gerados.
`cancelled`	Cancelado	Venda cancelada; os vouchers foram cancelados e a capacidade liberada.
`expired`	Expirado	O pedido perdeu a validade por falta de pagamento.
`refunded`	Reembolsado	Todos os pagamentos aprovados foram estornados.

Origem da venda: E-commerce (loja online) ou PDV (balcão). Cortesia não é origem — é um marcador da venda, que pode ter saído de qualquer um dos dois canais.

Status de voucher

Status	Significa	Observação
Pendente	Aguardando confirmação de pagamento	Estado formal; o checkout não o utiliza no dia a dia.
Ativo	Válido para uso	É o estado em que o voucher nasce, na aprovação do pagamento.
Usado	Entrada já realizada	Terminal. Não pode ser cancelado, reativado nem expirado, e trava o cancelamento da venda.
Cancelado	Invalidado por operador ou pelo cancelamento da venda	Só um administrador pode reativar.
Expirado	Data da ocorrência passou sem uso	Marcado pela rotina diária.

Status de ocorrência

Status	Vende?	Quando usar
Aberta	sim	Operação normal.
Fechada	não	Dia sem operação (feriado interno, manutenção programada).
Bloqueada	não	Data reservada para evento particular ou impedimento operacional.
Esgotada	não	Definido automaticamente quando a capacidade acaba.
Cancelada	não	Data cancelada. Bloqueada se houver venda futura.

Outros status

Contexto	Valores
Cadastros em geral	Ativo · Inativo (mais o marcador Arquivado)
Pagamento da venda	Pendente · Aprovado · Recusado · Estornado
Sessão de caixa	Aberta · Fechada
Fila de notificações	Pendente · Enviada · Falhou · Ignorada
Fatura da plataforma	Aberta · Paga · Vencida
Ambiente do gateway	Sandbox (testes) · Produção