Eventaria Manual de Uso
20/10/2026, 00:46:47

Manual de Uso

Guia prático do Painel Administrativo Eventaria - para quem usa o sistema no dia a dia.

Use o Sumário abaixo para ir direto à seção. Em celular, as tabelas podem ser roladas para o lado.

Manual de Uso - Eventaria Painel Administrativo

Guia completo de uso do painel: atendimento, pedidos, eventos, usuários e validação de ingressos.


Sumário

  1. O que é este painel
  2. Acesso, login e segurança
  3. Como navegar
  4. Visão Geral
  5. Pedidos
  6. Chargebacks
  7. Operações de pedidos
  8. Ingressos
  9. Eventos
  10. Cadastros de apoio (Criação)
  11. Cupons
  12. Usuários
  13. Validação na porta
  14. Relatórios financeiros
  15. Configurações do sistema
  16. Situações comuns (passo a passo)
  17. Regras de tempo e limites úteis
  18. Boas práticas e cuidados
  19. Glossário

1. O que é este painel

O Painel Administrativo Eventaria é a ferramenta interna para gerenciar a operação de venda de ingressos:

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

  1. Abra o endereço do painel no navegador (Chrome ou Edge recomendados).
  2. Na tela Entrar no Painel (Acesse sua conta para continuar), preencha:
  1. Clique em Entrar no Painel.
  2. 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:

  1. Abra o aplicativo autenticador no celular (Google Authenticator, Authy, etc.).
  2. No campo Código de Verificação*, digite os 6 dígitos (somente números).
  3. Clique em Verificar Código (fica habilitado só com 6 dígitos).
  4. Se precisar voltar, use Voltar ao Login.

2.3 Menu do usuário (canto superior)

Clique no seu nome / menu para acessar:

OpçãoO que faz
PerfilAbre a página de perfil
SegurançaAlterar senha e gerenciar 2FA
SairEncerra a sessão

2.4 Alterar senha

  1. Vá em Segurança → página Segurança do Perfil.
  2. Em Alterar Senha, clique em Alterar.
  3. No modal Alterar Senha, preencha:
  1. Clique em Salvar (ou Cancelar para sair sem alterar).

Mensagens comuns:

2.5 Ativar autenticação em dois fatores (2FA)

  1. Em Segurança do Perfil, no card Autenticação de Dois Fatores, confira o status (Ativado / Desativado).
  2. Clique em Ativar.
  3. Na tela Configurar Autenticação de Dois Fatores:
  4. Clique em Iniciar Configuração.
  5. Escaneie o QR Code no aplicativo autenticador.
  6. Clique em Próximo Passo.
  7. Em Confirmar Configuração, digite o código de 6 dígitos e confirme.
  8. Ao final, aparece 2FA Ativado! — use Voltar para Configurações de Segurança.

2.6 Desativar 2FA

  1. No card Autenticação de Dois Fatores, clique para desativar (quando permitido).
  2. 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.
  3. Confirme em Desativar ou saia em Cancelar.
  4. 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 menuItensUso principal
(topo)Visão GeralResumo do dia
RelatóriosFinanceiro → Mensal / AnualFaturamento da operação
PedidosPedidos, Chargebacks, Ingressos, Operações (Correções, Integridade, Pedidos de cancelamento, Saúde de pagamentos)Atendimento, disputas e filas operacionais
CriaçãoEventos, Contratos, Locais, Produtoras, Categorias, CuponsMontagem e cadastros
UsuáriosConsumidores, Produtores, Operadores, AdministradoresGestão de contas
ValidaçãoIngressos Validados, ValidadoresPorta / check-in
SistemaConfigurações, JobsManutenção, cache e jobs manuais (acesso restrito)

Como filtrar nas listas (padrão geral):

  1. Preencha um ou mais campos de filtro.
  2. Clique em Buscar (ou equivalente).
  3. Para recomeçar, limpe os filtros (ícone X / limpar).
  4. 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:

