Configuração inicial de uma empresa

Este é o roteiro de implantação. A ordem importa: cada etapa depende da anterior, e pular uma delas gera erros que parecem inexplicáveis.

Por que a ordem importa

Atração é portão de ocorrência e de passaporte. Passaporte é portão de regra de preço. E sem preço calculável, nada vende. Seguindo a sequência abaixo, você não esbarra nesses bloqueios.

Visão geral do roteiro

1Empresa e usuários

2Atrações

3Ocorrências

4Passaportes

5Preços

6Loja e pagamento

7Testar e abrir

Passo a passo

Empresa criada pela plataforma. A equipe Trackhouse cadastra o tenant com nome fantasia, razão social, CNPJ e o slug da loja. Ver cadastro de empresa.
Crie os usuários e defina os papéis. Comece pelo administrador da empresa e depois os operadores. Lembre-se: quem opera o balcão precisa de pos.operate e pos.manage_cash. Ver usuários e papéis.
Cadastre as atrações e — este é o ponto mais esquecido — ligue as flags de “aceita passaportes” e “aceita produtos”, que vêm desligadas. Ver cadastro de atração.
Abra as datas. Crie uma regra de recorrência com o período da temporada, os dias da semana que abrem e a capacidade padrão. Rode a prévia antes de aplicar.
Crie os passaportes de cada atração (Adulto, Infantil, Meia). Defina se cada um gera voucher e se consome capacidade. Ver cadastro de passaporte.
Defina os preços. Crie ao menos uma regra fixa do passaporte como base e depois as variações (fim de semana, alta temporada). Configure o preço antecipado se a operação usar esse modelo. Confira no calendário de preços antes de abrir a venda.
Cadastre produtos e categorias, se houver itens vendidos junto (alimentação, armário, foto). Marque os canais de venda: online, PDV ou ambos.
Configure os complementos, se uma atração deve ser ofertada junto de outra no checkout.
Ajuste a loja. Em Aparência defina logo, cores, capa e textos; em Configuração preencha slug, contatos e as políticas de compra e de cancelamento.
Conecte o pagamento. Em Integrações, configure o gateway e o parcelamento. Comece em sandbox e só depois troque para produção.
Configure as notificações. Escolha o que enviar e por qual canal. Mantenha o convite de pré-check-in ativo — é o que mais reduz fila. Ver notificações.
Defina as políticas de portão e de PDV. Em Check-in, decida se o portão coleta dados do ingressante e se exige documento. Em PDV, escolha quais ações podem ser liberadas por PIN de supervisor.
Cadastre as maquininhas que serão usadas no balcão e peça a cada supervisor que cadastre o próprio PIN em Minha conta.
Faça uma compra de teste completa na loja, em ambiente de sandbox: escolha a data, monte o carrinho, pague, receba o voucher, faça o pré-check-in e valide a entrada no portão.
Abra a loja. Coloque o status da loja como Ativa e comunique o time.

Checklist de verificação antes de abrir

Item	Como verificar
As datas aparecem no calendário da loja	Abrir a loja pública e navegar pelo mês
Nenhum ingresso está “Preço indisponível”	Selecionar uma data e conferir todos os ingressos
O preço antecipado aparece nas datas futuras	Comparar hoje × uma data futura
A capacidade está correta	Conferir a listagem de ocorrências
O pagamento conclui	Compra de teste em sandbox
O voucher chega ao cliente	Conferir o e-mail e a aba Histórico de notificações
O portão valida o voucher	Ler o QR na tela de check-in
O PDV abre e vende	Selecionar maquininha, abrir caixa e fazer uma venda
Cada operador vê o menu certo	Entrar com um usuário de cada papel
Políticas de compra e cancelamento preenchidas	Conferir na loja pública

Erros comuns na implantação

Erro	Causa	Correção
`attraction_no_passport`	Flag “aceita passaportes” desligada	Ligar a flag na atração e recriar
`attraction_no_occurrence`	Flag “gera ocorrências” desligada	Ligar a flag
`attraction_no_products`	Flag “aceita produtos” desligada	Ligar a flag
“Preço indisponível” na loja	Passaporte sem preço base e sem regra	Criar a regra fixa do passaporte
Data não aparece	Status diferente de aberta, “disponível para venda” desligada ou capacidade zero	Corrigir a ocorrência
`rule_overlap`	Duas regras de recorrência concorrentes	Ajustar período ou dias de uma delas
Operador não consegue vender no PDV	Falta `pos.manage_cash`	Conceder junto de `pos.operate`

Páginas relacionadas

Central de administração · Todos os cadastros