Vendas
A central de atendimento do sistema. É aqui que se localiza um pedido, se entende o que o cliente comprou, como pagou e o que ainda pode ser feito com aquela venda.
Quem pode acessar
sales.view— ver a listagem e o detalhe.sales.view_report— ver os totalizadores.sales.cancelsensível — cancelar.sales.refundsensível — estornar.
Como acessar
Menu lateral → Vendas. O cabeçalho da tela descreve o módulo como “Histórico de pedidos do checkout público”, mas a listagem também traz as vendas do PDV, identificadas pela origem.
Colunas da listagem
| Coluna | O que mostra | Padrão |
|---|---|---|
| Pedido | Código do pedido, usado no atendimento. | Visível |
| Cliente | O contato comprador. | Visível |
| Status | Situação atual da venda. | Visível |
| Origem | E-commerce ou PDV. | Opcional |
| Itens | Quantidade de linhas do pedido. | Visível |
| Data | Data da compra. | Visível |
| Total | Valor final cobrado. | Visível |
Status da venda
| Status | Significa | Gera voucher? |
|---|---|---|
| Rascunho | Venda iniciada e não finalizada. | Não |
| Aguardando pagamento | Pedido criado, pagamento não confirmado. | Não |
| Pago | Pagamento aprovado. | Sim |
| Cancelado | Venda cancelada; vouchers cancelados e capacidade liberada. | — |
| Expirado | Perdeu a validade por falta de pagamento. | Não |
| Reembolsado | Todos os pagamentos aprovados foram estornados. | — |
Não existe campo para “marcar como pago”. O status muda como consequência de ações reais: aprovação de pagamento, cancelamento, estorno ou expiração. Isso protege a integridade financeira.
Origem da venda
Uma venda nasce como E-commerce (loja online) ou PDV (balcão). Cortesia não é origem — é um marcador aplicado à venda, que pode ter saído de qualquer um dos dois canais.
Detalhe do pedido
A tela de detalhe reúne:
- dados do comprador e do pedido;
- itens com quantidade, preço unitário congelado e vínculos (atração, ocorrência, passaporte ou produto);
- pagamentos — uma venda pode ter vários (dinheiro + cartão, por exemplo), cada um com forma, status, valor e identificador da transação;
- vouchers emitidos;
- ações de cancelar e estornar.
Cancelar e estornar
| Cancelar | Estornar | |
|---|---|---|
| O que faz | Marca a venda como cancelada e cancela os vouchers, liberando a capacidade. | Devolve o valor pelo meio original e, quando tudo é devolvido, marca a venda como reembolsada. |
| Permissão | sales.cancel | sales.refund |
| Confirmação | Mensagem “Venda cancelada.” | Mensagem “Estorno solicitado ao provedor.” |
| Parcial | Não | Sim, por parcela de pagamento |
Se qualquer voucher daquela venda já foi validado no portão, o cancelamento e o estorno ficam bloqueados e os botões aparecem desabilitados. O motivo é simples: a entrada já aconteceu; desfazer a venda criaria inconsistência na ocupação e nos relatórios.
No estorno, o dinheiro volta pelo meio original: recebimento em dinheiro sai do caixa; cartão e Pix voltam pela operadora; pagamento de contingência manual deve ser estornado na mesma máquina. O cancelamento total reverte o resgate do cupom; o estorno parcial não.
Passo a passo: atender um cliente com problema no pedido
- Localize a venda pelo código do pedido ou pelo nome do cliente. Se tiver só o código do ingresso, busque em Vouchers.
- Confira o status. “Aguardando pagamento” significa que o voucher ainda não existe.
- Verifique os pagamentos. Uma venda mista pode ter uma parcela aprovada e outra pendente.
- Confira os vouchers. Se algum estiver como usado, cancelamento e estorno estão bloqueados.
- Escolha a ação: reenviar o voucher, remarcar a data ou cancelar/estornar.
- Confirme o resultado pela mudança de status e pela mensagem de confirmação.
Erros e dúvidas comuns
| Situação | Motivo | Solução |
|---|---|---|
| Botões de cancelar/estornar desabilitados | Voucher já utilizado (sale_has_used_voucher) | Não há como desfazer; trate comercialmente |
| Venda paga sem voucher | Situação anormal | Verificar os pagamentos e acionar o suporte |
| Cliente não recebeu o ingresso | Falha no envio ou dado de contato errado | Reenviar pelo voucher e conferir e-mail/WhatsApp do contato |
| Venda expirada | O pagamento não foi concluído a tempo | Orientar novo pedido |
Boas práticas
- Antes de cancelar, verifique se o cliente já entrou — o sistema barra, mas a conversa muda.
- Prefira remarcar a cancelar quando o cliente só quer trocar a data.
- Conceda
sales.cancelesales.refunda poucas pessoas. - Use os relatórios para conciliação; a listagem é para atendimento.