Como usar no início do turno:

  1. Abra a Visão Geral.
  2. Confira os números do dia.
  3. 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

  1. Abra Pedidos.
  2. (Opcional) escolha o modo de visualização no topo.
  3. Preencha os filtros necessários.
  4. Clique em Buscar.
  5. Clique no ID do pedido (ou na linha) para abrir o detalhe.
  6. Se precisar de planilha, use Exportar pedidos.

Se nada for encontrado: Não foram encontrados pedidos com os filtros aplicados.

Modos de visualização

ModoFoco
Visão GeralInformações principais do dia a dia
FinanceiroPagamentos, valores e descontos
InvestigativoAnálise mais profunda (ex.: IP, disputa)
CompletoTodas as colunas disponíveis

Filtros — o que preencher

CampoComo preencher / observação
ID do PedidoSomente números. Ex.: digite o ID e busque
ID do ConsumidorSomente números
CPFFormato 000.000.000-00
Email do ConsumidorE-mail completo do cliente
EventoDigite o nome do evento para localizar
Data inicial / Data finalPeríodo máximo de consulta: 32 dias. Para exportar: máximo 31 dias
StatusPendente, Aprovado, Entregue, Recusado, Cancelado
Meio de PagamentoCartão de Crédito, Cartão de Débito, PIX, Dinheiro, Desconhecido
OrigemSite, Ponto de Venda, Cortesia, Panel, Campanha
Ponto de VendaSó fica disponível se Origem = Ponto de Venda e um evento estiver selecionado

Status do pedido (significado)

StatusSignificado
PendenteAguardando confirmação do pagamento
AprovadoPagamento ok; ingressos ainda podem estar em processamento
EntregueIngressos gerados/entregues ao consumidor
RecusadoPagamento não aprovado
CanceladoVenda cancelada

Exportar pedidos — passo a passo

  1. Aplique filtros (é necessário evento/sessão ou período de datas de até 31 dias).
  2. Clique em Exportar pedidos.
  3. Selecione as colunas e o formato.
  4. Escolha a entrega:
  1. 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:

5.2 Detalhes do pedido

Caminho: lista de Pedidos → clique no pedido Título: Detalhes do Pedido Voltar: Voltar para Pedidos

Abas

AbaPara que serve
InformaçõesResumo do pedido, consumidor e pagamento
IngressosLista dos ingressos do pedido
OperaçõesAções administrativas sensíveis
HistóricoLinha do tempo (ex.: pagamento, ingressos, cancelamento)
CorreçõesDesbloquear 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.

  1. Aba Operações → card Cancelar venda e reembolsar o consumidor.
  2. Clique em Cancelar Venda.
  3. No modal Cancelar Venda, leia o alerta Ação Irreversível (cancela venda, pagamento no gateway, invalida ingressos e processa reembolso).
  4. Em Digite o número do pedido para confirmar, informe o ID exatamente.
  5. Preencha o Motivo do cancelamento* (obrigatório, mínimo 10 caracteres).
  6. Clique em Cancelar Venda (loading: Cancelando...).
  7. 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:

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.

  1. Clique em Cancelar Sem Reembolso.
  2. Leia o alerta Ação Específica (cancela a venda, mas não cancela o pagamento no gateway).
  3. Digite o número do pedido para confirmar.
  4. Preencha o Motivo do cancelamento* (obrigatório, mínimo 10 caracteres).
  5. Confirme em Cancelar Sem Reembolso.
  6. 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).

  1. Clique em Solicitar Chargeback.
  2. No modal Disputa de Pagamento, confirme digitando o número do pedido.
  3. 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.

  1. Clique em Encerrar Chargeback.
  2. No modal, leia o aviso: o flag de prejuízo permanece; só a disputa operacional é marcada como resolvida.
  3. 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.

  1. Clique em Trocar Ingresso.
  2. Siga os passos do modal Trocar Ingresso.
  3. Clique em Continuar até a revisão.
  4. Confirme em Confirmar realocação (loading: Processando…).
  5. 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çãoBotãoQuando fica disponívelO que acontece
