Excursões - Custos da Excursão

O que é

A página de custos da excursão é onde a operadora cadastra tudo o que a viagem vai gastar: fretamento, hospedagem, alimentação, ingressos, guia local, seguros, pedágio, estacionamento e qualquer pagamento a fornecedor vinculado àquela excursão. Os lançamentos viram contas a pagar atreladas à viagem e alimentam a Calculadora de Preço, os Cenários de Ocupação, a Rentabilidade Real, o relatório Financeiro da Excursão e o Relatório Consolidado.

O usuário normalmente chega aqui logo após criar a excursão (para projetar o preço de venda com base no custo) ou durante o ciclo de vida da viagem (para registrar fornecedores, marcar pagamentos e acompanhar quanto do orçamento já foi consumido). A URL legada /admin/excursoes/{excursao}/custos redireciona automaticamente para a aba Custeio da edição da excursão, que é a fonte da verdade desde abril de 2026.

Como usar

1. Vá em Excursões no menu lateral e abra a excursão desejada.
2. Na navegação interna da excursão, clique na aba Custeio (ou acesse /admin/excursoes/{excursao}/custos, que redireciona).
3. Para um custo por viagem (não depende de quantos passageiros), clique em Adicionar no card Custos Fixos. Exemplos: fretamento do ônibus, pedágio, estacionamento, seguro do veículo, diária do guia.
4. Para um custo por passageiro (multiplica pelo número de pax), clique em Adicionar no card Custos Variáveis. Exemplos: alimentação, ingresso, guia local por pessoa, brinde.
5. No modal, preencha:
   • Tipo do custo - Fixo (por viagem) ou Variável (por passageiro). Já vem marcado conforme o botão clicado.
   • Fornecedor - opcional, nome de quem vai receber.
   • Descrição - obrigatório, identifica o lançamento (ex.: "Fretamento do ônibus", "Seguro viagem").
   • Categoria - opcional, escolhida entre as categorias de despesa do empresa (Transporte, Alimentação, Ingressos, Seguros etc.), usadas para agrupar no card Custos por Categoria do Financeiro da Excursão.
   • Valor - obrigatório, em reais. Para custos variáveis, é o valor por adulto a 100%.
   • Data de vencimento - só aparece para custos fixos. Se vazia, assume a data de início da excursão.
   • Forma de pagamento - Dinheiro, PIX, Cartão de crédito, Cartão de débito, Transferência, Boleto ou Cheque. Usada pelo card "Caixa em Dinheiro" do relatório financeiro.
   • Descontos por tipo de passageiro - só aparece para custos variáveis. Defina o percentual de desconto para Criança, Idoso e Bebê (o valor pago é calculado em tempo real abaixo do campo).
   • Observação - texto livre.
6. Confirme em Adicionar (ou Atualizar quando estiver editando).
7. Use os ícones de cada linha para Marcar como pago, Desmarcar pagamento, Editar ou Excluir.
8. Acompanhe o total previsto no cabeçalho de cada card: "Total" para fixos e "Por adulto" para variáveis. O custo total por pax estimado aparece logo abaixo, na seção Calculadora de Preço.

Casos especiais

Custo fixo × custo variável

O fixo é dividido pelo número de passageiros vendidos (quanto mais gente, menor o custo por pax). O variável é multiplicado pelos passageiros ativos (cresce linearmente com as vendas). Essa diferença é o que torna a Rentabilidade Real e os Cenários de Ocupação confiáveis: o fretamento de R$ 6.000,00 dividido por 30 pax pesa R$ 200,00 por pessoa; o almoço de R$ 56,00 por pax pesa sempre R$ 56,00. Marcar errado distorce a margem.

Descontos por categoria de passageiro

Em custos variáveis, os campos Desconto criança, Desconto idoso e Desconto bebê indicam quanto o custo cai para aquele perfil - útil quando o restaurante cobra meia para criança ou o ingresso é gratuito para idoso. A tabela de Custos Variáveis exibe o valor já calculado em cada coluna (Adulto 100%, Criança, Idoso, Bebê), e o rodapé soma o Total por passageiro em cada perfil.

Cadastro pela rota legada

A URL antiga /admin/excursoes/{excursao}/custos e o formulário /admin/excursoes/{excursao}/custos/create continuam redirecionando para a aba Custeio com a mensagem informativa. O POST direto (usado por integrações) ainda funciona, mas grava o custo como fixo por padrão, porque o formulário legado não distinguia tipo - por isso o cadastro oficial é sempre pelo modal desta aba, que exibe o radio Fixo/Variável.

Status do pagamento

Cada custo tem um dos três status:

• Pendente - registrado mas ainda não pago.
• Pago - marcado manualmente; grava data_pagamento e o usuário que efetuou a baixa.
• Vencido - marcado pelo sistema quando a data de vencimento já passou e o custo continua pendente.

O realizado da excursão é a soma dos custos com status Pago; o previsto é a soma de todos os custos (pagos + pendentes + vencidos).

Categorias de despesa sempre disponíveis

As categorias financeiras carregam mesmo sem o módulo Gestão Financeira ativo: uma migration de seed popula categorias padrão (Transporte, Alimentação, Ingressos, Seguros etc.) em toda empresa. Isso permite organizar custos da excursão antes mesmo de contratar o módulo financeiro completo.

Erros comuns e como resolver

• "O campo descrição é obrigatório" - Causa: o modal foi enviado sem preencher Descrição. Solução: preencher um texto curto que identifique o custo (ex.: "Almoço dia 1").
• "O campo valor é obrigatório" ou "deve ser maior que 0,01" - Causa: campo Valor vazio ou em zero. Solução: digitar o valor em reais; o campo aceita vírgula como separador decimal.
• Custo aparece no relatório financeiro mas não na aba Custeio - Causa: custo legado lançado pela rota antiga sem tipo_custo definido (tratado como fixo na compatibilidade). Solução: editar o custo pela aba Custeio e marcar Fixo ou Variável explicitamente.
• Margem da viagem ficou muito baixa após cadastrar custos - Causa: custos variáveis cadastrados como fixos (ou vice-versa), distorcendo o cálculo por pax. Solução: revisar o tipo de cada custo. Almoço, ingresso e guia local geralmente são variáveis; fretamento, pedágio e seguro do veículo são fixos.
• "Este custo já está marcado como pago." - Causa: tentativa de marcar como pago um lançamento que já está em status "Pago". Solução: usar Desmarcar pagamento primeiro caso a baixa tenha sido um engano.

Onde encontrar

• URL: /admin/excursoes/{excursao}/custos (redireciona para a aba Custeio)
• URL canônica: /admin/excursoes/{excursao}/edit#custeio
• Caminho no menu: Excursões > (abrir excursão) > aba Custeio
• Permissão necessária: editar as viagens
• Módulo necessário: nenhum (o cadastro de custos funciona sem o módulo Gestão Financeira; as categorias padrão já vêm seedadas)

Veja também

• Financeiro da Excursão
• Categorias e Preços
• Relatórios Consolidados
• Visão Geral de Excursões