Guias - Pagamento por Excursão

O que é

No Viagilize o pagamento ao guia é tratado como um dado do vínculo entre o guia e a excursão, e não como um cadastro fixo na ficha do guia. Cada vez que você adiciona um guia a uma excursão (cartão Guias / Equipe dentro da edição da excursão), o sistema cria um registro com cargo, transporte, embarque, poltrona, observação e o campo valor de pagamento combinado para aquele trabalho.

Isso significa duas coisas práticas: o valor pode variar de uma excursão para outra (cada vínculo carrega seu próprio valor) e o pagamento em si - emissão de recibo, transferência bancária, baixa em conta a pagar - não é executado dentro do módulo de Guias. O módulo apenas guarda quanto foi combinado por viagem e expõe a consulta agregada em Relatórios > Guias.

Como usar

1. Vá em Excursões > Excursões no menu lateral e abra a excursão desejada em Editar.
2. Localize o cartão Guias / Equipe (geralmente na coluna lateral da página de edição).
3. Clique em Adicionar (botão azul-claro no topo do cartão) para vincular um novo guia, ou clique no ícone de lápis ao lado de um guia já vinculado para abrir o mesmo modal em modo edição.
4. No modal, preencha:
   • Selecione o Guia - apenas guias ativos e ainda não vinculados a esta excursão aparecem.
   • Veículo/Transporte - obrigatório em excursões com transporte (não aparece em pacote de viagem).
   • Ponto de Embarque - opcional, filtrado pelo transporte escolhido.
   • Poltrona - opcional; quando informada bloqueia o assento para passageiros.
   • Função - cargo que o guia exercerá (puxa do cadastro de Cargos).
   • Observação - campo livre para registrar o valor combinado, condições de pagamento ou qualquer acordo específico.
5. Clique em Adicionar (ou Salvar, se estiver editando).

Atenção: o modal atual de vincular guia não exibe o campo Valor de Pagamento. A coluna valor_pagamento existe na tabela excursao_guias e o sistema sabe formatá-la (R$ ###,##), mas hoje ela só é preenchida via API externa ou ferramentas internas. Para garantir o registro do combinado, use o campo Observação descrevendo o valor.

Casos especiais

Pacote de viagem (sem transporte)

Quando a excursão é do tipo pacote de viagem, o campo Veículo/Transporte fica oculto e deixa de ser obrigatório. O restante do fluxo do vínculo (cargo, embarque opcional, observação) segue idêntico.

Pagamentos diferenciados na mesma excursão

Como o valor é por vínculo, é possível pagar diferente para Guia Principal, Guia Auxiliar e Monitor na mesma excursão - basta criar um vínculo por guia, cada um com sua Função e sua Observação descrevendo o valor.

Acompanhamento agregado

Para visualizar guias por período sem entrar excursão por excursão, vá em Relatórios > Guias. As abas disponíveis são:

• Visão Geral - totais do período.
• Ranking de Guias - guias com mais excursões realizadas.
• Disponibilidade - quem está livre e qual a próxima excursão.
• Guia por Excursão - lista plana de vínculos no período.

A operação financeira em si (lançar conta a pagar, gerar recibo, dar baixa) precisa ser feita no módulo Financeiro ou fora do sistema; o módulo de Guias hoje não emite recibo automático.

Erros comuns e como resolver

• "Este guia já está vinculado a esta excursão" - Causa: tentativa de adicionar duas vezes o mesmo guia na mesma excursão. Solução: edite o vínculo existente em vez de criar outro, ou desvincule antes para recadastrar.
• "Selecione um veículo/transporte" - Causa: excursão com transporte exige veículo no vínculo. Solução: cadastre o transporte na aba Transportes da excursão antes de adicionar o guia, ou converta a excursão para pacote de viagem se for o caso.
• "Este assento já está ocupado" - Causa: a poltrona escolhida para o guia já está alocada a um passageiro ou outro guia. Solução: abra o Selecionar Poltrona e escolha um lugar livre, ou deixe sem poltrona.
• "Nenhum guia disponível" no modal - Causa: todos os guias ativos já estão vinculados a esta excursão, ou não há guia ativo cadastrado. Solução: clique em Cadastrar novo guia dentro do próprio modal, ou ative um guia em Cadastros > Guias.

Onde encontrar

• URL: /admin/excursoes/{excursao}/edit - cartão Guias / Equipe
• URL do relatório: /admin/relatorios/guias
• Caminho no menu: Excursões > Excursões > [escolher excursão] > Editar > Guias / Equipe
• Caminho do relatório: Relatórios > Guias
• Permissão necessária: editar as viagens para criar/alterar o vínculo, ver os guias para o relatório
• Módulo necessário: nenhum

Veja também

• Vincular Guia à Excursão
• Perfil do Guia
• Lista de Guias