Recuperar PIX rejeitadoRecuperarStatus Recusado, pagamento PIX, com itens e sem assentos marcadosCorrige status com base no pagamento aprovado no provedor
Sincronizar statusSincronizarStatus Pendente, pagamento PIX/crédito/débito, há pelo menos 30 minutos desde a criaçãoAtualiza o status local conforme o gateway
Concluir entregaConcluir entregaStatus Aprovado, origem Site/Cortesia/Panel/Campanha, há pelo menos 10 minutos desde a última atualizaçãoGera ingressos e passa o pedido para Entregue
Gerar arquivo de ingressosGerar arquivoStatus Entregue, sem arquivo (hasFile falso), há pelo menos 10 minutos desde a atualizaçãoGera (ou devolve) o arquivo de ingressos

Em cada ação:

  1. Clique no botão do card.
  2. Confirme no modal (texto de confirmação específico da ação).
  3. Aguarde a mensagem de sucesso.
  4. Recarregue/confira Informações, Ingressos e Histórico.

Exemplos de motivo de bloqueio (botão desabilitado):

Toasts de sucesso típicos:


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

AbaO que mostraAções
AtivosChargebacks em abertoEncerrar
ResolvidosChargebacks já encerradosSomente leitura

6.2 Encerrar chargeback — passo a passo

  1. Abra Chargebacks → aba Ativos.
  2. Localize o pedido (colunas típicas: Pedido, Evento, Cliente, Valor, Status, Gateway, Chargeback em).
  3. Clique em Encerrar.
  4. Confirme no modal: O flag de prejuízo permanece; apenas a disputa operacional é marcada como resolvida.
  5. 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.

ItemUso
CorreçõesPedidos com status inconsistente ou travado
IntegridadeInconsistências financeiras / de pagamento
Pedidos de cancelamentoSolicitações de cancelamento feitas pelo cliente
Saúde de pagamentosAlertas 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

AbaO que a tela dizAção na tabela
PIX rejeitadosPedidos PIX recusados com pagamento aprovado no provedor, sem assentos marcados e após a expiração do PIXRecuperar
Pagamentos travadosPedidos ainda pendentes há tempo demais. Sincroniza o status com o gatewaySincronizar
Entregas travadasPedidos aprovados que não concluíram a geração de ingressosConcluir entrega
Ingressos pendentesPedidos entregues sem arquivo de ingressos. Gera o arquivo ou devolve o existenteGerar 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)

  1. Abra Correções.
  2. Selecione a aba do problema.
  3. Localize o pedido na tabela (ou abra o detalhe pelo ID, se precisar conferir).
  4. Clique na ação da linha (Recuperar, Sincronizar, Concluir entrega ou Gerar arquivo).
  5. Confirme no modal.
  6. Aguarde o sucesso e verifique se o pedido saiu da fila / mudou de status.

Estados vazios (exemplos):

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

AbaO que mostraAções
Cancelados sem estornoPedidos cancelados com pagamento ainda aprovado e sem chargebackTentar cancelar / Marcar estorno
Entregues sem pagamentoPedidos entregues cujo pagamento já foi recusado ou estornado no gateway, mas o sistema ainda está inconsistenteCancelar

A) Cancelados sem estorno

  1. Abra a aba Cancelados sem estorno.
  2. Confira Pedido, Data da compra, Cancelado em, Consumidor, Evento, Pagamento, Total e Gateway.
  3. Escolha a ação:
  1. Em Marcar estorno, no modal Marcar estorno manual:
  1. 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

  1. Abra a aba Entregues sem pagamento.
  2. Localize o pedido.
  3. Clique em Cancelar (cancela o pedido localmente, sem chamar o gateway — o gateway já recusou/estornou).
  4. 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

AbaO que mostraAções
AtivosSolicitações em abertoAceitar / Rejeitar
ResolvidosJá aceitos ou rejeitadosSomente leitura (Desfecho, Resolvido em)

Passo a passo

  1. Abra Pedidos de cancelamento → aba Ativos.
  2. Confira Pedido, Evento, Cliente, Valor, Status, Gateway e Data do pedido.
  3. Aceitar:
  4. Clique em Aceitar.
  5. Confirme: cancela o pedido e tenta estornar o pagamento no gateway.
  6. Confirme em Aceitar e cancelar.
  7. Rejeitar:
  8. Clique em Rejeitar.
  9. Confirme: o cliente permanece com o pedido; só o pedido de cancelamento é fechado.
  10. 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.

