Manual de Uso - Eventaria Painel Administrativo
Guia completo de uso do painel: atendimento, pedidos, eventos, usuários e validação de ingressos.
Sumário
- O que é este painel
- Acesso, login e segurança
- Como navegar
- Visão Geral
- Pedidos
- Chargebacks
- Operações de pedidos
- Ingressos
- Eventos
- Cadastros de apoio (Criação)
- Cupons
- Usuários
- Validação na porta
- Relatórios financeiros
- Configurações do sistema
- Situações comuns (passo a passo)
- Regras de tempo e limites úteis
- Boas práticas e cuidados
- Glossário
1. O que é este painel
O Painel Administrativo Eventaria é a ferramenta interna para gerenciar a operação de venda de ingressos:
- Consultar e resolver problemas em pedidos e pagamentos
- Tratar chargebacks, integridade financeira e solicitações de cancelamento
- Acompanhar a saúde de pagamentos (alertas de pendência e recusas)
- Emitir cortesias, fazer vendas manuais e acompanhar ingressos
- Configurar eventos, sessões, setores e mapas de assentos
- Atender consumidores e gerenciar produtores, operadores e administradores
- Acompanhar validação de ingressos na entrada do evento
- Consultar relatórios e faturamento
Importante: o que você vê no menu depende das permissões da sua conta. Se um item não aparecer, peça liberação ao seu gestor ou a um administrador — na maioria dos casos não é um erro do sistema.
2. Acesso, login e segurança
2.1 Entrar no painel
- Abra o endereço do painel no navegador (Chrome ou Edge recomendados).
- Na tela Entrar no Painel (Acesse sua conta para continuar), preencha:
- Email* (exemplo:
seu@email.com) - Senha*
- Clique em Entrar no Painel.
- Enquanto processa, o botão mostra Entrando....
Campos marcados com * são obrigatórios.
2.2 Verificação 2FA no login
Se a conta tiver autenticação em dois fatores ativa, após a senha aparece Verificação 2FA:
- Abra o aplicativo autenticador no celular (Google Authenticator, Authy, etc.).
- No campo Código de Verificação*, digite os 6 dígitos (somente números).
- Clique em Verificar Código (fica habilitado só com 6 dígitos).
- Se precisar voltar, use Voltar ao Login.
2.3 Menu do usuário (canto superior)
Clique no seu nome / menu para acessar:
| Opção | O que faz |
|---|---|
| Perfil | Abre a página de perfil |
| Segurança | Alterar senha e gerenciar 2FA |
| Sair | Encerra a sessão |
2.4 Alterar senha
- Vá em Segurança → página Segurança do Perfil.
- Em Alterar Senha, clique em Alterar.
- No modal Alterar Senha, preencha:
- Senha Atual*
- Nova Senha* (mínimo de 8 caracteres) — opcionalmente use Gerar Senha Segura
- Confirmar Senha*
- Clique em Salvar (ou Cancelar para sair sem alterar).
Mensagens comuns:
Senha atual é obrigatóriaSenha deve ter pelo menos 8 caracteresAs senhas não coincidem- Sucesso: Senha atualizada com sucesso!
2.5 Ativar autenticação em dois fatores (2FA)
- Em Segurança do Perfil, no card Autenticação de Dois Fatores, confira o status (Ativado / Desativado).
- Clique em Ativar.
- Na tela Configurar Autenticação de Dois Fatores:
- Clique em Iniciar Configuração.
- Escaneie o QR Code no aplicativo autenticador.
- Clique em Próximo Passo.
- Em Confirmar Configuração, digite o código de 6 dígitos e confirme.
- Ao final, aparece 2FA Ativado! — use Voltar para Configurações de Segurança.
2.6 Desativar 2FA
- No card Autenticação de Dois Fatores, clique para desativar (quando permitido).
- No modal Desativar 2FA, leia o aviso: Tem certeza de que deseja desativar a autenticação de dois fatores? Isso reduzirá a segurança da sua conta.
- Confirme em Desativar ou saia em Cancelar.
- Sucesso: Autenticação de dois fatores desativada com sucesso!
Dica de segurança: nunca compartilhe senha nem códigos 2FA. Sempre use Sair ao terminar o turno em computador compartilhado.
3. Como navegar
O menu lateral esquerdo organiza as áreas principais:
| Seção do menu | Itens | Uso principal |
|---|---|---|
| (topo) | Visão Geral | Resumo do dia |
| Relatórios | Financeiro → Mensal / Anual | Faturamento da operação |
| Pedidos | Pedidos, Chargebacks, Ingressos, Operações (Correções, Integridade, Pedidos de cancelamento, Saúde de pagamentos) | Atendimento, disputas e filas operacionais |
| Criação | Eventos, Contratos, Locais, Produtoras, Categorias, Cupons | Montagem e cadastros |
| Usuários | Consumidores, Produtores, Operadores, Administradores | Gestão de contas |
| Validação | Ingressos Validados, Validadores | Porta / check-in |
| Sistema | Configurações, Jobs | Manutenção, cache e jobs manuais (acesso restrito) |
Como filtrar nas listas (padrão geral):
- Preencha um ou mais campos de filtro.
- Clique em Buscar (ou equivalente).
- Para recomeçar, limpe os filtros (ícone X / limpar).
- Em listas grandes, combine evento + período de datas para acelerar.
4. Visão Geral
Menu: Visão Geral (ícone de casa)
Tela inicial com indicadores do dia:
- Ingressos Vendidos Hoje
- Faturamento Hoje
- Taxas Hoje
- Cortesias Emitidas Hoje
- Lista de Eventos (ativos / finalizados), com paginação
Como usar no início do turno:
- Abra a Visão Geral.
- Confira os números do dia.
- Clique em um evento ativo para entrar nos detalhes e operar (cortesias, vendas manuais, etc.).
5. Pedidos
Menu: Pedidos → Pedidos Título: Pedidos Subtítulo: Gerencie e visualize todos os pedidos do sistema
5.1 Lista de pedidos — passo a passo
- Abra Pedidos.
- (Opcional) escolha o modo de visualização no topo.
- Preencha os filtros necessários.
- Clique em Buscar.
- Clique no ID do pedido (ou na linha) para abrir o detalhe.
- Se precisar de planilha, use Exportar pedidos.
Se nada for encontrado: Não foram encontrados pedidos com os filtros aplicados.
Modos de visualização
| Modo | Foco |
|---|---|
| Visão Geral | Informações principais do dia a dia |
| Financeiro | Pagamentos, valores e descontos |
| Investigativo | Análise mais profunda (ex.: IP, disputa) |
| Completo | Todas as colunas disponíveis |
Filtros — o que preencher
| Campo | Como preencher / observação |
|---|---|
| ID do Pedido | Somente números. Ex.: digite o ID e busque |
| ID do Consumidor | Somente números |
| CPF | Formato 000.000.000-00 |
| Email do Consumidor | E-mail completo do cliente |
| Evento | Digite o nome do evento para localizar |
| Data inicial / Data final | Período máximo de consulta: 32 dias. Para exportar: máximo 31 dias |
| Status | Pendente, Aprovado, Entregue, Recusado, Cancelado |
| Meio de Pagamento | Cartão de Crédito, Cartão de Débito, PIX, Dinheiro, Desconhecido |
| Origem | Site, Ponto de Venda, Cortesia, Panel, Campanha |
| Ponto de Venda | Só fica disponível se Origem = Ponto de Venda e um evento estiver selecionado |
Status do pedido (significado)
| Status | Significado |
|---|---|
| Pendente | Aguardando confirmação do pagamento |
| Aprovado | Pagamento ok; ingressos ainda podem estar em processamento |
| Entregue | Ingressos gerados/entregues ao consumidor |
| Recusado | Pagamento não aprovado |
| Cancelado | Venda cancelada |
Exportar pedidos — passo a passo
- Aplique filtros (é necessário evento/sessão ou período de datas de até 31 dias).
- Clique em Exportar pedidos.
- Selecione as colunas e o formato.
- Escolha a entrega:
- Baixar agora, ou
- Enviar por e-mail (mensagem: o relatório será gerado e enviado ao seu e-mail quando estiver pronto)
- Confirme a exportação.
Se incluir colunas de ingresso (setor, assento, tipo etc.), o relatório gera uma linha por ingresso.
Colunas possíveis incluem: Pedido, Data do pedido, Nome/E-mail do consumidor, CPF, Evento, Cidade/Data do evento, Total, Desconto, Status, Pagamento, Data do pagamento, Parcelas, Origem, Ponto de Venda, Disputa, IP, Qtd. ingressos, Setor, Assento, Tipo de ingresso.
Bloqueios comuns:
Para exportar, selecione um evento/sessão ou um período de datas (máximo 31 dias).Não há pedidos com os filtros aplicados para gerar o relatório.
5.2 Detalhes do pedido
Caminho: lista de Pedidos → clique no pedido Título: Detalhes do Pedido Voltar: Voltar para Pedidos
Abas
| Aba | Para que serve |
|---|---|
| Informações | Resumo do pedido, consumidor e pagamento |
| Ingressos | Lista dos ingressos do pedido |
| Operações | Ações administrativas sensíveis |
| Histórico | Linha do tempo (ex.: pagamento, ingressos, cancelamento) |
| Correções | Desbloquear status inconsistentes (permissão especial) |
Antes de qualquer ação: leia Informações + Histórico.
Se o pedido estiver Cancelado, o motivo do cancelamento aparece no header (abaixo do status), quando informado na operação.
5.3 Operações administrativas (aba Operações)
Título da seção: Operações Administrativas Há um aviso de Operações Sensíveis — confira se está na ação correta antes de confirmar.
A) Cancelar Venda (com reembolso)
Quando usar: cancelar a venda e reembolsar o consumidor.
- Aba Operações → card Cancelar venda e reembolsar o consumidor.
- Clique em Cancelar Venda.
- No modal Cancelar Venda, leia o alerta Ação Irreversível (cancela venda, pagamento no gateway, invalida ingressos e processa reembolso).
- Em Digite o número do pedido para confirmar, informe o ID exatamente.
- Preencha o Motivo do cancelamento* (obrigatório, mínimo 10 caracteres).
- Clique em Cancelar Venda (loading: Cancelando...).
- Sucesso: Venda cancelada com sucesso.
O motivo fica registrado no pedido e aparece no header dos detalhes (junto ao status Cancelado).
A ação pode ficar bloqueada se, por exemplo:
- pedido já cancelado
- já existe chargeback
- evento passou há mais de 48 horas (exceto perfil master)
- há ingressos já validados
- status diferente de Entregue (conforme regra da tela)
Se digitar o ID errado: Número do pedido incorreto. Se o motivo tiver menos de 10 caracteres: Informe pelo menos 10 caracteres.
B) Cancelar Venda (Sem Reembolso)
Quando usar: cancelar a venda sem devolver o valor no gateway.
- Clique em Cancelar Sem Reembolso.
- Leia o alerta Ação Específica (cancela a venda, mas não cancela o pagamento no gateway).
- Digite o número do pedido para confirmar.
- Preencha o Motivo do cancelamento* (obrigatório, mínimo 10 caracteres).
- Confirme em Cancelar Sem Reembolso.
- Sucesso: Venda cancelada sem cancelar pagamento no gateway.
O motivo também fica registrado e visível no header do pedido.
C) Solicitar Chargeback
Quando usar: marcar disputa de pagamento (pode gerar perda financeira).
- Clique em Solicitar Chargeback.
- No modal Disputa de Pagamento, confirme digitando o número do pedido.
- Sucesso: Chargeback solicitado com sucesso.
Regras típicas: origem Site, valor > 0 e sem chargeback prévio.
D) Encerrar Chargeback
Quando usar: a disputa operacional já foi tratada e você precisa marcar o chargeback como resolvido.
- Clique em Encerrar Chargeback.
- No modal, leia o aviso: o flag de prejuízo permanece; só a disputa operacional é marcada como resolvida.
- Confirme em Encerrar.
Disponível apenas com chargeback ativo (solicitado e ainda não encerrado). Também pode ser feito pela fila Pedidos → Chargebacks.
E) Trocar Ingresso
Quando usar: realocar para outro assento/setor/lote disponível.
- Clique em Trocar Ingresso.
- Siga os passos do modal Trocar Ingresso.
- Clique em Continuar até a revisão.
- Confirme em Confirmar realocação (loading: Processando…).
- Sucesso: Ingresso realocado com sucesso.
Disponível em geral para pedidos Entregue, origem Site/PDV e evento ainda não passado.
5.4 Correções no detalhe do pedido (aba Correções)
Introdução da aba: ações para desbloquear ou ajustar pedidos com status inconsistente.
| Ação | Botão | Quando fica disponível | O que acontece |
|---|---|---|---|
| Recuperar PIX rejeitado | Recuperar | Status Recusado, pagamento PIX, com itens e sem assentos marcados | Corrige status com base no pagamento aprovado no provedor |
| Sincronizar status | Sincronizar | Status Pendente, pagamento PIX/crédito/débito, há pelo menos 30 minutos desde a criação | Atualiza o status local conforme o gateway |
| Concluir entrega | Concluir entrega | Status Aprovado, origem Site/Cortesia/Panel/Campanha, há pelo menos 10 minutos desde a última atualização | Gera ingressos e passa o pedido para Entregue |
| Gerar arquivo de ingressos | Gerar arquivo | Status Entregue, sem arquivo (hasFile falso), há pelo menos 10 minutos desde a atualização | Gera (ou devolve) o arquivo de ingressos |
Em cada ação:
- Clique no botão do card.
- Confirme no modal (texto de confirmação específico da ação).
- Aguarde a mensagem de sucesso.
- Recarregue/confira Informações, Ingressos e Histórico.
Exemplos de motivo de bloqueio (botão desabilitado):
Disponível apenas para pedidos recusadosDisponível apenas para pagamentos PIXPedido com assentos marcadosDisponível após 30 minutos com status pendenteDisponível após 10 minutos com status aprovadoDisponível após 10 minutos sem arquivo de ingressosPedido já possui arquivo de ingressos
Toasts de sucesso típicos:
PIX rejeitado recuperado com sucesso.Status sincronizado com o gateway.Entrega concluída e ingressos gerados.Arquivo de ingressos gerado com sucesso.
6. Chargebacks
Menu: Pedidos → Chargebacks Subtítulo: Acompanhe e encerre disputas de chargeback dos pedidos
Fila dedicada aos pedidos com disputa de chargeback. Exige permissão de chargebacks.
6.1 Abas
| Aba | O que mostra | Ações |
|---|---|---|
| Ativos | Chargebacks em aberto | Encerrar |
| Resolvidos | Chargebacks já encerrados | Somente leitura |
6.2 Encerrar chargeback — passo a passo
- Abra Chargebacks → aba Ativos.
- Localize o pedido (colunas típicas: Pedido, Evento, Cliente, Valor, Status, Gateway, Chargeback em).
- Clique em Encerrar.
- Confirme no modal: O flag de prejuízo permanece; apenas a disputa operacional é marcada como resolvida.
- O pedido passa para a aba Resolvidos (aparece a coluna Encerrado em).
Também é possível encerrar no detalhe do pedido → aba Operações → Encerrar Chargeback.
7. Operações de pedidos
Menu: Pedidos → Operações
Submenu com filas operacionais. O que aparece depende das permissões da conta.
| Item | Uso |
|---|---|
| Correções | Pedidos com status inconsistente ou travado |
| Integridade | Inconsistências financeiras / de pagamento |
| Pedidos de cancelamento | Solicitações de cancelamento feitas pelo cliente |
| Saúde de pagamentos | Alertas de PIX, cartão pendente e recusas |
7.1 Correções
Menu: Pedidos → Operações → Correções Subtítulo: Resolva pedidos com status inconsistente ou travado
Use esta tela para tratar filas de pedidos com o mesmo tipo de problema (em vez de abrir um por um).
Abas disponíveis
| Aba | O que a tela diz | Ação na tabela |
|---|---|---|
| PIX rejeitados | Pedidos PIX recusados com pagamento aprovado no provedor, sem assentos marcados e após a expiração do PIX | Recuperar |
| Pagamentos travados | Pedidos ainda pendentes há tempo demais. Sincroniza o status com o gateway | Sincronizar |
| Entregas travadas | Pedidos aprovados que não concluíram a geração de ingressos | Concluir entrega |
| Ingressos pendentes | Pedidos entregues sem arquivo de ingressos. Gera o arquivo ou devolve o existente | Gerar arquivo |
A tabela mostra Pedidos elegíveis. Colunas comuns: Pedido, Data, Consumidor, Evento, Total, Gateway (e Origem nas entregas), Ações.
Passo a passo (qualquer aba)
- Abra Correções.
- Selecione a aba do problema.
- Localize o pedido na tabela (ou abra o detalhe pelo ID, se precisar conferir).
- Clique na ação da linha (Recuperar, Sincronizar, Concluir entrega ou Gerar arquivo).
- Confirme no modal.
- Aguarde o sucesso e verifique se o pedido saiu da fila / mudou de status.
Estados vazios (exemplos):
Não há pedidos PIX rejeitados elegíveis para recuperação.Não há pedidos pendentes elegíveis para sincronização.Não há pedidos aprovados elegíveis para conclusão de entrega.Não há pedidos entregues sem arquivo de ingressos.
Atenção: só execute a correção se a situação do cliente bater com a descrição da aba. Em dúvida, confirme com o time técnico ou financeiro antes.
7.2 Integridade
Menu: Pedidos → Operações → Integridade Subtítulo: Filas de pedidos com inconsistências financeiras ou de pagamento
Abas
| Aba | O que mostra | Ações |
|---|---|---|
| Cancelados sem estorno | Pedidos cancelados com pagamento ainda aprovado e sem chargeback | Tentar cancelar / Marcar estorno |
| Entregues sem pagamento | Pedidos entregues cujo pagamento já foi recusado ou estornado no gateway, mas o sistema ainda está inconsistente | Cancelar |
A) Cancelados sem estorno
- Abra a aba Cancelados sem estorno.
- Confira Pedido, Data da compra, Cancelado em, Consumidor, Evento, Pagamento, Total e Gateway.
- Escolha a ação:
- Tentar cancelar — tenta novamente o cancelamento/estorno no gateway (sujeito às mesmas regras de tempo após o evento; master pode ter exceção).
- Marcar estorno — registra no histórico que o reembolso não foi feito sobre o pedido original. Não chama o gateway.
- Em Marcar estorno, no modal Marcar estorno manual:
- Informe o Motivo do estorno* (mínimo 10 caracteres).
- Confirme.
- Sucesso típico: Estorno manual registrado com sucesso.
Use Marcar estorno quando o dinheiro já foi devolvido por outro meio (transferência, estorno avulso no gateway, etc.) e o painel precisa refletir isso.
B) Entregues sem pagamento
- Abra a aba Entregues sem pagamento.
- Localize o pedido.
- Clique em Cancelar (cancela o pedido localmente, sem chamar o gateway — o gateway já recusou/estornou).
- Confirme no modal.
Se o evento passou há mais de 48 horas, a ação pode ficar bloqueada (exceto perfil master).
7.3 Pedidos de cancelamento
Menu: Pedidos → Operações → Pedidos de cancelamento Subtítulo: Analise solicitações de cancelamento e reembolso dos clientes
Fila das solicitações feitas pelo consumidor (em geral: pedido entregue pelo site, sem ingresso validado). Exige permissão de cancelamento.
Abas
| Aba | O que mostra | Ações |
|---|---|---|
| Ativos | Solicitações em aberto | Aceitar / Rejeitar |
| Resolvidos | Já aceitos ou rejeitados | Somente leitura (Desfecho, Resolvido em) |
Passo a passo
- Abra Pedidos de cancelamento → aba Ativos.
- Confira Pedido, Evento, Cliente, Valor, Status, Gateway e Data do pedido.
- Aceitar:
- Clique em Aceitar.
- Confirme: cancela o pedido e tenta estornar o pagamento no gateway.
- Confirme em Aceitar e cancelar.
- Rejeitar:
- Clique em Rejeitar.
- Confirme: o cliente permanece com o pedido; só o pedido de cancelamento é fechado.
- Confirme em Rejeitar.
7.4 Saúde de pagamentos
Menu: Pedidos → Operações → Saúde de pagamentos Subtítulo: Alertas de PIX, cartão pendente e recusas de cartão
Painel de monitoramento automático. A tela atualiza sozinha a cada 2 minutos (e também ao focar a janela). Exige permissão de alertas de pedidos.
No topo aparece Última verificação (data/hora). Se a verificação automática ainda não rodou: Ainda sem verificação.
Cards de alerta
Cada card mostra status OK / Problema / Sem dados, a taxa (%), volumes e parâmetros da regra (janela, volume mínimo, limiar de ativação e de recuperação). Se estiver em problema, indica desde quando.
| Card | O que monitora |
|---|---|
| Cartão de crédito pendente | Créditos pendentes no site em relação aos aprovados recentes |
| PIX rejeitado | PIX rejeitados em relação aos aprovados na janela |
| Recusas imediatas de cartão → Pico (15 min) | Aumento brusco de recusas versus aprovados |
| Recusas imediatas de cartão → Sustentadas (1h) | Taxa elevada de recusas mantida ao longo de 1 hora |
Motivos de recusa imediata
Tabela abaixo dos cards com os motivos das recusas na janela atual:
| Coluna | Conteúdo |
|---|---|
| Código | Código retornado pelo gateway |
| Gateway | Provedor de pagamento |
| Quantidade | Quantas vezes o motivo apareceu |
Se não houver recusas na janela: Nenhum motivo registrado.
Como usar no dia a dia: abra a tela no início do turno e quando houver suspeita de instabilidade no gateway. Em Problema, acione o time técnico/financeiro com o tipo de alerta e o horário da verificação. A execução manual da verificação também existe em Sistema → Jobs → Saúde de pagamentos (acesso restrito).
8. Ingressos
8.1 Consulta de ingressos
Menu: Pedidos → Ingressos Subtítulo: Consulta de ingressos por código, evento, status e mais
Como buscar
- Preencha um ou mais filtros.
- Clique em Buscar.
- Abra o detalhe do ingresso desejado.
| Filtro | Opções / dica |
|---|---|
| Código | Código do ingresso |
| CPF | CPF do titular |
| Status | Todos / Ativo / Validado / Cancelado |
| Tipo de ingresso | Todos / Inteira / Meia entrada / Cortesia / Outros |
| Evento | Nome do evento |
| Setor | Aparece após selecionar evento (Todos + setores) |
| Assento | Ex.: A12, VIP-01 |
Ações
- Abrir Detalhes do Ingresso
- Validar pelo painel (se sua permissão permitir)
Quando usar: cliente não encontra o ingresso; precisa saber se já foi validado; validação pontual fora do dispositivo da porta.
9. Eventos
Menu: Criação → Eventos
9.1 Criar um evento
- Em Eventos, clique em Novo Evento.
- No modal Criar Novo Evento, informe o nome (mínimo exigido pelo sistema, 3 caracteres).
- Confirme.
- Você será redirecionado aos Detalhes do evento para completar a configuração.
9.2 Menu interno do evento
| Seção | Para que serve |
|---|---|
| Visão Geral | Resumo e ações de status |
| Configurações Gerais | Dados base do evento |
| Configurações de Sessão | Datas, pagamento e regras da sessão |
| Configurações de Setores | Setores, lotes e preços |
| Pontos de Venda | PDVs do evento (pode depender de permissão) |
| Contrato | Contrato financeiro e contrato assinado |
| Financeiro | Faturamento, repasses e lançamentos |
| Relatórios de Vendas | Análises e borderô |
| Pedidos | Pedidos daquele evento |
| Ingressos | Ingressos daquele evento |
| Cortesias | Emissão e gestão de cortesias |
| Cupons | Cupons associados |
| Ver Mapa | Mapa de assentos |
| Bloqueios de Lugares | Bloquear assentos no mapa |
| Vendas Manuais | Vender pelo painel |
9.3 Configurações Gerais — subabas
Informações · Mapa · Imagens · Local · Produtora · Categorias · Site
Pontos importantes:
- Mapa: indique se o evento tem lugares marcados ou apenas desmarcados.
- Site: destaque e prioridade na vitrine (ex.: Muito Baixa → Muito Alta).
- Classificação etária comum: Livre, 10, 12, 14, 16 ou 18 anos.
9.4 Configurações de Sessão — subabas
Informações · Datas · Pagamento · Ingressos
Aqui você define quando a sessão acontece e regras de venda/pagamento da sessão.
9.5 Controles de status / visibilidade (header do evento)
Conforme permissão, você pode usar toggles com confirmação:
| Controle | O que confirma | Resultado esperado |
|---|---|---|
| Vendas Ativas | Pausar ou Ativar o evento | Evento ativado/pausado com sucesso |
| Vendas Online | Desativar ou Ativar vendas online | Vendas online atualizadas com sucesso |
| Evento Visível | Ocultar ou Tornar Visível | Visibilidade atualizada com sucesso |
| Ver no site | Gera/abre o link público | — |
Publicar evento (quando está em rascunho)
- Se estiver incompleto, aparece Publicação bloqueada e o botão Publicar Evento fica desabilitado.
- Quando estiver pronto: Evento Pronto para Publicação!
- Confirme que o evento ficará visível e disponível para vendas.
- Clique em Publicar.
Encerrar evento
- Use o card Encerrar evento (quando as datas das sessões já passaram).
- Digite o nome do evento para confirmar.
- Clique em Encerrar.
- Sucesso: Evento encerrado com sucesso.
Cancelar evento / sessão (irreversível)
- 1 sessão: Cancelar Evento → digite o nome → confirme.
- Várias sessões: Cancelar a data selecionada → digite a data no formato DD/MM/AAAA → Cancelar esta sessão.
- Sucesso típico: Sessão cancelada com sucesso.
Só altere status com alinhamento do time de produção/comercial.
9.6 Emitir cortesia — passo a passo
- Abra o evento → Cortesias.
- Clique em Nova cortesia.
- Escolha como os ingressos serão entregues:
| Forma | Limite típico |
|---|---|
| Consumidor | até 12 ingressos |
| Link de resgate | até 50 ingressos |
| Gerar arquivo | até 50 ingressos |
- Preencha os dados do fluxo (buscar consumidor / destinatário / dados do arquivo).
- Escolha os lugares (mapa marcado ou desmarcado, conforme o evento).
- Revise o resumo.
- Confirme.
Sucesso: Cortesia criada.
Download do arquivo: pode levar até 5 minutos para ficar disponível. Se precisar regenerar código de resgate, use a confirmação Regerar código de resgate (um novo e-mail pode ser enviado).
9.7 Vendas manuais — passo a passo
Limite: até 12 ingressos por venda.
- Evento → Vendas Manuais.
- Passo 1: selecione os lugares.
- Passo 2: escolha lote/tipo por ingresso.
- Passo 3: detalhes financeiros obrigatórios:
- Origem: Site ou Ponto de venda
- Meio de pagamento: Crédito, Débito, PIX ou Dinheiro
- Se origem Site: buscar consumidor (obrigatório)
- Se origem Ponto de venda: selecionar PDV; CPF opcional (se informado, deve ser válido)
- Desconto (opcional)
- Passo 4: revise o resumo e confirme.
Sucesso: modal Venda manual concluída com o número do pedido. Opções:
- Realizar nova venda
- Ver pedido
9.8 Relatórios de vendas do evento
Seções típicas:
- Visão geral
- Vendas diárias
- Distribuição (por setor, lote, tipo, canal, cidade, pagamento, abatimentos)
- Canais (vendas online / pontos de venda)
- Borderô
Muitos relatórios permitem exportar.
9.9 Financeiro do evento
- Faturamento
- Repasses (Demonstrativo / Rebate / Movimentações)
- Lançamentos
Use no fechamento com a produtora / contrato.
10. Cadastros de apoio (Criação)
Estes cadastros alimentam a montagem dos eventos.
| Menu | O que cadastra | Botão típico de criação |
|---|---|---|
| Contratos | Modelos de contrato financeiro | Novo contrato |
| Locais | Locais / venues | Novo local |
| Produtoras | Empresas produtoras | Nova produtora |
| Categorias | Categorias do site | Nova categoria |
Fluxo geral:
- Abra a lista do cadastro.
- Clique em criar / editar.
- Preencha o formulário e salve.
- Depois, vincule o cadastro no evento (Configurações Gerais / Contrato, conforme o caso).
11. Cupons
Menu: Criação → Cupons Subtítulo típico: gerenciar campanhas de desconto Tabela: Campanhas de cupom
11.1 Filtrar campanhas
- Buscar: nome, código ou ID
- Modo do cupom: Compartilhado / Códigos únicos
- Status: Ativos / Inativos / Todos
11.2 Criar campanha — passo a passo (assistente)
- Clique em Nova campanha.
- Siga as etapas do assistente:
- Nome interno (máx. 60 caracteres)
- Modo: Compartilhado ou Códigos únicos
- Código (somente no modo compartilhado): letras/números, 3 a 16 caracteres
- Desconto: valor fixo ou porcentagem (1% a 100%)
- Validade: datas opcionais
- Escopo: site inteiro ou eventos específicos (se por eventos, selecione ao menos um)
- Tipos de ingresso (opcional)
- Regras: mínimo/máximo de ingressos, limite geral, limite por consumidor
- Confirme a criação.
Sucesso: Campanha criada. Se houver conflito de código ativo, o sistema pode oferecer Desativar campanha existente e continuar.
11.3 Detalhe da campanha
Abas:
- Geral — informações, desconto/vigência, regras e dados do sistema
- Escopo — onde vale
- Códigos — apenas no modo de códigos únicos (gerar códigos)
- Uso — acompanhamento de utilização
Toggle Campanha ativa: confirme Ativar/Desativar. Toasts: Campanha ativada. / Campanha desativada. Geração de códigos: modal Gerar códigos → sucesso Códigos gerados com sucesso.
12. Usuários
Menu: Usuários
12.1 Consumidores
Pessoas que compram no site / usam cortesias.
Detalhe — abas
| Aba | Uso |
|---|---|
| Informações | Dados cadastrais |
| Segurança | Tipos de acesso (Senha / Google), alteração de senha do consumidor |
| Operações | Ações administrativas sensíveis |
| Pedidos | Histórico de compras |
| Ingressos | Ingressos do consumidor |
Ações na lista / detalhe
| Ação | Como fazer | Confirmação / resultado |
|---|---|---|
| Ativar / Desativar | Na lista ou detalhe | Modal Desativar/Ativar Consumidor |
| Validar Email | Ação de validação | Confirma: Validar email do consumidor? |
| Autenticar como Consumidor | Aba Operações | Confirma redirecionamento → abre o site em nova aba com acesso ao perfil do consumidor |
| Bloquear Meios de Pagamento | Aba Operações | Selecione os meios → Atualizar Configurações → toast de sucesso |
| Excluir Conta | Aba Operações | Alerta Ação Irreversível → digite o CPF → Excluir Consumidor → toast de exclusão |
Use impersonação e exclusão somente com autorização e registro interno do motivo.
12.2 Produtores
Abas típicas: Informações, Segurança, Eventos, Produtoras. Use para liberar permissões por evento/produtora e gestão de segurança da conta.
12.3 Operadores
Abas típicas: Informações, Eventos. Associe o operador às sessões e defina permissões por evento.
12.4 Administradores
Além dos dados da conta, há a Visão Geral das Permissões (matriz por categorias: eventos, pedidos, usuários, etc.). Perfil master enxerga praticamente tudo, inclusive Configurações.
13. Validação na porta
Menu: Validação
13.1 Ingressos Validados
Tela: Ingressos Validados — Consulta de ingressos já validados
Use para auditar quem já entrou / foi validado.
Filtros extras comuns:
- Data de validação (de/até) — máximo 32 dias
- Dispositivo de validação
- Responsável pela validação
- Além de Código, CPF, Evento, Setor, Assento e Tipo
13.2 Validadores — criar sessão
Tela: Validadores — Sessões de validadores para eventos Tabela: Sessões de validadores
Filtros
- Buscar: código, evento, responsável...
- Sessões: Ativas (padrão) / Encerradas / Todas
Criar nova sessão — passo a passo
- Clique em Nova sessão.
- No modal Nova sessão de validador, preencha:
- Evento / Sessão*
- Setores permitidos* (selecione pelo menos um)
- Duração: 4 / 12 (padrão) / 24 / 48 horas
- Responsável*
- Confirme a criação.
- No sucesso Sessão criada:
- Informe o código no dispositivo da porta
- Use Copiar código (toast: Código copiado.)
- Opcional: Duplicar valores em novo
- Fechar
Colunas da tabela: Código, Evento, Setores, Responsável, Criado por, Device, Status (Pendente / Ativa / Revogada / Expirada), Expira, Ações.
Revogar sessão
- Na linha da sessão, clique em Revogar.
- Confirme: Tem certeza que deseja revogar esta sessão? O dispositivo não poderá mais validar...
- Clique em Revogar.
- Sucesso: Sessão revogada.
Não compartilhe códigos de validador em canais públicos (WhatsApp aberto, e-mail amplo, etc.).
14. Relatórios financeiros
Menu: Relatórios → Financeiro
14.1 Faturamento Mensal
- Abra Faturamento Mensal.
- Navegue pelo mês desejado.
- Confira os indicadores: Lucro Líquido, Receita Total, Custo Total.
- Analise as tabelas:
- Eventos do Mês
- Custos Fixos do Mês
- Receitas Fixas do Mês
- Inclua/edite/remova itens fixos conforme permissão.
- Use Exportar quando precisar do arquivo.
14.2 Faturamento Anual
- Abra Faturamento Anual.
- Selecione o ano.
- Consulte a visão consolidada.
- Exporte se necessário.
15. Configurações do sistema
Menu: Sistema → Configurações Acesso: apenas contas com permissão master
Sem permissão: Você não tem permissão para acessar as configurações do sistema.
15.1 Modo de manutenção
- Em Modo de manutenção, leia o aviso (bloqueia site de vendas e APIs públicas; expira automaticamente em 24 horas).
- Para ativar:
- Abra Ativar modo de manutenção.
- Digite exatamente
manutençãopara confirmar. - Clique em Ativar manutenção.
- Para desativar: Desativar manutenção.
Toasts: modo ativado/desativado com sucesso.
15.2 Limpar cache
Em cada item, clique em Limpar e confirme o modal:
| Opção | Efeito prático |
|---|---|
| Limpar cache geral | Próximas requisições buscam dados atualizados |
| Limpar cache de autenticação | Usuários podem precisar autenticar novamente |
| Limpar cache de relatórios | Relatórios/dashboards são recalculados |
Não use estas opções sem alinhamento com o time técnico.
15.3 Jobs (execução manual)
Menu: Sistema → Jobs Subtítulo: Execução manual de jobs de manutenção e processamento do sistema Acesso: restrito (mesma linha de Configurações / master)
Use apenas com alinhamento do time técnico. Cada item dispara um endpoint no backend após confirmação no modal.
| Job | O que faz |
|---|---|
| Limpar filas Bull | Remove jobs concluídos das filas Bull (não afeta em execução/pendentes) |
| Remover bookings expirados | Remove bookings e carrinhos expirados |
| Cancelar PIX expirados | Cancela PIX vencidos ainda pendentes |
| Remover pedidos expirados de PDV | Remove pedidos de PDV não finalizados a tempo |
| Atualizar validação de tickets | Recalcula/atualiza regras e estados de validação |
| Processar filas de wait list | Processa listas de espera |
| Remover customers sem e-mail validado | Remove consumidores que não validaram e-mail no prazo |
| Popular cache de reports | Recalcula cache de relatórios/financeiro do painel |
| Enviar resumo de integridade | Envia e-mail com resumo de problemas de integridade |
| Saúde de pagamentos | Executa a verificação de alertas (crédito pendente, PIX rejeitado, recusas). E-mail só na virada de estado |
Passo a passo: abra Jobs → clique na ação → leia o modal → confirme.
16. Situações comuns (passo a passo)
A) Cliente diz que pagou, mas o pedido está pendente ou recusado
- Pedidos → filtre por ID, CPF ou e-mail → Buscar.
- Abra o pedido → confira Informações e Histórico.
- Se for PIX recusado com pagamento ok no provedor:
- Detalhe → aba Correções → Recuperar, ou
- Operações → Correções → aba PIX rejeitados → Recuperar
- Se estiver Pendente há 30+ minutos (PIX/crédito/débito):
- Sincronizar no detalhe ou em Operações → Correções → Pagamentos travados
- Confirme a mudança de status e se os ingressos apareceram.
B) Pagou, mas não recebeu o ingresso / PDF
- Abra o pedido e veja o status.
- Se Aprovado há 10+ minutos (origens elegíveis): Concluir entrega (detalhe ou Operações → Correções → Entregas travadas).
- Se Entregue sem arquivo há 10+ minutos: Gerar arquivo (detalhe ou Operações → Correções → Ingressos pendentes).
- Oriente o cliente a conferir e-mail / área do consumidor.
C) Cliente quer cancelar a compra
- Abra o pedido (Entregue, em regra).
- Confirme a política interna (com ou sem reembolso).
- Aba Operações:
- Com reembolso → Cancelar Venda
- Sem reembolso → Cancelar Sem Reembolso
- Digite o número do pedido para confirmar.
- Informe o Motivo do cancelamento (mínimo 10 caracteres).
- Confirme a ação e verifique no Histórico se o cancelamento foi registrado.
- Confira o motivo no header do pedido (abaixo do status Cancelado).
Se o cliente solicitou cancelamento pelo site, trate também em Operações → Pedidos de cancelamento (Aceitar ou Rejeitar).
D) Trocar assento / setor
- Pedido → Operações → Trocar Ingresso.
- Siga os passos → Continuar.
- Confirmar realocação.
- Confira na aba Ingressos se o novo assento/setor apareceu.
E) Validar ingresso pelo painel
- Ingressos → busque por código ou CPF → Buscar.
- Abra o detalhe → Validar (se permitido).
- Na porta, preferencialmente use Validadores com sessão ativa no dispositivo.
F) Emitir cortesia
- Eventos → abra o evento → Cortesias → Nova cortesia.
- Escolha: Consumidor, Link de resgate ou Gerar arquivo.
- Selecione lugares, revise e confirme.
- Aguarde até 5 minutos se for baixar arquivo.
G) Venda presencial / manual pelo painel
- Evento → Vendas Manuais.
- Selecione até 12 lugares.
- Defina origem, pagamento e consumidor/PDV.
- Confirme o resumo.
- Use Ver pedido para conferência imediata.
H) Montar um evento novo
- Cadastre/confirme Local, Produtora, Categorias e Contrato (se necessário).
- Eventos → Novo Evento.
- Preencha Configurações Gerais → Configurações de Sessão → Configurações de Setores.
- Configure mapa e bloqueios, se houver lugares marcados.
- Revise contrato e financeiro.
- Publique / ative vendas somente quando estiver pronto.
I) Atendimento de conta do consumidor
- Usuários → Consumidores → busque por e-mail/CPF/nome.
- Ajuste dados, Validar Email ou bloqueie meios de pagamento, se necessário.
- Use Autenticar como Consumidor apenas para suporte autorizado.
- Excluir Conta só com autorização (confirmação por CPF).
J) Preparar a porta (validadores)
- Validação → Validadores → Nova sessão.
- Selecione evento/sessão, setores, duração e responsável.
- Copiar código e configurar no dispositivo.
- Ao final do evento ou se o aparelho for perdido: Revogar.
K) Pedido cancelado, mas o pagamento ainda está aprovado
- Operações → Integridade → aba Cancelados sem estorno.
- Se o gateway ainda pode estornar: Tentar cancelar.
- Se o reembolso já foi feito por outro meio: Marcar estorno e descreva o motivo (mín. 10 caracteres).
- Confira o histórico do pedido.
L) Chargeback / disputa de cartão
- Se for registrar a disputa: detalhe do pedido → Solicitar Chargeback.
- Para acompanhar a fila: Pedidos → Chargebacks → Ativos.
- Quando a disputa operacional estiver resolvida: Encerrar (na fila ou em Encerrar Chargeback no detalhe).
- Lembrete: encerrar não remove o flag de prejuízo.
M) Suspeita de instabilidade no gateway / muitas recusas
- Abra Operações → Saúde de pagamentos.
- Confira se algum card está em Problema e desde quando.
- Veja a tabela Motivos de recusa imediata (código, gateway, quantidade).
- Acione o time técnico/financeiro com o tipo de alerta e o horário da Última verificação.
17. Regras de tempo e limites úteis
| Situação | Regra |
|---|---|
| Sincronizar pedido pendente | Disponível após 30 minutos da criação |
| Concluir entrega | Disponível após 10 minutos com status aprovado |
| Gerar arquivo de ingressos | Disponível após 10 minutos sem arquivo |
| Cancelar venda após o evento | Em geral bloqueado após 48 horas (master pode exceção) |
| Modo de manutenção | Expira automaticamente em 24 horas |
| Download de arquivo de cortesia | Pode levar até 5 minutos |
| Filtro de datas (pedidos / validados) | Máx. 32 dias na consulta |
| Exportação de pedidos | Máx. 31 dias (ou evento/sessão) |
| Sessão de validador | Padrão 12 horas (opções 4 / 12 / 24 / 48) |
| Cortesia para consumidor | Até 12 ingressos |
| Cortesia por link/arquivo | Até 50 ingressos |
| Venda manual | Até 12 ingressos |
| Nova senha do perfil | Mínimo 8 caracteres |
| Código de cupom compartilhado | 3 a 16 caracteres alfanuméricos |
| Nome de campanha de cupom | Máximo 60 caracteres |
| Motivo de estorno manual (Integridade) | Mínimo 10 caracteres |
| Motivo do cancelamento (Cancelar Venda / Sem Reembolso) | Mínimo 10 caracteres |
| Saúde de pagamentos (atualização da tela) | Atualiza automaticamente a cada 2 minutos |
18. Boas práticas e cuidados
- Confirme a identidade do solicitante antes de alterar e-mail, CPF, cancelar venda ou excluir conta.
- Sempre leia o Histórico do pedido antes de cancelar, recuperar PIX ou sincronizar.
- Prefira filtros + data (e evento, quando souber) em vez de listas sem filtro.
- Ações financeiras e irreversíveis devem seguir o procedimento interno da empresa.
- Não compartilhe códigos de validadores nem links de autenticação como consumidor.
- Se uma ação falhar: anote ID do pedido/ingresso, horário, o que tentou e a mensagem da tela; envie ao suporte técnico.
- Se um menu “não aparece”, quase sempre é falta de permissão, não bug.
- Em correções em fila, confirme que o caso realmente pertence àquela aba antes de clicar.
- Em Integridade, use Marcar estorno só quando o reembolso já ocorreu fora do fluxo do pedido original — a ação não chama o gateway.
- Encerrar chargeback resolve a disputa operacional; o flag de prejuízo permanece.
- Jobs e limpeza de cache são ações técnicas — não execute sem alinhamento.
19. Glossário
| Termo | Significado |
|---|---|
| Pedido | Compra / venda registrada no sistema |
| Ingresso | Ticket individual gerado a partir de um pedido |
| Cortesia | Ingresso emitido sem cobrança (ou por fluxo promocional) |
| PDV / Ponto de Venda | Canal presencial ou ponto autorizado de venda |
| Gateway | Provedor externo de pagamento (PIX/cartão) |
| PIX rejeitado | Status local recusado, mas pagamento pode estar ok no provedor |
| Sincronizar status | Atualizar o status local com o que o gateway informa |
| Concluir entrega | Gerar/liberar ingressos de um pedido aprovado travado |
| Chargeback | Disputa/contestação do pagamento |
| Encerrar chargeback | Marcar a disputa operacional como resolvida (flag de prejuízo permanece) |
| Pedido de cancelamento | Solicitação do cliente para cancelar/reembolsar um pedido entregue |
| Integridade | Filas de inconsistência financeira (ex.: cancelado sem estorno) |
| Estorno manual | Registro de que o reembolso foi feito fora do pedido original (não chama o gateway) |
| Saúde de pagamentos | Painel de alertas de pendências e recusas de pagamento |
| Jobs | Tarefas de manutenção/processamento disparadas manualmente pelo painel |
| Borderô | Relatório operacional/financeiro de vendas do evento |
| Repasse | Valores a transferir conforme contrato com a produtora |
| Validador | Sessão/dispositivo usado para check-in na porta |
| 2FA | Código extra de segurança no login |
| Master | Perfil com acesso total, incluindo configurações do sistema |
| Mapa de assentos | Seleção visual de lugares (marcados) no evento |
Precisa de ajuda?
- Dúvida de processo / política (reembolso, cortesia, cancelamento): fale com seu gestor ou time financeiro/comercial.
- Dúvida de sistema / erro técnico: envie ID do pedido ou ingresso, horário, o que tentou fazer e a mensagem de erro exibida na tela.
Manual de uso do Painel Administrativo Eventaria. As telas disponíveis podem variar conforme as permissões da sua conta e atualizações do sistema.