Dúvidas frequentes
As perguntas abaixo saíram do comportamento real do sistema. Cada resposta explica também por que o sistema age assim.
Acesso e conta
Esqueci minha senha. Como recuperar?
Na tela de login, clique em Esqueceu?, ao lado do campo de senha, e informe o e-mail da sua conta. Você receberá um e-mail com o link de redefinição. O link é temporário: se expirar, repita o processo.
Se o e-mail não chegar, confira a caixa de spam e confirme com o administrador se o endereço cadastrado está correto. O envio depende da configuração de e-mail da plataforma.
Consigo criar minha própria conta?
Não. O TrackTickets não tem cadastro público — a própria tela de login avisa isso. Um administrador da empresa (ou a equipe da plataforma) precisa criar o seu usuário e atribuir um papel de acesso.
Sumiu um item do menu. O que aconteceu?
O menu é montado a partir das suas permissões. Se o item não aparece, o seu papel não tem a permissão correspondente. Peça ao administrador para revisar o papel em Configuração → Permissões.
Digitar o endereço diretamente também não funciona: o sistema mostra a tela “Sem permissão”. Isso é intencional — esconder o menu é conforto visual; a trava real está no servidor.
Apareceu “Acesso suspenso”. E agora?
A empresa foi bloqueada pela plataforma, normalmente por fatura em atraso. Nesse estado o painel administrativo fica bloqueado, mas a venda continua: a loja online e o PDV seguem funcionando, para não parar o caixa do parque.
O administrador da empresa deve regularizar a fatura; a reativação é feita pela equipe da plataforma.
Cadastros
Como criar um novo registro?
Abra o módulo no menu lateral e use o botão de criação no topo da listagem (por exemplo Novo contato, Nova atração). Preencha os campos marcados com asterisco (*) e salve. Cada página de cadastro traz a tabela completa de campos, formatos e validações.
Como localizar um registro?
Toda listagem oferece três caminhos, do mais rápido ao mais específico:
- Busca por texto no topo da listagem (nome, descrição e campos-chave do módulo).
- Filtros avançados, que combinam condições por qualquer campo (igual a, contém, começa com, está vazio, maior ou igual, menor ou igual).
- Listas salvas, que guardam colunas, filtros e ordenação prontos — as de sistema já vêm criadas (Todos, Ativos, Inativos, Arquivados e outras específicas do módulo).
Por que não consigo excluir um item?
Há dois motivos, e os dois são propositais:
1. O sistema não exclui — ele arquiva. Cadastros usam arquivamento (soft-delete) para preservar o histórico de vendas, vouchers e relatórios, que continuam lendo o nome do registro. Registros arquivados podem ser restaurados.
2. Existem travas de integridade. As principais:
- Atração com venda futura não pode ser arquivada. A mensagem informa quantos ingressos existem: “Esta atração tem N ingresso(s) vendido(s) em datas futuras. Remarque ou reembolse essas vendas antes de arquivar.”
- Ocorrência com venda futura não pode ser cancelada nem arquivada.
- Venda com voucher já usado não pode ser cancelada nem estornada.
- Lista salva de sistema não pode ser excluída.
No caso dos passaportes, o sistema apenas avisa quando há vouchers vendidos, mas não bloqueia o arquivamento — foi uma decisão de produto.
Qual a diferença entre “Inativo” e “Arquivado”?
Inativo pausa a venda, mas o registro continua visível e utilizável no painel. Arquivado tira o registro do dia a dia: ele some da listagem principal e só aparece com o filtro de arquivados. Em ambos os casos, os ingressos já vendidos continuam válidos.
Diz que já existe um cadastro com esse nome, mas eu não encontro.
A validação de nome único considera também os registros arquivados. Use o filtro de arquivados na listagem para encontrar o registro e, se for o caso, restaurá-lo em vez de criar um novo.
No cadastro de atração há ainda um aviso de “nomes semelhantes” enquanto você digita. Esse aviso é apenas informativo e pode dar falso positivo (ele procura por trecho do nome) — quem bloqueia de fato é a validação no momento de salvar.
Como verificar se uma ação foi concluída?
- Mensagem de confirmação aparece no canto da tela logo após a ação.
- O status muda na listagem ou no detalhe (por exemplo, a venda passa a “Cancelado”).
- A aba Auditoria do registro mostra quem fez o quê e quando, campo a campo.
- O bloco “criado/atualizado por” na tela de detalhe registra autor e data.
Uma exceção conhecida: arquivar pela listagem (ação em linha ou em lote) não gera registro de auditoria — só o arquivamento feito pela tela de detalhe registra. Se a rastreabilidade importa, prefira arquivar pelo detalhe.
Preços e disponibilidade
Alterei o preço e a venda antiga não mudou. Está certo?
Sim. O preço é congelado no momento da venda. Mudanças posteriores nas regras não afetam vendas já realizadas — isso protege o histórico financeiro e os relatórios.
Por que o cliente vê um preço diferente do que eu configurei?
Três causas possíveis, nesta ordem de frequência:
- Preço antecipado. Compra para hoje paga o preço cheio; compra para data futura paga o antecipado. A virada acontece à meia-noite, no fuso do parque.
- Outra regra venceu. A regra de maior prioridade vence; em caso de empate, vale a ordem por tipo (ocorrência > promocional > período > dia da semana > fixa do passaporte) e, por último, a regra criada mais recentemente.
- Cupom, promotor ou desconto manual incidem por cima do preço já resolvido.
Use o Calendário de preços (em Passaportes → Regras de preço) para ver, dia a dia, qual regra venceu e por quê.
O passaporte aparece como “Preço indisponível”. Por quê?
Não há preço calculável para aquela data: o passaporte não tem preço base e nenhuma regra de preço se
aplica. O sistema nunca vende sem preço válido — a venda é recusada com o erro
price_unavailable. Cadastre um preço base ou uma regra que cubra o período.
A data aparece indisponível mesmo tendo vaga. O que verificar?
Para uma data ser vendável, três condições precisam ser verdadeiras ao mesmo tempo:
- a ocorrência está com status Aberta;
- a opção disponível para venda está ligada;
- há capacidade disponível maior que zero.
Também existem reservas temporárias: carrinhos em andamento seguram vagas por um tempo. Uma mesma ocorrência pode aparecer como “Disponível” na página da atração e “Esgotado” no fluxo por data, porque as duas telas contam a reserva de formas diferentes. A trava real é aplicada no momento de gravar a venda, então nunca se vende além da capacidade — mas a tela pode divergir.
Vendas, vouchers e portão
Como localizar um pedido de um cliente?
Em Vendas, busque pelo código do pedido ou pelo nome do cliente e use os filtros de status, origem e período. Se você tem só o código do ingresso, procure em Vouchers — a tela do voucher leva à venda de origem.
Como alterar o status de uma venda?
O status da venda não é editável manualmente. Ele muda como consequência de ações: aprovação do pagamento leva a Pago; cancelar leva a Cancelado; estornar leva a Reembolsado; a falta de pagamento leva a Expirado. Esse desenho evita que alguém marque como paga uma venda que não foi paga.
Por que o voucher não passa no portão?
O sistema recusa e explica o motivo. Os casos possíveis:
- Data errada. Voucher de acesso vale somente no dia da ocorrência, sem tolerância. A tela informa a data correta.
- Já utilizado. O status usado é terminal — a tela mostra quando e por qual operador foi validado. Não há reentrada.
- Cancelado ou expirado. O voucher perdeu a validade.
- Pendente. O pagamento não foi confirmado.
- Faltam dados obrigatórios. Se a empresa exige dados do ingressante ou validação de documento, a entrada só é liberada com tudo preenchido.
Vouchers de produto (modo retirada) valem por status, independentemente da data.
Dois operadores leram o mesmo QR ao mesmo tempo. E agora?
Só o primeiro efetiva a entrada. A confirmação é atômica: quem chegar depois recebe a recusa “já utilizado”. Isso impede a mesma pessoa de entrar duas vezes.
Como reenviar o voucher para o cliente?
Abra o voucher e use a ação de reenvio. O código continua o mesmo — reenviar não invalida o ingresso. Só vouchers ativos ou usados podem ser reenviados, e o envio segue a configuração de canais da empresa (e-mail e/ou WhatsApp).
O cliente quer trocar a data. Como faço?
Use a remarcação do voucher (exige a permissão vouchers.reschedule). O
sistema revalida a capacidade da nova data e recusa se não houver vaga. Se a nova data for
mais cara que o valor pago, a operação exige autorização de supervisor por PIN.
Só vouchers ativos podem ser remarcados.
Não consigo cancelar uma venda. Por quê?
Provavelmente algum voucher daquela venda já foi utilizado no portão. Nesse caso o cancelamento e o estorno ficam bloqueados, e os botões aparecem desabilitados. A entrada já aconteceu — desfazer a venda criaria inconsistência na ocupação e nos relatórios.
PDV e caixa
O PDV não deixa iniciar a venda.
O PDV só libera a venda com maquininha selecionada e caixa aberto. A tela
inicial conduz esses dois passos. Se o botão de abrir caixa não funciona, falta a permissão
pos.manage_cash ao seu papel.
O fechamento acusou divergência de caixa. Isso bloqueia?
Não. A divergência entre o esperado e o contado não impede o fechamento, mas exige um aceite explícito do operador. O valor fica registrado na sessão para conferência posterior. O caixa concilia apenas dinheiro — cartão e Pix vão direto para a adquirente.
Preciso aplicar desconto e o sistema pede PIN.
Seu papel não tem a permissão da ação, e a empresa configurou que ela pode ser liberada por PIN de supervisor. Um supervisor digita o PIN dele na própria tela — sem trocar de sessão e sem refazer o carrinho. A autorização vale uma única vez e fica registrada com operador, supervisor, ação, valor e motivo.
Relatórios
Por que os números do relatório não batem com os do dashboard?
Cada indicador usa uma âncora de data própria, e isso é intencional:
- Receita usa a data da compra.
- Ocupação e check-in usam a data da visita (a ocorrência).
- Vouchers usam a data de emissão, exceto na dimensão “gerados”, que usa a ocorrência.
Além disso, cortesias ficam fora da receita — elas aparecem no relatório de Descontos e Cortesias, com o valor de tabela.
Como funciona a comparação de período?
O sistema compara o período escolhido com a janela de mesmo tamanho imediatamente anterior. Sete dias comparam com os sete dias anteriores; um mês de 31 dias compara com os 31 dias anteriores. Quando o período anterior é zero, a variação percentual aparece como “—”.
Abri um relatório e apareceu “sem permissão”.
O menu e o hub liberam pela permissão geral reports.view, mas cada relatório tem a sua
própria permissão. A tela abre e informa a falta de acesso ao buscar os dados. Peça ao administrador a
permissão específica daquele relatório.
Dados obrigatórios e mensagens
O que fazer quando uma informação obrigatória não aparece na tela?
Alguns campos só aparecem quando outra escolha os habilita. Os casos mais comuns:
- Ocorrências do pacote só aparecem quando o tipo de consumo do passaporte é Pacote.
- Modificador e valor do modificador só aparecem em regras do tipo Promocional.
- Dias da semana só aparecem em regras do tipo Dia da semana.
- Alvo do desconto só aparece quando o escopo é atração, passaporte ou produto.
- Estoque atual só aparece quando o produto controla estoque.
- Campos de recebimento do promotor só aparecem quando há chave de repasse.
Se ainda assim o campo não aparecer, verifique se a flag da atração permite aquele comportamento (gerar ocorrências, aceitar passaportes, aceitar produtos).
Apareceu uma mensagem em inglês, com underscores. O que significa?
São códigos de erro do banco de dados que ainda não foram traduzidos na tela. Os mais comuns:
| Código | Significado |
|---|---|
attraction_no_occurrence | A atração está com “gera ocorrências” desligado. |
attraction_no_passport | A atração está com “aceita passaportes” desligado. |
attraction_no_products | A atração está com “aceita produtos” desligado. |
capacity_below_sold | Você tentou reduzir a capacidade para menos do que já foi vendido. |
rule_overlap | A regra de recorrência se sobrepõe a outra regra ativa da mesma atração. |
no_capacity | Não há vagas suficientes na ocorrência. |
price_unavailable | Não foi possível calcular o preço de algum item. |
sale_has_used_voucher | A venda tem voucher já validado no portão. |
cpf_duplicado | O mesmo CPF foi informado em dois ingressos da mesma compra. |
cash_session_required | Recebimento em dinheiro sem caixa aberto. |
divergence_requires_accept | O fechamento do caixa tem divergência e precisa de aceite. |
Ao encontrar um código que não esteja nesta lista, anote a tela e a ação e informe o suporte: isso ajuda a mapear a mensagem para um texto amigável.