CardO que monitora
Cartão de crédito pendenteCréditos pendentes no site em relação aos aprovados recentes
PIX rejeitadoPIX 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:

ColunaConteúdo
CódigoCódigo retornado pelo gateway
GatewayProvedor de pagamento
QuantidadeQuantas 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

  1. Preencha um ou mais filtros.
  2. Clique em Buscar.
  3. Abra o detalhe do ingresso desejado.
FiltroOpções / dica
CódigoCódigo do ingresso
CPFCPF do titular
StatusTodos / Ativo / Validado / Cancelado
Tipo de ingressoTodos / Inteira / Meia entrada / Cortesia / Outros
EventoNome do evento
SetorAparece após selecionar evento (Todos + setores)
AssentoEx.: A12, VIP-01

Ações

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

  1. Em Eventos, clique em Novo Evento.
  2. No modal Criar Novo Evento, informe o nome (mínimo exigido pelo sistema, 3 caracteres).
  3. Confirme.
  4. Você será redirecionado aos Detalhes do evento para completar a configuração.

9.2 Menu interno do evento

SeçãoPara que serve
Visão GeralResumo e ações de status
Configurações GeraisDados base do evento
Configurações de SessãoDatas, pagamento e regras da sessão
Configurações de SetoresSetores, lotes e preços
Pontos de VendaPDVs do evento (pode depender de permissão)
ContratoContrato financeiro e contrato assinado
FinanceiroFaturamento, repasses e lançamentos
Relatórios de VendasAnálises e borderô
PedidosPedidos daquele evento
IngressosIngressos daquele evento
CortesiasEmissão e gestão de cortesias
CuponsCupons associados
Ver MapaMapa de assentos
Bloqueios de LugaresBloquear assentos no mapa
Vendas ManuaisVender pelo painel

9.3 Configurações Gerais — subabas

Informações · Mapa · Imagens · Local · Produtora · Categorias · Site

Pontos importantes:

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:

ControleO que confirmaResultado esperado
Vendas AtivasPausar ou Ativar o eventoEvento ativado/pausado com sucesso
Vendas OnlineDesativar ou Ativar vendas onlineVendas online atualizadas com sucesso
Evento VisívelOcultar ou Tornar VisívelVisibilidade atualizada com sucesso
Ver no siteGera/abre o link público—

Publicar evento (quando está em rascunho)

  1. Se estiver incompleto, aparece Publicação bloqueada e o botão Publicar Evento fica desabilitado.
  2. Quando estiver pronto: Evento Pronto para Publicação!
  3. Confirme que o evento ficará visível e disponível para vendas.
  4. Clique em Publicar.

Encerrar evento

  1. Use o card Encerrar evento (quando as datas das sessões já passaram).
  2. Digite o nome do evento para confirmar.
  3. Clique em Encerrar.
  4. Sucesso: Evento encerrado com sucesso.

Cancelar evento / sessão (irreversível)

Só altere status com alinhamento do time de produção/comercial.

9.6 Emitir cortesia — passo a passo

  1. Abra o evento → Cortesias.
  2. Clique em Nova cortesia.
  3. Escolha como os ingressos serão entregues:
FormaLimite típico
Consumidoraté 12 ingressos
Link de resgateaté 50 ingressos
Gerar arquivoaté 50 ingressos
  1. Preencha os dados do fluxo (buscar consumidor / destinatário / dados do arquivo).
  2. Escolha os lugares (mapa marcado ou desmarcado, conforme o evento).
  3. Revise o resumo.
  4. 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.

  1. Evento → Vendas Manuais.
  2. Passo 1: selecione os lugares.
  3. Passo 2: escolha lote/tipo por ingresso.
  4. Passo 3: detalhes financeiros obrigatórios:
  1. Passo 4: revise o resumo e confirme.

Sucesso: modal Venda manual concluída com o número do pedido. Opções:

9.8 Relatórios de vendas do evento

Seções típicas:

