Reservas - Auditoria do Pedido

O que é

A Auditoria do Pedido é uma folha própria, separada da tela da reserva, que mostra tudo o que aconteceu num pedido: os passageiros do grupo com categoria, situação e valor de cada um, e a linha do tempo completa de eventos, do mais recente para o mais antigo, com data, hora, o que aconteceu e quem executou cada ação. Ela junta duas fontes de registro - os eventos novos, que já nascem escritos em português, e o histórico antigo do sistema, traduzido na hora - e cobre o que aconteceu no pedido, nos passageiros e nos pagamentos.

Você normalmente chega aqui vindo da tela da reserva, quando precisa entender uma dúvida do cliente ("o que aconteceu com meu pagamento?"), investigar um cancelamento ou uma exclusão, ou simplesmente documentar o que houve num pedido para a sua equipe. Como a página é feita para imprimir ou virar PDF, ela abre sem o menu e a barra lateral do painel.

Como usar

1. Abra a reserva em Reservas e, no bloco Eventos do Pedido, clique em Gerar relatório para abrir a auditoria sem a análise automática, ou em Analisar com IA para abrir já com o resumo gerado por inteligência artificial. Os dois abrem a folha dentro de uma janela sobreposta, com um link Abrir em uma aba para ver em página cheia.
2. No alto da página ficam três botões: Voltar para a reserva, que leva de volta à tela do pedido; Imprimir, que manda a folha para a impressora; e Baixar PDF, que gera o arquivo pronto para enviar ao cliente. Nenhum dos três aparece no papel impresso nem no PDF gerado.
3. Logo abaixo vem o resumo em quatro quadros: Pedido (o código da reserva), Titular (quem comprou), Eventos (quantos registros a folha está mostrando) e Pontos de atenção (quantos eventos retiram algo do pedido, como uma exclusão ou um cancelamento).
4. Em Situação atual você vê o retrato de agora: o status do pedido, o valor total, quanto já foi pago e quanto ainda está em aberto, além da viagem, a data de saída e quantas pessoas estão no grupo.
5. Passageiros do pedido lista todo mundo que está na reserva, com a categoria, a situação e o valor de cada um, como foram gravados no momento da compra. A etiqueta "(titular)" marca quem fez a reserva, e a última linha fecha o valor total do pedido.
6. Linha do tempo completa traz todos os eventos, do mais recente para o mais antigo. Cada um mostra a data e a hora, o que aconteceu e quem executou; quando existe um detalhe adicional, ele aparece logo abaixo da frase. A etiqueta ao lado da hora diz do que o evento trata (Pagamento, Passageiro, Contrato) e ajuda a achar rápido o que você procura numa lista longa.

O que você precisa saber antes

• A linha do tempo não é editável. Ela é o registro oficial do sistema: serve para consultar o que aconteceu, não para corrigir nada. Mudanças no pedido acontecem na tela da reserva, não aqui.
• Os pontos vermelhos marcam o que retira algo do pedido - exclusão, cancelamento, remoção. Um pagamento excluído continua aparecendo na linha do tempo, com a hora e o nome de quem excluiu: apagar um registro não apaga o rastro dele.
• A análise automática é só apoio à leitura, não é prova. Ela interpreta os mesmos eventos listados na linha do tempo; em caso de divergência, vale sempre a linha do tempo, que é o registro oficial.
• A folha mostra até 500 eventos de cada fonte (os novos e os do histórico antigo). Pedidos muito antigos ou com muita movimentação podem não trazer o evento mais remoto se isso ultrapassar o limite.
• Se a reserva já passou por uma transferência de cliente, os eventos dos pedidos anteriores da cadeia também entram no relatório, marcados com a etiqueta do código do pedido de origem.
• Anotações antigas gravadas direto no pedido (texto livre anterior ao registro de eventos) aparecem num bloco separado, "Observações registradas no pedido", antes da linha do tempo - elas não têm data individual por linha porque não fazem parte do log estruturado.

Casos especiais

Análise automática por inteligência artificial

Ao abrir pelo botão Analisar com IA, a página tenta gerar um resumo da situação do pedido a partir dos eventos da linha do tempo. Essa análise é opcional e nunca impede a folha de abrir: se o serviço de IA não responder ou não estiver disponível no momento, a auditoria sai completa do mesmo jeito, só sem a seção de análise, com um aviso explicando que o restante do relatório não depende dela.

Pedido sem eventos registrados

Se não houver nenhum evento gravado para o pedido, a linha do tempo mostra a mensagem "Nenhum evento registrado para este pedido." em vez da lista.

Abrir direto pelo link, sem passar pela reserva

A URL da auditoria pode ser aberta diretamente (por exemplo, encaminhada por e-mail) desde que a reserva informada tenha um pedido vinculado. Passageiros sem pedido associado não têm auditoria disponível.

Erros comuns e como resolver

• "Reserva sem pedido vinculado." - A reserva que você está tentando auditar não está associada a nenhum pedido. Solução: confira se o link ou o identificador usado está correto.
• "Não foi possível gerar o PDF agora. Você ainda pode imprimir a página." - O serviço que monta o PDF não respondeu no momento. Solução: use o botão Imprimir e gere o PDF pela função de impressão do navegador, ou tente Baixar PDF novamente em alguns instantes.
• A análise automática não aparece mesmo clicando em "Analisar com IA" - O serviço de inteligência artificial pode estar indisponível ou sem configuração no momento. A folha ainda mostra a mensagem explicando isso e o restante do relatório continua completo.

Onde encontrar

• URL: /admin/reservas/{passageiro}/relatorio-eventos
• Caminho: abra Reservas, entre numa reserva e clique em Gerar relatório ou Analisar com IA no bloco Eventos do Pedido.
• Permissão necessária: ver as reservas (visualizar).
• Módulo necessário: nenhum.

Veja também

• Detalhes da Reserva
• Pagamentos da Reserva
• Cancelar Reserva
• Status da Reserva