Encomendas
Registre e acompanhe os volumes transportados nas viagens, com controle de peso, volume e situação de entrega por espaço de carga.
A encomenda é o volume transportado no compartimento de carga do veículo. Cada encomenda é vinculada a uma viagem e a um espaço de carga do veículo, com controle de peso e volume.
Onde encontrar
Não existe uma tela separada de Encomendas. As encomendas ficam na aba
Encomendas do painel da viagem, em Operação → Viagens
(/operation/trips): abra a viagem e selecione a aba, ou use Adicionar
encomenda no menu Mais ações. Sem a permissão packages.manage, o item
do menu se chama Ver encomendas e apenas abre a aba.
A aba apresenta a quantidade de encomendas da viagem entre parênteses. Ao lado das abas, o botão Ajuda abre esta página.
As encomendas sempre pertencem a uma viagem. Para consultar as encomendas de
outra viagem, abra o painel da outra viagem. O endereço antigo
/reservation/packages?tripId= redireciona para a aba Encomendas da viagem
correspondente.
Permissões necessárias
| Ação | Permissão exigida |
|---|---|
| Visualizar a aba e o detalhe das encomendas | packages.read |
| Criar, editar, transferir, cancelar, excluir e avançar situação | packages.manage |
| Visualizar a seção Pagamentos no detalhe | finance.read |
| Registrar e anular pagamentos | finance.manage |
O comprovante da encomenda pode ser emitido por qualquer usuário que consiga abrir a encomenda.
A aba em um relance
- Busca: por descrição, destinatário, telefone do destinatário e observações, a partir de 3 caracteres.
- Nova encomenda: botão ao lado da busca, disponível com a permissão
packages.manage. - Tabela de encomendas: descrição (com o cliente remetente abaixo), destinatário, peso, volume, valor estimado, situação e o menu de ações (⋯). O menu oferece Ver detalhes, Editar e Cancelar encomenda, conforme a situação e a permissão. Clique na linha para abrir o detalhe.
Se o veículo da viagem não tiver espaços de carga cadastrados, o seletor de espaço de carga do formulário apresenta "Nenhum espaço de carga no veículo" e a encomenda não pode ser salva. Cadastre os compartimentos no cadastro do veículo antes de operar encomendas.
Situação das encomendas
| Situação | Cor | Significado |
|---|---|---|
| Pendente | Amarelo | Registrada, aguardando confirmação. |
| Confirmada | Azul | Confirmada e pronta para embarque. |
| Em Trânsito | Índigo | Em transporte no veículo. |
| Entregue | Verde | Recebida pelo destinatário. Situação final. |
| Cancelada | Vermelho | Cancelada. Não pode ser revertida e libera o espaço de carga. |
O fluxo é sequencial: Pendente → Confirmada → Em Trânsito → Entregue. O cancelamento pode ser registrado em qualquer situação anterior a Entregue.
Quando a viagem passa para a situação Em Andamento, as encomendas Confirmadas dessa viagem passam automaticamente para Em Trânsito.
Registrar uma encomenda
Abrir o formulário
No painel da viagem, use Adicionar encomenda no menu Mais ações, ou abra a aba Encomendas e clique em Nova encomenda.
Nova Encomenda
Preencher os dados
Remetente e espaço de carga
| Campo | Obrigatório | Descrição |
|---|---|---|
| Cliente / Remetente | Sim | Cliente que está enviando o volume. Caso ainda não esteja cadastrado, o próprio campo oferece a opção de criar o cliente. |
| Espaço de Carga | Sim | Compartimento do veículo onde o volume é alocado. |
Ao escolher o espaço de carga, o formulário apresenta as barras Peso ocupado e Volume ocupado, que somam as encomendas já alocadas no espaço e o volume em preenchimento, em relação à capacidade máxima. A barra fica vermelha quando a capacidade é excedida.
Conteúdo e destinatário
| Campo | Obrigatório | Descrição |
|---|---|---|
| Descrição | Sim | Conteúdo do volume. |
| Destinatário: Nome | Sim | Nome de quem recebe. |
| Telefone | Não | Telefone do destinatário, para a entrega. |
Dimensões e valor
| Campo | Obrigatório | Descrição |
|---|---|---|
| Peso (kg) | Sim | Peso bruto do volume. Deve ser maior que zero. |
| Altura (cm) | Sim | Altura do volume. Deve ser maior que zero. |
| Compr. (cm) | Sim | Comprimento do volume. Deve ser maior que zero. |
| Larg. (cm) | Sim | Largura do volume. Deve ser maior que zero. |
| Volume (calculado) | Calculado | Altura multiplicada por comprimento e largura, em m³. |
| Valor declarado (R$) | Sim | Valor do frete cobrado pelo transporte. |
| Observações | Não | Instruções de manuseio ou de entrega. |
Salvar
Clique em Salvar encomenda. A notificação "Encomenda criada com sucesso" confirma o registro, e a encomenda passa a constar na tabela com a situação Pendente.
Avançar a situação
Para abrir o detalhe, clique na linha da encomenda ou use Ver detalhes no menu de ações (⋯). No detalhe, use o botão de avanço:
- Confirmar encomenda: de Pendente para Confirmada.
- Marcar Em Trânsito: de Confirmada para Em Trânsito.
- Marcar como Entregue: de Em Trânsito para Entregue, situação final.
O botão Cancelar do detalhe, assim como Cancelar encomenda no menu de ações da tabela, encerra a encomenda fora do fluxo. Antes de aplicar, o sistema solicita confirmação na janela Cancelar encomenda?: clique em Cancelar encomenda para confirmar ou em Voltar para desistir.
Pagamento do frete
Com a permissão finance.read, o detalhe da encomenda apresenta a seção
Pagamentos, com a situação do pagamento, o valor pago e o restante. Com a
permissão finance.manage, a seção também oferece Registrar pagamento e a
anulação de cada lançamento. Os lançamentos aparecem no extrato do Financeiro
identificados como Encomenda.
Editar e excluir
A edição está disponível enquanto a situação não for Cancelada, inclusive para encomendas entregues. Use Editar no menu de ações (⋯) da tabela ou o botão Editar no detalhe.
A exclusão definitiva só é permitida em uma encomenda cancelada. O botão Excluir fica no rodapé do detalhe e solicita confirmação na janela Excluir encomenda?, pois a ação é permanente.
Transferir uma encomenda
Para mover o volume para outra viagem, abra o detalhe e clique em Transferir. A transferência está disponível enquanto a encomenda não estiver Entregue ou Cancelada.
Escolher a viagem de destino
O seletor de viagens abre imediatamente. Filtre por origem, destino e data, selecione a viagem e clique em Confirmar seleção. Os filtros são aplicados conforme a seleção, sem botão de busca.
Espaço de carga e valor
Escolha o Espaço de carga do veículo da nova viagem e ajuste o Novo valor (R$) quando necessário. Clique em Transferir.
A viagem de destino precisa ter espaços de carga cadastrados no veículo. Sem eles, o sistema informa que a viagem selecionada não possui espaços de carga e o botão Transferir permanece indisponível. A capacidade do espaço de destino também é conferida na transferência.
Comprovante da encomenda
No detalhe da encomenda, o botão Comprovante oferece dois formatos, A4 e térmico de 80mm. O comprovante contém a identificação da transportadora, o número da encomenda, a rota da viagem, os dados do volume (descrição, peso, dimensões, volume, espaço de carga e observações), o remetente e o destinatário, o veículo, o QR code de identificação, o valor do frete com a situação do pagamento, as linhas de assinatura do recebimento e as orientações de retirada.
Capacidade dos espaços de carga
Bagageiro Principal
A ocupação do espaço de carga é apresentada em dois lugares:
- No formulário da encomenda, com as barras Peso ocupado e Volume ocupado do espaço escolhido, já somando o volume em preenchimento.
- No detalhe da encomenda, com as barras Peso e Volume do espaço onde a encomenda está alocada.
Os valores seguem o formato X kg / Y kg e X m³ / Y m³. A capacidade de
volume é calculada a partir das medidas internas do espaço cadastradas no
veículo. Sem essas medidas, a barra de volume não apresenta o máximo. A barra fica vermelha
quando a capacidade é excedida. As encomendas com situação Cancelada não
são contabilizadas.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Não é possível escolher o espaço de carga | Veículo sem espaços de carga cadastrados | Cadastre os compartimentos no cadastro do veículo |
| Capacidade excedida ao salvar | O volume ultrapassa o peso ou o volume disponível | Reduza o peso ou as dimensões, ou troque o espaço de carga |
| O formulário não permite salvar | Peso ou dimensões iguais a zero | Informe peso, altura, comprimento e largura maiores que zero |
| Não é possível editar a encomenda | A situação é Cancelada | Registre uma nova encomenda |
| Não é possível cancelar ou transferir | A situação é Entregue | A encomenda ainda pode ser editada e ter o comprovante emitido |
Próximos passos
Configure os compartimentos de carga em Veículos e as viagens em Viagens para operar as encomendas.