Muitos relatórios permitem exportar.

9.9 Financeiro do evento

Use no fechamento com a produtora / contrato.


10. Cadastros de apoio (Criação)

Estes cadastros alimentam a montagem dos eventos.

MenuO que cadastraBotão típico de criação
ContratosModelos de contrato financeiroNovo contrato
LocaisLocais / venuesNovo local
ProdutorasEmpresas produtorasNova produtora
CategoriasCategorias do siteNova categoria

Fluxo geral:

  1. Abra a lista do cadastro.
  2. Clique em criar / editar.
  3. Preencha o formulário e salve.
  4. 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

11.2 Criar campanha — passo a passo (assistente)

  1. Clique em Nova campanha.
  2. Siga as etapas do assistente:
  3. Nome interno (máx. 60 caracteres)
  4. Modo: Compartilhado ou Códigos únicos
  5. Código (somente no modo compartilhado): letras/números, 3 a 16 caracteres
  6. Desconto: valor fixo ou porcentagem (1% a 100%)
  7. Validade: datas opcionais
  8. Escopo: site inteiro ou eventos específicos (se por eventos, selecione ao menos um)
  9. Tipos de ingresso (opcional)
  10. Regras: mínimo/máximo de ingressos, limite geral, limite por consumidor
  11. 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:

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

AbaUso
InformaçõesDados cadastrais
SegurançaTipos de acesso (Senha / Google), alteração de senha do consumidor
OperaçõesAções administrativas sensíveis
PedidosHistórico de compras
IngressosIngressos do consumidor

Ações na lista / detalhe

AçãoComo fazerConfirmação / resultado
Ativar / DesativarNa lista ou detalheModal Desativar/Ativar Consumidor
Validar EmailAção de validaçãoConfirma: Validar email do consumidor?
Autenticar como ConsumidorAba OperaçõesConfirma redirecionamento → abre o site em nova aba com acesso ao perfil do consumidor
Bloquear Meios de PagamentoAba OperaçõesSelecione os meios → Atualizar Configurações → toast de sucesso
Excluir ContaAba OperaçõesAlerta 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:

13.2 Validadores — criar sessão

Tela: Validadores — Sessões de validadores para eventos Tabela: Sessões de validadores

Filtros

Criar nova sessão — passo a passo

  1. Clique em Nova sessão.
  2. No modal Nova sessão de validador, preencha:
  1. Confirme a criação.
  2. No sucesso Sessão criada:

Colunas da tabela: Código, Evento, Setores, Responsável, Criado por, Device, Status (Pendente / Ativa / Revogada / Expirada), Expira, Ações.

Revogar sessão

  1. Na linha da sessão, clique em Revogar.
  2. Confirme: Tem certeza que deseja revogar esta sessão? O dispositivo não poderá mais validar...
  3. Clique em Revogar.
  4. 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

  1. Abra Faturamento Mensal.
  2. Navegue pelo mês desejado.
  3. Confira os indicadores: Lucro Líquido, Receita Total, Custo Total.
  4. Analise as tabelas:
  1. Inclua/edite/remova itens fixos conforme permissão.
  2. Use Exportar quando precisar do arquivo.

14.2 Faturamento Anual

  1. Abra Faturamento Anual.
  2. Selecione o ano.
  3. Consulte a visão consolidada.
  4. 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

  1. Em Modo de manutenção, leia o aviso (bloqueia site de vendas e APIs públicas; expira automaticamente em 24 horas).
  2. Para ativar:
  3. Abra Ativar modo de manutenção.
  4. Digite exatamente manutenção para confirmar.
  5. Clique em Ativar manutenção.
  6. 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çãoEfeito prático
Limpar cache geralPróximas requisições buscam dados atualizados
Limpar cache de autenticaçãoUsuários podem precisar autenticar novamente
Limpar cache de relatóriosRelató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.

