Transportes - Atualizações do Portal

O que é

Esta página e a caixa de entrada de atualizacoes enviadas pela empresa de transporte pelo Portal do Transporte - o link publico (gerado em Detalhes do Transporte > Portal do Transporte) que você compartilha com a transportadora para que ela mesma mantenha o cadastro em dia. A propria empresa de onibus acessa esse link, propoe alteracoes nos dados da empresa, cadastra/edita veiculos e ajusta o layout de assentos, e cada proposta cai aqui como uma solicitacao Pendente aguardando aprovacao.

O usuário costuma chegar aqui pelo aviso amarelo "{n} atualização(oes) pendente(s)" que aparece no painel Portal do Transporte na tela de Detalhes do Transporte, ou direto pelo URL "/admin/transportes/{transporte}/atualizacoes". Use esta tela para revisar o que mudou, aprovar (os dados são gravados automaticamente no cadastro real do transporte ou veiculo) ou rejeitar com motivo. Esta Não e uma tela de envio de materiais (lista de passageiros, contratos, mapas) para a transportadora - ela cobre o fluxo inverso: a transportadora envia, você revisa.

Como usar

1. Va em Cadastros > Empresas de Transporte no menu lateral e abra o transporte desejado.
2. Na tela de detalhes, clique no aviso amarelo "{n} atualização(oes) pendente(s)" dentro do bloco Portal do Transporte (lateral direita). Você cai em "/admin/transportes/{transporte}/atualizacoes".
3. Confira a lista. Cada item mostra:
   • Tipo - Dados da Empresa, Novo Veiculo, Veiculo ou Layout de Assentos (com o modelo/placa quando aplicavel).
   • Status - Pendente (amarelo), Aprovado (verde) ou Rejeitado (vermelho). Pendentes aparecem sempre no topo.
   • Ação - Atualizacao ou Cadastro (criação de novo veiculo).
   • Quantos campos foram alterados (ou "Layout de assentos" para mudanca de mapa de poltronas) e ha quanto tempo a solicitacao chegou.
4. Clique no item ou no badge azul Revisar para abrir a tela de revisão detalhada.
5. Na revisão, leia o cabecalho com Tipo, Ação, Enviado em e IP de origem, alem da Observação da transportadora (texto livre escrito por quem enviou a solicitacao).
6. Confira a comparacao:
   • Para Dados da Empresa ou Veiculo, aparece a tabela Comparacao de Dados (ou Dados do Novo Cadastro quando e criação). Linhas com mudanca real ficam destacadas em amarelo, com bolinha amarela ao lado do nome do campo e a coluna Valor Proposto em negrito.
   • Para Layout de Assentos, aparece Comparacao de Layout lado a lado: layout atual (cinza) versus layout proposto (azul), com legenda dos tipos de assento (Normal, Executivo, Leito, Reservado, Motorista, Guia, Escada, Banheiro, Corredor) e contagem total de assentos em cada versão.
7. Decida no bloco Ações (visivel apenas se o status ainda for Pendente):
   • Aprovar e Sincronizar (botao verde) - aplica os dados propostos imediatamente: atualiza o cadastro do transporte, atualiza/cria o veiculo, ou reescreve o layout do veiculo. O status vira Aprovado e fica registrado quem aprovou e quando.
   • Rejeitar (botao vermelho) - abre um campo Motivo da rejeicao (opcional). Escreva uma explicacao (a transportadora consegue ver no portal) e clique em Confirmar Rejeicao. Os dados propostos são descartados.

Casos especiais

Atualização de Layout de Assentos

O comparativo visual mostra os dois mapas em grade, posicionados pelos campos fila, coluna, posicao_x e posicao_y que a transportadora enviou. Importante: aprovar a atualização de layout Não altera a Capacidade Total cadastrada do veiculo. A capacidade do cadastro continua sendo a fonte da verdade - eventuais divergencias entre o número de assentos do novo layout e a capacidade cadastrada ficam apenas sinalizadas na UI. Se precisar mudar a capacidade junto, edite o veiculo em Editar Veiculo depois de aprovar o layout.

Criação de Novo Veiculo pela transportadora

Quando o tipo e Novo Veiculo (ação Cadastro), a tabela de comparacao mostra so a coluna Valor (sem coluna "Valor Atual", porque o veiculo ainda não existe). Ao aprovar, o sistema cria o veiculo automaticamente vinculado a esta empresa de transporte, ja marcado como ativo. Você não precisa cadastrar manualmente em Cadastrar Veiculo.

Atualização ja revisada

Uma vez aprovada ou rejeitada, a atualização não pode ser revertida nem revisada de novo. O bloco Ações desaparece e a tela passa a mostrar somente quem revisou, quando e a observação do admin (se houver). Se a transportadora quiser propor outra mudanca, ela precisa enviar uma nova solicitacao pelo portal.

Sem atualizacoes pendentes

Se a transportadora nunca enviou nada pelo portal, você ve a mensagem "Nenhuma atualização recebida - Quando a transportadora enviar atualizacoes pelo portal, elas aparecerao aqui." Para que solicitacoes comecem a chegar, gere e compartilhe o link do portal: em Detalhes do Transporte > Portal do Transporte, clique em Gerar Link do Portal e copie a URL para enviar a transportadora.

Link do portal desativado

Se você desativou o link em Portal do Transporte > Desativar Link, a transportadora não consegue mais abrir o portal nem enviar novas solicitacoes - mas as atualizacoes que ja chegaram continuam aparecendo aqui para revisão. Para retomar o fluxo, reative em Reativar Link no mesmo bloco.

Erros comuns e como resolver

• "Esta atualização já foi revisada." - Causa: você tentou aprovar ou rejeitar uma atualização cujo status não e mais Pendente (outro usuário revisou antes, ou você abriu duas abas). Solucao: recarregue a lista em "/admin/transportes/{transporte}/atualizacoes" e confira o status atual.
• Página não encontrada (404) ao abrir uma atualização - Causa: o {atualizacao} da URL não pertence ao {transporte} da URL (link colado errado ou empresa trocado). Solucao: volte a listagem em "/admin/transportes/{transporte}/atualizacoes" e clique no item pela lista.
• Aviso "{n} atualização(oes) pendente(s)" continua aparecendo após revisar - Causa: o cache do navegador. Solucao: recarregue a tela de Detalhes do Transporte (F5). O contador olha direto em atualizacoesPendentes(), entao some assim que você decide.
• Não aparece o botao "Aprovar e Sincronizar" - Causa: ou o status não e mais Pendente, ou seu usuário não tem a permissão de editar os transportes. Solucao: peca ao Proprietario para liberar a permissão em Configurações > Perfis e Permissões, ou aprove com um usuário com perfil Proprietario/Gerente.

Onde encontrar

• URL: "/admin/transportes/{transporte}/atualizacoes"
• Caminho no menu: Cadastros > Empresas de Transporte > (abrir o transporte) > Portal do Transporte > {n} atualização(oes) pendente(s)
• Permissão necessária: ver os transportes para visualizar e editar os transportes para aprovar/rejeitar
• Módulo necessário: nenhum

Veja também

• Visao geral dos Transportes
• Detalhes do Transporte
• Editar Transporte
• Cadastrar Veiculo
• Editar Veiculo
• Layout de Assentos