Encomendas - Listagem

O que é

Esta é a tela onde você acompanha todos os pacotes que viajam no bagageiro das suas viagens: cada encomenda nasce de um cadastro feito no balcão e fica aqui até ser entregue ou cancelada. A lista mostra, em cada linha, o código de rastreio, quem enviou e para quem, a rota de origem e destino, o status atual e o valor cobrado.

Você chega aqui pelo menu do painel sempre que precisa localizar uma encomenda específica para conferir em que etapa ela está, ou para abrir seu detalhe e avançar o ciclo de vida dela (embarcar, marcar como entregue, registrar pagamento). É também o ponto de partida para cadastrar uma encomenda nova.

Como usar

1. No menu do painel, entre em Módulos > Transporte de Encomendas e abra Encomendas.
2. Para cadastrar um pacote novo, clique em Nova Encomenda, no canto superior direito.
3. Para localizar uma encomenda específica, use os filtros:
   • Buscar - aceita código de rastreio, nome do destinatário ou telefone do destinatário.
   • Status - filtra pelos sete momentos do ciclo de vida, de "Aguardando coleta" até "Entregue" ou "Cancelada".
   • Unidade destino - mostra só os pacotes que vão para a unidade escolhida.
4. Clique em Filtrar para aplicar. Quando algum filtro está ativo, aparece o botão Limpar ao lado, que volta a mostrar todas as encomendas.
5. Clique no código da encomenda ou no botão Ver, no fim da linha, para abrir o detalhe dela e cuidar de embarque, rastreio, entrega e pagamentos.

O que você precisa saber antes

• O campo Buscar não encontra pelo telefone do remetente, só pelo do destinatário. Se você tem o telefone de quem enviou o pacote mas não sabe o nome do destinatário, a busca por esse telefone não traz resultado; procure pelo nome do remetente.
• O código de rastreio é gerado sozinho no cadastro, no formato PREFIXO-ANO-XXXXXX (por exemplo ENC-2026-A3B5C7), usando um alfabeto sem letras e números parecidos (sem 0/O, sem 1/I) justamente para ser fácil de ler e ditar por telefone no balcão. O prefixo é o que está configurado na tela de Configurações do módulo.
• A lista é só de leitura: não dá para mudar status, remetente ou valor direto por aqui. Qualquer alteração no ciclo de vida da encomenda acontece dentro do detalhe dela, ao clicar em Ver.
• A modalidade que aparece embaixo da rota (Balcão-Balcão, Balcão-Porta, Porta-Balcão ou Porta-Porta) define quantos status a encomenda passa: quem tem coleta ou entrega em endereço ganha uma etapa a mais no meio do caminho.
• A lista traz 30 encomendas por página, da mais recente para a mais antiga.

Casos especiais

Encomenda sem cadastro de cliente como destinatário

Quando a encomenda foi criada sem vincular um cliente cadastrado como destinatário (só com nome digitado na hora), a coluna "Remetente / Destinatário" ainda mostra esse nome normalmente. A busca por nome também funciona nesse caso, porque ela olha o nome do destinatário direto na encomenda, não exige que ele seja um cliente cadastrado.

Nenhuma encomenda encontrada

Se ainda não existe nenhuma encomenda cadastrada (ou nenhuma bate com o filtro aplicado), a tela mostra uma mensagem central com um ícone e o botão Nova Encomenda, para você já começar o primeiro cadastro dali mesmo.

Erros comuns e como resolver

• Busquei pelo telefone e não achei a encomenda - Causa: o campo Buscar só pesquisa o telefone salvo no destinatário, não no remetente. Solução: procure pelo nome do remetente ou pelo código de rastreio.
• A lista veio vazia mesmo tendo encomendas cadastradas - Causa: algum filtro (Status ou Unidade destino) ficou aplicado de uma busca anterior. Solução: clique em Limpar, ao lado do botão Filtrar.

Onde encontrar

• URL: /admin/encomendas
• Caminho no menu: Módulos > Transporte de Encomendas > Encomendas
• Permissão necessária: é preciso ter permissão para visualizar encomendas
• Addon necessário: Transporte de Encomendas

Veja também

• Encomendas - Configurações