JobO que faz
Limpar filas BullRemove jobs concluídos das filas Bull (não afeta em execução/pendentes)
Remover bookings expiradosRemove bookings e carrinhos expirados
Cancelar PIX expiradosCancela PIX vencidos ainda pendentes
Remover pedidos expirados de PDVRemove pedidos de PDV não finalizados a tempo
Atualizar validação de ticketsRecalcula/atualiza regras e estados de validação
Processar filas de wait listProcessa listas de espera
Remover customers sem e-mail validadoRemove consumidores que não validaram e-mail no prazo
Popular cache de reportsRecalcula cache de relatórios/financeiro do painel
Enviar resumo de integridadeEnvia e-mail com resumo de problemas de integridade
Saúde de pagamentosExecuta 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

  1. Pedidos → filtre por ID, CPF ou e-mail → Buscar.
  2. Abra o pedido → confira Informações e Histórico.
  3. Se for PIX recusado com pagamento ok no provedor:
  1. Se estiver Pendente há 30+ minutos (PIX/crédito/débito):
  1. Confirme a mudança de status e se os ingressos apareceram.

B) Pagou, mas não recebeu o ingresso / PDF

  1. Abra o pedido e veja o status.
  2. Se Aprovado há 10+ minutos (origens elegíveis): Concluir entrega (detalhe ou Operações → Correções → Entregas travadas).
  3. Se Entregue sem arquivo há 10+ minutos: Gerar arquivo (detalhe ou Operações → Correções → Ingressos pendentes).
  4. Oriente o cliente a conferir e-mail / área do consumidor.

C) Cliente quer cancelar a compra

  1. Abra o pedido (Entregue, em regra).
  2. Confirme a política interna (com ou sem reembolso).
  3. Aba Operações:
  1. Digite o número do pedido para confirmar.
  2. Informe o Motivo do cancelamento (mínimo 10 caracteres).
  3. Confirme a ação e verifique no Histórico se o cancelamento foi registrado.
  4. 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

  1. Pedido → Operações → Trocar Ingresso.
  2. Siga os passos → Continuar.
  3. Confirmar realocação.
  4. Confira na aba Ingressos se o novo assento/setor apareceu.

E) Validar ingresso pelo painel

  1. Ingressos → busque por código ou CPF → Buscar.
  2. Abra o detalhe → Validar (se permitido).
  3. Na porta, preferencialmente use Validadores com sessão ativa no dispositivo.

F) Emitir cortesia

  1. Eventos → abra o evento → Cortesias → Nova cortesia.
  2. Escolha: Consumidor, Link de resgate ou Gerar arquivo.
  3. Selecione lugares, revise e confirme.
  4. Aguarde até 5 minutos se for baixar arquivo.

G) Venda presencial / manual pelo painel

  1. Evento → Vendas Manuais.
  2. Selecione até 12 lugares.
  3. Defina origem, pagamento e consumidor/PDV.
  4. Confirme o resumo.
  5. Use Ver pedido para conferência imediata.

H) Montar um evento novo

  1. Cadastre/confirme Local, Produtora, Categorias e Contrato (se necessário).
  2. Eventos → Novo Evento.
  3. Preencha Configurações Gerais → Configurações de Sessão → Configurações de Setores.
  4. Configure mapa e bloqueios, se houver lugares marcados.
  5. Revise contrato e financeiro.
  6. Publique / ative vendas somente quando estiver pronto.

I) Atendimento de conta do consumidor

  1. Usuários → Consumidores → busque por e-mail/CPF/nome.
  2. Ajuste dados, Validar Email ou bloqueie meios de pagamento, se necessário.
  3. Use Autenticar como Consumidor apenas para suporte autorizado.
  4. Excluir Conta só com autorização (confirmação por CPF).

J) Preparar a porta (validadores)

  1. Validação → Validadores → Nova sessão.
  2. Selecione evento/sessão, setores, duração e responsável.
  3. Copiar código e configurar no dispositivo.
  4. Ao final do evento ou se o aparelho for perdido: Revogar.

K) Pedido cancelado, mas o pagamento ainda está aprovado

  1. Operações → Integridade → aba Cancelados sem estorno.
  2. Se o gateway ainda pode estornar: Tentar cancelar.
  3. Se o reembolso já foi feito por outro meio: Marcar estorno e descreva o motivo (mín. 10 caracteres).
  4. Confira o histórico do pedido.

