Cortesias
Uma cortesia é uma venda de total zero, marcada como cortesia e com motivo obrigatório. Ela gera vouchers normalmente, respeita a capacidade e fica fora da receita.
Para que serve
Emitir ingressos sem cobrança de forma rastreável: parcerias com imprensa, brindes institucionais, compensação de um problema no atendimento, convites de patrocinadores.
Quem pode acessar
courtesy.view— ver as cortesias emitidas.courtesy.issuesensível — emitir.- No PDV, quem não tem a permissão pode emitir mediante PIN de supervisor.
Empresa bloqueada não emite cortesia
A emissão exige que a empresa esteja ativa. Uma empresa suspensa por inadimplência continua vendendo pela loja e pelo PDV, mas não emite cortesia.
Como acessar
Menu lateral → Cortesias, com o botão Nova cortesia. Também é possível emitir diretamente pelo PDV.
Campos do formulário
| Campo | Obrigatório | Descrição |
|---|---|---|
| Contato | sim | Quem recebe. Busca por nome, CPF ou telefone; é possível criar um contato ali mesmo informando CPF, telefone, nome e sobrenome. |
| Atração | sim | Qual atração será liberada. |
| Data | sim | A ocorrência. Só habilita depois de escolher a atração. |
| Passaportes e quantidades | sim | Quais ingressos e quantos de cada. |
| Motivo da cortesia | sim | Justificativa registrada permanentemente. Exemplo do próprio campo: “parceria com imprensa, brinde institucional…”. |
Regras de negócio
- Cortesia é venda paga de total zero: subtotal, desconto e total zerados, status pago, sem pagamento registrado.
- Cortesia não é um canal de venda — é um marcador. A venda continua tendo origem online ou PDV.
- Motivo é obrigatório, exigido tanto no formulário quanto no servidor.
- A capacidade é respeitada. Se não houver vagas suficientes, a emissão é recusada (
no_capacity). - Os vouchers são idênticos aos de uma venda paga: um por unidade, tipo acesso, status ativo.
- O valor de tabela é guardado no item, mesmo cobrando zero — é o que permite medir quanto foi concedido.
- Fora da receita. A cortesia não entra nos números de faturamento, mas aparece no relatório de Descontos e Cortesias e na distribuição por canal.
- Só o servidor emite. A tela nunca cria a venda ou o voucher diretamente.
Passo a passo: emitir uma cortesia
- Cortesias → Nova cortesia.
- Localize o contato pelo nome, CPF ou telefone — ou crie um novo ali mesmo.
- Escolha a atração e, em seguida, a data.
- Selecione os passaportes e as quantidades.
- Escreva o motivo. Seja específico: ele será lido em auditoria meses depois.
- Confirme. O sistema cria a venda de total zero e emite os vouchers.
- Entregue os vouchers ao beneficiário (e-mail, WhatsApp ou impressão).
Erros e dúvidas comuns
| Situação | Motivo | Solução |
|---|---|---|
no_capacity | Não há vagas suficientes na data | Reduzir a quantidade, escolher outra data ou ampliar a capacidade |
| Botão de emitir indisponível | Falta a permissão courtesy.issue | Solicitar a permissão ou emitir pelo PDV com PIN de supervisor |
| A cortesia não aparece na receita | Comportamento correto | Consultar o relatório de Descontos e Cortesias |
| Emissão recusada com empresa bloqueada | Empresa suspensa | Regularizar a fatura da plataforma |
Boas práticas
- Padronize os motivos com o time (por exemplo: “Imprensa”, “Compensação”, “Patrocínio”), para facilitar a análise depois.
- Trate cortesia como despesa: acompanhe o volume no relatório, com o valor de tabela.
- Conceda a permissão de emissão a poucas pessoas; para o balcão, prefira o PIN de supervisor.
- Lembre que cortesia ocupa vaga — em dias de alta demanda, isso tira ingresso do público pagante.