Encomendas
Registre e acompanhe pacotes transportados nas suas viagens — controle de peso, volume e status de entrega por espaço de carga.
A tela de Encomendas gerencia os pacotes que viajam no compartimento de carga dos seus veículos. Cada encomenda é vinculada a uma viagem e a um espaço de carga específico do veículo, com controle de peso e volume em tempo real.
Encomendas são acessadas por viagem: você seleciona primeiro a viagem e vê os pacotes daquele veículo naquele dia. Para ver encomendas de outras viagens, use o botão Trocar viagem.
Onde encontrar
Menu lateral → Operação → Encomendas. URL direta:
/reservation/packages?tripId={id-da-viagem}.
Permissões necessárias
| Ação | Permissão exigida |
|---|---|
| Visualizar encomendas | packages:read |
| Criar, editar, cancelar, avançar status | packages:manage |
A tela em um relance
Bagageiro Principal
Compartimento 2
- Seletor de viagem — cabeçalho com rota, horário e veículo da viagem atual. Botão Trocar viagem para navegar entre viagens.
- Cartões de capacidade — um por espaço de carga do veículo, com barras de uso de peso e volume.
- Filtros — por status e por cliente.
- Tabela de encomendas — descrição, destinatário, cliente remetente, peso, valor e ações.
Se o veículo da viagem não tiver espaços de carga cadastrados, a tela exibe um aviso e o botão de criar encomenda fica desabilitado. Cadastre os compartimentos no veículo antes de operar encomendas.
Status das encomendas
| Status | Cor | Significado |
|---|---|---|
| Pendente | Amarelo | Registrada, aguardando confirmação. |
| Confirmada | Azul | Confirmada e pronta para embarque. |
| Em Trânsito | Índigo | Viajando com o veículo. |
| Entregue | Verde | Recebida pelo destinatário. Estado final — imutável. |
| Cancelada | Vermelho | Cancelada. Não pode ser revertida. Libera espaço de carga. |
O fluxo é linear: Pendente → Confirmada → Em Trânsito → Entregue. Cancelada pode ser acionada de qualquer estado anterior a Entregue.
Registrar uma encomenda
Selecionar a viagem
Na abertura da tela, selecione a viagem em que o pacote vai viajar. Use os filtros de origem, destino e data para encontrá-la.
Abrir o formulário
Clique em Nova encomenda no cabeçalho.
Nova Encomenda
Remetente e alocação
Conteúdo
Preencher os dados
Remetente e espaço de carga
| Campo | Obrigatório | Descrição |
|---|---|---|
| Cliente remetente | Sim | Passageiro cadastrado que está enviando o pacote. |
| Espaço de carga | Sim | Compartimento do veículo onde o pacote será alocado. |
Ao escolher o espaço de carga, o sistema exibe as barras de capacidade em tempo real — peso e volume já usados vs. capacidade máxima.
Conteúdo e destinatário
| Campo | Obrigatório | Descrição |
|---|---|---|
| Descrição | Sim | O que está no pacote. |
| Destinatário | Sim | Nome de quem vai receber. |
| Telefone do dest. | Não | Para contato na entrega. |
Dimensões e valor
| Campo | Obrigatório | Descrição |
|---|---|---|
| Peso (kg) | Sim | Peso bruto do pacote. |
| Altura (cm) | Não | Altura do pacote. |
| Comprimento | Não | Comprimento do pacote. |
| Largura | Não | Largura do pacote. |
| Volume | — | Calculado automaticamente (altura × comprimento × largura). |
| Valor (R$) | Sim | Valor declarado / frete cobrado. |
| Observações | Não | Instruções especiais de manuseio ou entrega. |
Salvar
Clique em Salvar. A encomenda aparece na tabela com status Pendente.
Avançar o status
Em cada linha da tabela, clique em Ver detalhes. No painel, use o botão de avanço de status:
- Confirmar encomenda → Pendente vira Confirmada.
- Marcar Em Trânsito → Confirmada vira Em Trânsito.
- Marcar como Entregue → Em Trânsito vira Entregue (definitivo).
Ou use o botão Cancelar para encerrar fora do fluxo.
Editar uma encomenda
Disponível enquanto o status não for Cancelada. Clique no ícone de lápis na tabela ou no botão Editar dentro do painel de detalhes. Todos os campos podem ser alterados.
Capacidade dos espaços de carga
Bagageiro Principal
Compartimento 2
Cada cartão de espaço de carga mostra:
- Peso: barra de progresso com
X kg usados de Y kg máximos. - Volume: barra de progresso com
X L usados de Y L máximos.
Pacotes com status Cancelada não são contabilizados na capacidade.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Botão Nova encomenda desabilitado | Veículo sem espaços de carga | Cadastre compartimentos no cadastro do veículo |
| Capacidade excedida ao salvar | Pacote ultrapassa peso ou volume disponível | Reduza o peso/dimensões ou troque o espaço de carga |
| Não consigo editar uma encomenda | Status é Cancelada | Registre uma nova encomenda |
| Status Entregue não permite mais alterações | Estado final imutável por design | Nenhuma ação disponível — registre como auditoria |
Próximos passos
Encomendas são vinculadas a Viagens — configure os compartimentos de carga nos Veículos e as viagens em Viagens para operá-las.