L) Chargeback / disputa de cartão

  1. Se for registrar a disputa: detalhe do pedido → Solicitar Chargeback.
  2. Para acompanhar a fila: Pedidos → Chargebacks → Ativos.
  3. Quando a disputa operacional estiver resolvida: Encerrar (na fila ou em Encerrar Chargeback no detalhe).
  4. Lembrete: encerrar não remove o flag de prejuízo.

M) Suspeita de instabilidade no gateway / muitas recusas

  1. Abra Operações → Saúde de pagamentos.
  2. Confira se algum card está em Problema e desde quando.
  3. Veja a tabela Motivos de recusa imediata (código, gateway, quantidade).
  4. 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çãoRegra
Sincronizar pedido pendenteDisponível após 30 minutos da criação
Concluir entregaDisponível após 10 minutos com status aprovado
Gerar arquivo de ingressosDisponível após 10 minutos sem arquivo
Cancelar venda após o eventoEm geral bloqueado após 48 horas (master pode exceção)
Modo de manutençãoExpira automaticamente em 24 horas
Download de arquivo de cortesiaPode levar até 5 minutos
Filtro de datas (pedidos / validados)Máx. 32 dias na consulta
Exportação de pedidosMáx. 31 dias (ou evento/sessão)
Sessão de validadorPadrão 12 horas (opções 4 / 12 / 24 / 48)
Cortesia para consumidorAté 12 ingressos
Cortesia por link/arquivoAté 50 ingressos
Venda manualAté 12 ingressos
Nova senha do perfilMínimo 8 caracteres
Código de cupom compartilhado3 a 16 caracteres alfanuméricos
Nome de campanha de cupomMá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

  1. Confirme a identidade do solicitante antes de alterar e-mail, CPF, cancelar venda ou excluir conta.
  2. Sempre leia o Histórico do pedido antes de cancelar, recuperar PIX ou sincronizar.
  3. Prefira filtros + data (e evento, quando souber) em vez de listas sem filtro.
  4. Ações financeiras e irreversíveis devem seguir o procedimento interno da empresa.
  5. Não compartilhe códigos de validadores nem links de autenticação como consumidor.
  6. 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.
  7. Se um menu “não aparece”, quase sempre é falta de permissão, não bug.
  8. Em correções em fila, confirme que o caso realmente pertence àquela aba antes de clicar.
  9. 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.
  10. Encerrar chargeback resolve a disputa operacional; o flag de prejuízo permanece.
  11. Jobs e limpeza de cache são ações técnicas — não execute sem alinhamento.

19. Glossário

TermoSignificado
PedidoCompra / venda registrada no sistema
IngressoTicket individual gerado a partir de um pedido
CortesiaIngresso emitido sem cobrança (ou por fluxo promocional)
PDV / Ponto de VendaCanal presencial ou ponto autorizado de venda
GatewayProvedor externo de pagamento (PIX/cartão)
PIX rejeitadoStatus local recusado, mas pagamento pode estar ok no provedor
Sincronizar statusAtualizar o status local com o que o gateway informa
Concluir entregaGerar/liberar ingressos de um pedido aprovado travado
ChargebackDisputa/contestação do pagamento
Encerrar chargebackMarcar a disputa operacional como resolvida (flag de prejuízo permanece)
Pedido de cancelamentoSolicitação do cliente para cancelar/reembolsar um pedido entregue
IntegridadeFilas de inconsistência financeira (ex.: cancelado sem estorno)
Estorno manualRegistro de que o reembolso foi feito fora do pedido original (não chama o gateway)
Saúde de pagamentosPainel de alertas de pendências e recusas de pagamento
JobsTarefas de manutenção/processamento disparadas manualmente pelo painel
BorderôRelatório operacional/financeiro de vendas do evento
RepasseValores a transferir conforme contrato com a produtora
ValidadorSessão/dispositivo usado para check-in na porta
2FACódigo extra de segurança no login
MasterPerfil com acesso total, incluindo configurações do sistema
Mapa de assentosSeleção visual de lugares (marcados) no evento

Precisa de ajuda?


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.