Entregas
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Entregas — Painel
A tela Entregas é onde a transportadora visualiza, filtra, cadastra, edita em lote e acompanha o status de todas as entregas cadastradas na plataforma — é a tela de gestão do processo de entrega, complementar às telas do Aplicativo usadas pelo motorista em campo.
Visão Geral
A tela Entregas é onde a transportadora visualiza, filtra, cadastra, edita em lote e acompanha o status de todas as entregas cadastradas na plataforma — é a tela de gestão do processo de entrega, complementar às telas do Aplicativo usadas pelo motorista em campo. A partir dela a transportadora importa pedidos e notas fiscais (manualmente, por arquivo ou por sincronização com um sistema integrado), organiza a carga de cada motorista e veículo, corrige endereços de entrega, acompanha a rota e as evidências de cada entrega, e reage a situações excepcionais (reagendamento, transferência de carga, entregas com endereço inconsistente). É, entre as telas do Painel, a que concentra o maior número de fluxos de negócio.
Pré-requisitos
Para que a tela Entregas funcione, as seguintes condições precisam estar atendidas:
- Sessão ativa no sistema. Sem uma sessão ativa, o sistema recusa qualquer ação desta tela.
- Módulo Entregas ativo nas permissões do usuário. Ao acessar a tela sem essa permissão, o usuário é redirecionado automaticamente para a tela Início, sem ver nenhum conteúdo da tela Entregas.
- Permissão de edição para as ações que alteram dados. Os botões de ação que alteram entregas (corrigir endereços, remover, desvincular, vincular, reagendar, transferir carga, alterar status, alterar sequência, editar, importar, sincronizar, adicionar) ficam desabilitados para usuários sem permissão de edição na área de Entregas, mesmo que o módulo esteja ativo para consulta.
- Cadastros de apoio já existentes na transportadora. Os filtros e os formulários de cadastro dependem de clientes, motoristas, veículos e emissores (filiais) já cadastrados; sem esses cadastros, os respectivos campos de seleção aparecem vazios.
Fluxo Operacional
- O usuário acessa a tela Entregas a partir do menu do Painel.
- A tela recupera o último filtro de status utilizado; se for a primeira vez, o filtro inicial é TODOS.
- A tela carrega a lista de entregas do filtro ativo e todas as opções de filtro (emissores, clientes, cidades, veículos, motoristas, cargas e, para transportadoras clientes do sistema integrado Atak, filiais, centros de distribuição, percursos e cargas externas).
- O usuário pode alternar entre as abas de status (Todos, Aguardando, A caminho, Entregando, Finalizado, Não entregue, Cancelado, Desvinculada, Inconsistentes) para filtrar rapidamente a lista, ou refinar a busca pelos filtros detalhados.
- Conforme o status das entregas visíveis, a tela habilita ações específicas: corrigir endereços, remover, desvincular, vincular, reagendar, editar em lote, transferir carga, alterar status da carga, alterar sequência, adicionar nova entrega, importar de arquivo e, para clientes Atak, sincronizar com o sistema integrado.
- A partir de cada entrega da lista, o usuário pode abrir o detalhe completo (com abas de dados gerais, itens, pagamento, observação e histórico de reagendamento), ver a rota no mapa, ver as evidências capturadas, editar a entrega ou removê-la, conforme o status atual.
- Ações de cadastro, edição, importação, correção de endereço, alteração de status/sequência/carga e reagendamento atualizam a lista de entregas automaticamente ao serem concluídas.
Interface e Comportamentos
Abas de Status e Ações em Lote
A tela Entregas exibe nove abas de status: Todos, Aguardando, A caminho, Entregando, Finalizado, Não entregue, Cancelado, Desvinculada e Inconsistentes. Entregando reúne as entregas A caminho que já têm o check-in do motorista registrado no destino; Inconsistentes reúne entregas sem endereço definitivo vinculado.
Conforme a aba ativa, os botões de ação disponíveis mudam:
- CORRIGIR ENDEREÇOS: aparece nas abas Aguardando e Inconsistentes, somente quando existem entregas com endereço inconsistente.
- REMOVER: aparece nas abas Aguardando, Desvinculada e Inconsistentes.
- DESVINCULAR: aparece na aba Aguardando.
- VINCULAR: aparece na aba Desvinculada.
- REAGENDAR: aparece nas abas Aguardando e A caminho.
- EDITAR (edição em lote): aparece na aba Aguardando.
- TRANSFERIR CARGA, ALTERAR STATUS (da carga) e ALTERAR SEQUÊNCIA: sempre visíveis.
- SINCRONIZAR: visível apenas para transportadoras clientes do sistema integrado Atak.
- IMPORTAR e ADICIONAR: sempre visíveis.
Todas as ações que alteram dados ficam desabilitadas para usuários sem permissão de edição na área de Entregas.
Filtros de Busca
A tela oferece um painel de filtros recolhível com: emissor, cliente, tipo (Nota Fiscal/Pedido), número da entrega (múltiplos números podem ser adicionados de uma vez), CEP, logradouro, bairro, cidade, UF, veículo, motorista, carga, data de embarque inicial e final, quantidade de itens por página, e as opções “Desconsiderar peso zerado” e “Somente reagendadas”. Para transportadoras clientes Atak, o painel exibe também filial, centro de distribuição, percurso, carga externa, temperatura e característica de osso (com ou sem osso).
O botão Filtrar aplica os filtros preenchidos e volta a lista para a primeira página; o botão Limpar restaura todos os campos ao estado vazio.
Detalhes da Entrega
Ao clicar no ícone de detalhes de uma entrega, a tela abre um modal com as seguintes abas:
- Detalhes: dados gerais da entrega (emissor, tipo, número, filial e local de estoque quando aplicável, datas, peso, quantidade, pagamento e valor total), dados do destinatário e do endereço, dados de transporte (veículo, motorista, carga, sequência, crossdock, temperatura, característica de osso) e a linha do tempo da entrega (Aguardando → A caminho → Pausado/Reiniciado, quando ocorreram → Entregando → status final), com o mapa da rota estimada quando a entrega está em andamento.
- Itens: lista os itens da nota/pedido com código, descrição, quantidade, unidade e valor.
- Pagamento: mostra o detalhamento das formas de pagamento e o valor total; quando a entrega tem um link de pagamento associado, mostra também o identificador e a URL do link e o status de pagamento (pago ou não encontrado).
- Observação: aparece somente quando a entrega tem uma observação vinculada.
- Histórico: aparece somente quando a entrega já foi reagendada ao menos uma vez, listando cada reagendamento com os dados de transporte daquele momento e a linha do tempo correspondente.
Cadastro e Edição Manual de Entrega
Pelo botão ADICIONAR (ou pelo ícone de editar de uma entrega Aguardando com endereço já definido), a tela abre um formulário com: emissor, tipo, número do documento, data de embarque, peso total, quantidade total, valor total, destinatário (cliente já cadastrado ou um novo cliente informando CPF/CNPJ e nome), endereço completo, motorista, veículo, carga, sequência, observação e, para clientes Atak, código do estoque, código e nome do percurso, temperatura e característica de osso. Abaixo, é possível adicionar itens (código, descrição, quantidade, unidade e valor) um a um.
Importação de Entregas por Arquivo
Pelo botão IMPORTAR, a tela permite selecionar até 10 arquivos nos formatos .csv, .txt, .xls, .xlsx ou .xml. Após o envio, os registros de entrega encontrados em cada arquivo são exibidos em uma lista de seleção, com a situação de cada um (pronto para importar, com erro, ou exigindo confirmação manual de posição do endereço no mapa — usada quando o endereço tem mais de uma posição possível ou não pôde ser localizado com precisão). O usuário confirma quais registros deseja importar; a importação salva cada entrega selecionada individualmente, mostrando o resultado (sucesso ou erro) de cada uma em tempo real.
Edição em Lote de Entregas
Pelo botão EDITAR, disponível na aba Aguardando com entregas selecionadas na lista, a tela abre um formulário compacto para alterar motorista, placa do veículo e/ou carga de todas as entregas selecionadas de uma só vez; cada campo só é alterado se o usuário marcar explicitamente a opção correspondente.
Alterar Sequência da Carga
Pelo botão ALTERAR SEQUÊNCIA, a tela permite buscar as entregas de uma carga informando motorista e placa do veículo (a carga é opcional, para refinar a busca) e reordená-las arrastando os itens da lista; ao salvar, a nova ordem é numerada sequencialmente a partir de 1.
Alterar Status das Entregas da Carga
Pelo botão ALTERAR STATUS, a tela permite selecionar uma carga e visualizar todas as suas entregas (com sequência, status, número, cliente, endereço, veículo e peso), pré-selecionando as que ainda não estão finalizadas, não entregues ou canceladas; ao confirmar, todas as entregas selecionadas são marcadas como Finalizado de uma só vez — uso típico para regularizar cargas cujo motorista não finalizou as entregas manualmente no aplicativo.
Alterar Status de uma Entrega
Pelo ícone de editar status de uma entrega individual, a tela permite escolher o novo status (Aguardando, A caminho, Entregando quando aplicável, Finalizado, Não entregue, Cancelado). Ao escolher Finalizado, a tela abre uma área para anexar evidências manualmente (fotos, PDF ou vídeo, até 5 MB por arquivo e até 10 arquivos), podendo marcar quais das imagens anexadas representam o canhoto físico da entrega.
Transferência de Carga
Pelo botão TRANSFERIR CARGA, a tela permite selecionar uma carga existente e definir um novo veículo e um novo motorista; ao confirmar, todas as entregas Aguardando ou A caminho da carga original passam a pertencer à nova combinação de veículo, motorista e carga. Para transportadoras clientes Atak com carga vinculada ao sistema integrado, a transferência é sincronizada com o sistema integrado antes de ser gravada, podendo gerar um novo código de carga automaticamente ou mediante informação manual do usuário.
Sincronização com Sistema Integrado (Atak)
Disponível apenas para transportadoras clientes do sistema integrado Atak, pelo botão SINCRONIZAR a tela busca os pedidos sem carga cadastrados no sistema integrado para uma data de embarque informada, e os grava automaticamente como entregas no Painel. Ao final, a tela verifica se a sincronização gerou entregas com endereço inconsistente e avisa o usuário quando isso ocorre.
Correção de Endereço
Individualmente (ícone de corrigir endereço em uma entrega Aguardando sem endereço vinculado) ou em lote (botão CORRIGIR ENDEREÇOS, quando há entregas com endereço inconsistente), a tela tenta localizar automaticamente a posição geográfica do endereço informado na entrega; quando a correção automática falha, para a correção individual a tela abre o formulário manual de endereço, preenchido com os dados disponíveis, para o usuário confirmar ou ajustar o endereço e a posição no mapa.
Rota da Entrega no Mapa
Pelo ícone de rota (disponível para entregas Finalizadas, Não entregues ou Canceladas), a tela exibe no mapa o trajeto percorrido pelo motorista durante a execução daquela entrega, a partir das posições registradas.
Evidências da Entrega
Pelo ícone de câmera (disponível quando a entrega tem evidências registradas), a tela exibe uma galeria com todas as fotos, canhotos e documentos anexados à entrega, com filtro por tipo (Evidência ou Canhoto), permitindo baixar cada arquivo; uma segunda aba mostra as evidências posicionadas no mapa.
Tour Guiado da Tela Entregas
A tela conta com um botão TOUR que destaca em sequência as principais áreas da tela (abas de status, botões de ação, filtros e lista), adaptando os passos conforme o tipo de transportadora e a presença ou não do botão Corrigir Endereços no momento.
Feedbacks ao Usuário
Sessão e Erros Gerais
| Situação | Feedback | Texto exato |
|---|---|---|
| Sessão expirada em qualquer ação da tela | Notificação de erro; a sessão é encerrada automaticamente 2 segundos depois | “Desculpe, sua sessão expirou.” |
| Falha de comunicação ao carregar cargas para filtro | Notificação de erro | “Não foi possível obter todas as informações de cargas.” |
| Falha de comunicação ao carregar cargas externas para filtro | Notificação de erro | “Não foi possível obter todas as informações de cargas externas.” |
| Falha de comunicação ao carregar cidades para filtro | Notificação de erro | “Não foi possível obter todas as informações de cidades.” |
| Falha de comunicação ao carregar emissores para filtro | Notificação de erro | “Não foi possível obter todas as informações de filiais.” |
| Falha de comunicação ao carregar filiais do sistema integrado | Notificação de erro | “Não foi possível obter todas as informações de filiais do Sistema Integrado.” |
| Falha de comunicação ao carregar clientes para filtro | Notificação de erro | “Não foi possível obter todas as informações de clientes.” |
| Falha de comunicação ao carregar centros de distribuição | Notificação de erro | “Não foi possível obter todas as informações de centros de distribuição.” |
| Falha de comunicação ao carregar motoristas para filtro | Notificação de erro | “Não foi possível obter todas as informações de motoristas.” |
| Falha de comunicação ao carregar veículos para filtro | Notificação de erro | “Não foi possível obter todas as informações de veículo.” |
| Falha de comunicação ao carregar percursos para filtro | Notificação de erro | “Não foi possível obter todas as informações necessárias dos Percursos.” |
| Falha de comunicação ao carregar a lista de entregas | Notificação de erro | “Não foi possível obter a lista de entregas.” |
| Situação | Feedback | Mensagem |
|---|---|---|
| Sistema recusa qualquer ação da tela por um motivo diferente de sessão expirada | Notificação de erro | A tela exibe, sem alteração, o texto de erro devolvido pelo sistema para o motivo específico. |
Importação de Arquivos
| Situação | Feedback | Texto exato |
|---|---|---|
| Mais de 10 arquivos selecionados para importação | Notificação de erro; modal de importação não abre | “Por favor, importe até 10 arquivos por vez.” |
| Arquivo com extensão não suportada selecionado | Notificação de erro; arquivo descartado da lista | “O arquivo {nome do arquivo} não é de extensão válida (.csv, .xls, .xlsx, .xml ou .txt).” |
| Nenhum arquivo válido restante após a validação | Notificação de erro | “Por favor, importe arquivos válidos (.csv, .xls, .xlsx, .xml ou .txt).” |
| Nenhum registro de entrega encontrado em nenhum arquivo enviado | Notificação de erro | “Não foram encontrados registros entregas nos arquivos.” |
| Registro importado com sucesso | Indicador de sucesso na linha do registro | “Importado.” |
| Falha ao importar um registro (erro de comunicação) | Indicador de erro na linha do registro | “Erro ao importar.” |
| Falha ao importar um registro (erro retornado pelo sistema) | Indicador de erro na linha do registro | Mensagem específica devolvida pelo sistema para aquele registro. |
Cadastro Manual de Entregas
| Situação | Feedback | Texto exato |
|---|---|---|
| Campo obrigatório do cadastro em branco (tipo, número, data de embarque, cliente, CPF/CNPJ ou nome do novo cliente, endereço, item) | Notificação de erro, campo destacado | “‘{NOME DO CAMPO}’ deve ser preenchido.” |
| Código do percurso preenchido sem o nome do percurso | Notificação de erro, campo destacado | “‘CÓDIGO DO PERCURSO’ também deve ser preenchido.” |
| Nome do percurso preenchido sem o código do percurso | Notificação de erro, campo destacado | “‘PERCURSO’ também deve ser preenchido.” |
| Confirmação ao editar uma entrega existente | Diálogo de confirmação | “Deseja mesmo EDITAR essa entrega?” |
| Cadastro/edição processado com sucesso | Notificação de sucesso | “Entrega processada com sucesso.” |
| Falha de comunicação ao salvar | Notificação de erro | “Não foi possível processar as informações.” |
| Situação | Feedback | Mensagem |
|---|---|---|
| Sistema recusa a gravação de um ou mais registros do cadastro/importação por regra de negócio (CNPJ do emissor não cadastrado, motorista não vinculado, número já cadastrado, endereço/CEP inválido, entre outras) | Notificação de erro por registro | A tela exibe, sem alteração, a mensagem de validação retornada pelo sistema para aquele registro específico. |
Ações em Lote e Individuais
| Situação | Feedback | Texto exato |
|---|---|---|
| Ação em lote (Desvincular/Vincular/Editar/Reagendar) sem nenhuma entrega selecionada | Alerta | “Por favor, selecione pelo menos uma entrega.” |
| Confirmação para desvincular entregas selecionadas | Diálogo de confirmação | “Deseja mesmo desvincular as entregas selecionadas?” |
| Confirmação para vincular novamente entregas selecionadas | Diálogo de confirmação | “Deseja mesmo vincular novamente as entregas selecionadas?” |
| Confirmação para remover uma entrega | Diálogo de confirmação | “Deseja mesmo remover a entrega?” |
| Entrega removida com sucesso | Notificação de sucesso | “Entrega removida com sucesso.” |
| Entrega já processada não pode ser removida | Notificação de erro por registro | “Entrega nº {número} já processada, não poderá ser removida.” |
| Confirmação para remover entregas selecionadas em lote | Diálogo de confirmação | “Deseja mesmo remover as entregas selecionadas?” |
| Confirmação para reagendar uma entrega | Diálogo de confirmação | “Ação de REAGENDAMENTO desassocia a Entrega da sua carga, sequência, motorista e veículo. Será necessário roteirizar novamente ou associar manualmente. Deseja mesmo reagendar esta entrega?” |
| Confirmação para reagendar entregas selecionadas em lote | Diálogo de confirmação | “Ação de REAGENDAMENTO desassocia a Entrega da sua carga, sequência, motorista e veículo. Será necessário roteirizar novamente ou associar manualmente. Deseja mesmo reagendar estas entregas selecionadas?” |
| Confirmação para corrigir o endereço de uma entrega individualmente | Diálogo de confirmação | “Esta entrega está sem endereço de entrega ou com o endereço incorreto, deseja corrigir o endereço agora?” |
| Confirmação para corrigir endereços em lote | Diálogo de confirmação | “Essa ação poderá levar um tempo até ser concluída devido a quantidade de registros. Deseja continuar?” |
Alterar Sequência, Status e Transferir Carga
| Situação | Feedback | Texto exato |
|---|---|---|
| Sequência salva com sucesso | Notificação de sucesso | “Alterado com sucesso.” |
| Alterar Status (carga): nenhuma carga selecionada | Notificação de erro | “A carga deve ser selecionada.” |
| Alterar Status (carga): nenhuma entrega encontrada para a carga | Notificação de erro | “Não foram encontrados registros de entregas para esta carga.” |
| Alterar Status (carga): confirmação de finalização em lote | Diálogo de confirmação | “As entregas selecionadas da carga {carga} serão finalizadas manualmente. Deseja continuar?” |
| Alterar Status (carga): nenhum registro selecionado ao finalizar | Notificação de erro | “Selecione ao menos um registro.” |
| Alterar Status (entrega individual): novo status igual ao atual sem evidência anexada | Notificação de erro | “Selecione o novo status da entrega.” |
| Alterar Status (entrega individual): arquivo de evidência maior que 5 MB | Notificação de erro | “Arquivo {nome do arquivo} é muito grande. O limite máximo é 5 MB.” |
| Alterar Status (entrega individual): mais de 10 arquivos de evidência anexados de uma vez | Notificação de erro | “Número máximo de arquivos enviado por vez atingido. O limite máximo é de 10 arquivos.” |
| Alterar Status (entrega individual): entrega desvinculada | Notificação de erro | “Entrega {número} está desvinculada do processo de transporte.” |
| Alterar Status (entrega individual): já existe entrega em aberto na mesma carga ao iniciar (A caminho) | Notificação de erro | “Não foi possível iniciar a entrega {número}, há entregas em aberto na mesma carga.” |
| Transferir Carga: veículo/motorista/carga não selecionados | Notificação de erro por campo | “O NOVO VEÍCULO deve ser selecionado.” / “O NOVO MOTORISTA deve ser selecionado.” / “A CARGA deve ser selecionada.” |
| Transferir Carga: peso da carga excede a capacidade do novo veículo | Diálogo de confirmação | “O peso total da CARGA seleciona excede a capacidade do NOVO VÍCULO. Deseja mesmo continuar?” |
Sincronização com Sistema Integrado
| Situação | Feedback | Texto exato |
|---|---|---|
| Integração não configurada (transportadora não cliente Atak) | Notificação de erro; modal fecha | “Configuração de integração não selecionada em: Configurações -> Roteirização.” |
| Endereço de acesso ao sistema integrado não informado | Notificação de erro; modal fecha | “Endereço da API de integração não informado em: Configurações -> Roteirização.” |
| Pedido selecionado ainda exige confirmação manual de posição do endereço | Notificação de erro | “Ainda há pedidos que necessitam de confirmação da posição do endereço.” |
| Nenhum registro selecionado para sincronizar | Notificação de erro | “Selecione ao menos um registro.” |
| Sincronização gerou entregas com endereço inconsistente | Diálogo de aviso | “Alguns pedidos foram direcionados para a aba Inconsistentes. Revise as informações para regularização.” |
| Falha de comunicação ao transferir carga com o sistema integrado | Notificação de erro | “Não foi possível transferir as carga.” |
| Código da nova carga (transferência) não retornado automaticamente pelo sistema integrado | Diálogo de texto livre | “Informe o CÓDIGO que deseja para a nova carga” |
| Código automático de carga aceito pelo usuário | Diálogo de confirmação | “O CÓDIGO da carga será gerado AUTOMATICAMENTE. Deseja continuar?” |
Regras de Negócio
Status de Entrega e seus Significados
| Status | Significado |
|---|---|
| Aguardando | entrega ainda não iniciada pelo motorista |
| A caminho | motorista iniciou a execução da carga, ainda sem check-in no destino |
| Entregando | entrega A caminho que já teve o check-in registrado no destino |
| Finalizado | entrega concluída |
| Não entregue | tentativa de entrega sem sucesso |
| Cancelado | entrega cancelada |
| Desvinculada | entrega removida do fluxo de execução (não aparece nas cargas do motorista) |
| Inconsistente | entrega sem endereço definitivo vinculado |
Regras de Carga, Crossdock e Sequência
- Uma entrega do tipo crossdock é identificada visualmente na coluna Carga com o sufixo “- CD”.
- A sequência de uma entrega dentro da carga, quando definida, é sempre exibida entre parênteses ao lado da carga.
- Ao transferir uma carga para novo veículo e motorista, somente entregas com status Aguardando ou A caminho são movidas; entregas A caminho voltam para Aguardando. Se nenhuma entrega elegível for encontrada para a combinação de carga/veículo/motorista original, a transferência é recusada.
- Ao alterar entregas de uma carga em lote para Finalizado, somente entregas que ainda não estejam Desvinculada, Finalizada, Não entregue ou Cancelada são alteradas.
- Ao iniciar manualmente uma entrega (mudar para A caminho), o sistema verifica se já existe outra entrega da mesma carga com status A caminho; havendo, a alteração é recusada — apenas uma entrega por carga pode estar A caminho por vez através desta rotina.
Regras de Reagendamento
- Reagendar uma entrega (individual ou em lote) grava uma cópia completa do estado atual da entrega (motorista, veículo, carga, sequência, datas de execução, crossdock) no histórico de reagendamentos antes de limpar esses campos.
- Após o reagendamento, a entrega volta ao status Aguardando, sem motorista, sem veículo, sem carga, sem sequência e sem vínculo com o roteiro anterior; a entrega passa a ter histórico de reagendamento (o que faz aparecer a aba Histórico no detalhe).
Regras de Cadastro Manual e Importação de Entregas
As mesmas regras de validação valem tanto para o cadastro manual pelo formulário quanto para a importação por arquivo (.csv, .txt, .xls, .xlsx):
- O CNPJ do emissor, quando informado, precisa corresponder a uma filial já cadastrada na transportadora; se não informado, assume automaticamente o CNPJ principal da transportadora.
- O tipo da entrega precisa ser Nota Fiscal ou Pedido; a data de embarque precisa ser uma data válida.
- Quando a placa do veículo é informada, ela precisa ter formato válido; quando o CPF do motorista é informado, ele precisa ser válido e o motorista precisa já estar vinculado à transportadora — motorista não cadastrado ou não vinculado bloqueia o registro.
- O destinatário precisa ter CPF/CNPJ válido; para o cadastro manual, se o CPF/CNPJ pertencer a um cliente já cadastrado com aquele código, o sistema rejeita como duplicado quando um novo cadastro de cliente é solicitado com dados já existentes.
- O CEP, o logradouro, a cidade e a UF do destinatário são obrigatórios.
- Quando a sequência da entrega não é informada, o sistema calcula automaticamente a próxima sequência disponível para aquele motorista, placa e data de embarque (última sequência já usada mais um, ou 1 se for a primeira).
- Um número de documento (nota/pedido) já cadastrado para a mesma transportadora no mesmo dia é rejeitado como duplicado.
- Itens da entrega são opcionais como um todo, mas quando adicionados exigem código, descrição, quantidade (maior que zero) e unidade.
- Ao salvar, se já existir uma observação vinculada à entrega, ela é atualizada ou removida conforme o campo de observação estar preenchido ou vazio; o mesmo vale para o vínculo com um percurso (criado se não existir, associado se já existir a combinação de código e nome).
Regras de Sincronização com o Sistema Integrado
- O nome do cliente sincronizado (Razão Social ou Nome Fantasia) segue a configuração definida no sistema integrado; quando essa configuração não pode ser obtida, o padrão adotado é Razão Social.
- Ao sincronizar, o sistema reaproveita o cadastro local do cliente quando os dados dele ainda não mudaram no sistema integrado desde a última sincronização, tornando sincronizações repetidas mais rápidas.
Evidências e Documentos Gerados
Toda entrega criada ou editada pelo Painel — manualmente pelo formulário, por importação de arquivo ou por sincronização com o sistema integrado — gera ou atualiza a nota fiscal eletrônica (NFe) vinculada, com os dados do emissor, destinatário, transportador, itens e forma de pagamento informados. Essa nota fiscal é a fonte usada para exibir os itens e o pagamento da entrega nas abas de Detalhes; se ela não puder ser localizada ou lida, os itens e o pagamento simplesmente não aparecem no detalhe, sem interromper a exibição do restante dos dados da entrega.
Ao alterar o status de uma entrega individual para Finalizado com arquivos anexados manualmente (fotos, PDF ou vídeo), cada arquivo é salvo nas evidências da entrega; imagens marcadas como canhoto físico recebem essa classificação, e para cada imagem salva o sistema gera automaticamente uma miniatura para exibição na galeria de evidências.
Troubleshooting
A tela informa que a sessão expirou
Cenário: o sistema identificou que a sessão do usuário não é mais válida ao processar qualquer ação da tela Entregas.
Mensagem exibida: “Desculpe, sua sessão expirou.”
O que fazer: aguardar o encerramento automático da sessão (ocorre 2 segundos após o aviso) e efetuar login novamente.
Uma das listas de filtro não carrega e aparece um aviso de falha de comunicação
Cenário: o navegador não conseguiu se comunicar com o sistema ao carregar as opções de um dos filtros (cargas, cidades, emissores, clientes, veículos, motoristas, percursos, centros de distribuição, filiais).
Mensagem exibida: mensagem específica do filtro, por exemplo “Não foi possível obter todas as informações de motoristas.”
O que fazer: verificar a conexão com a internet e recarregar a tela; se persistir, contatar o suporte.
A importação recusa mais de 10 arquivos de uma vez
Cenário: o usuário selecionou mais de 10 arquivos para importar.
Mensagem exibida: “Por favor, importe até 10 arquivos por vez.”
O que fazer: selecionar no máximo 10 arquivos por importação.
A importação rejeita um arquivo por extensão inválida
Cenário: o usuário selecionou um arquivo que não é .csv, .xls, .xlsx, .xml ou .txt.
Mensagem exibida: “O arquivo {nome do arquivo} não é de extensão válida (.csv, .xls, .xlsx, .xml ou .txt).”
O que fazer: selecionar apenas arquivos nos formatos suportados; os demais arquivos válidos continuam disponíveis para importação.
Nenhum arquivo válido restou para importar
Cenário: todos os arquivos selecionados foram rejeitados por extensão inválida.
Mensagem exibida: “Por favor, importe arquivos válidos (.csv, .xls, .xlsx, .xml ou .txt).”
O que fazer: selecionar novamente arquivos em um formato suportado.
A importação não encontra nenhum registro de entrega nos arquivos
Cenário: os arquivos enviados foram processados, mas nenhum registro de entrega válido foi identificado neles.
Mensagem exibida: “Não foram encontrados registros entregas nos arquivos.”
O que fazer: conferir se o arquivo segue o layout esperado de importação e tentar novamente.
O cadastro manual não salva por campo obrigatório em branco
Cenário: o usuário tentou salvar o cadastro ou edição manual de uma entrega sem preencher um campo obrigatório (tipo, número, data de embarque, cliente, CPF/CNPJ, nome, endereço ou dados de um item adicionado).
Mensagem exibida: “‘{NOME DO CAMPO}’ deve ser preenchido.”
O que fazer: preencher o campo indicado e salvar novamente.
O cadastro manual recusa código do percurso sem o nome, ou nome sem o código
Cenário: o usuário preencheu apenas um dos dois campos de percurso (código ou nome), disponíveis para transportadoras clientes Atak.
Mensagem exibida: “‘CÓDIGO DO PERCURSO’ também deve ser preenchido.” ou “‘PERCURSO’ também deve ser preenchido.”
O que fazer: preencher os dois campos de percurso juntos, ou deixar ambos em branco.
Uma entrega já processada não pode ser removida
Cenário: o usuário tentou remover uma entrega que não está mais com status Aguardando.
Mensagem exibida: “Entrega nº {número} já processada, não poderá ser removida.”
O que fazer: entregas em andamento ou finalizadas não podem ser removidas; se necessário, usar Reagendar para desassociar a entrega da carga atual.
Uma ação em lote não prossegue por falta de seleção
Cenário: o usuário clicou em Desvincular, Vincular ou Editar (edição em lote) sem selecionar nenhuma entrega na lista.
Mensagem exibida: “Por favor, selecione pelo menos uma entrega.”
O que fazer: marcar ao menos uma entrega na lista antes de repetir a ação.
A correção automática de endereço falha e abre o formulário manual
Cenário: o sistema não conseguiu localizar automaticamente a posição geográfica do endereço de uma entrega ao corrigi-la individualmente.
Mensagem exibida: Nenhuma — o sistema abre diretamente o formulário manual de endereço, preenchido com os dados já disponíveis da entrega.
O que fazer: conferir e ajustar manualmente o endereço e a posição no mapa, e salvar.
A busca de entregas para Alterar Sequência não retorna nada
Cenário: o usuário não informou motorista e placa do veículo (ambos obrigatórios) ao buscar entregas para reordenar.
Mensagem exibida: Nenhuma — o botão Buscar Entregas não realiza a busca enquanto os dois campos obrigatórios não estiverem preenchidos.
O que fazer: informar motorista e placa do veículo antes de buscar.
Alterar Status (carga) recusa a busca sem carga selecionada
Cenário: o usuário clicou em Buscar sem selecionar uma carga.
Mensagem exibida: “A carga deve ser selecionada.”
O que fazer: selecionar a carga desejada e buscar novamente.
Alterar Status (carga) não encontra entregas para a carga selecionada
Cenário: a carga selecionada não tem nenhuma entrega associada.
Mensagem exibida: “Não foram encontrados registros de entregas para esta carga.”
O que fazer: confirmar o nome da carga informado; se persistir, verificar se as entregas foram vinculadas a essa carga.
Alterar Status (carga) recusa a finalização sem nenhum registro selecionado
Cenário: o usuário clicou em Finalizar sem manter nenhuma entrega marcada na lista.
Mensagem exibida: “Selecione ao menos um registro.”
O que fazer: marcar ao menos uma entrega antes de finalizar.
Alterar Status (entrega individual) recusa quando o status escolhido é igual ao atual
Cenário: o usuário abriu a edição de status de uma entrega e tentou salvar sem escolher um status diferente do atual e sem anexar nenhuma evidência.
Mensagem exibida: “Selecione o novo status da entrega.”
O que fazer: escolher um status diferente do atual, ou anexar ao menos uma evidência antes de salvar.
Um arquivo de evidência é recusado por exceder o tamanho máximo
Cenário: o usuário anexou manualmente um arquivo de evidência maior que 5 MB ao alterar o status de uma entrega para Finalizado.
Mensagem exibida: “Arquivo {nome do arquivo} é muito grande. O limite máximo é 5 MB.”
O que fazer: reduzir o tamanho do arquivo ou anexar um arquivo diferente.
Muitos arquivos de evidência anexados de uma vez
Cenário: o usuário tentou anexar mais de 10 arquivos de evidência de uma só vez.
Mensagem exibida: “Número máximo de arquivos enviado por vez atingido. O limite máximo é de 10 arquivos.”
O que fazer: anexar os arquivos em lotes de até 10.
Não é possível iniciar uma entrega porque já há outra em aberto na mesma carga
Cenário: o usuário tentou alterar o status de uma entrega para A caminho enquanto outra entrega da mesma carga já está A caminho.
Mensagem exibida: “Não foi possível iniciar a entrega {número}, há entregas em aberto na mesma carga.”
O que fazer: finalizar ou reverter a entrega em aberto da mesma carga antes de iniciar outra.
Não é possível alterar o status de uma entrega desvinculada
Cenário: o usuário tentou alterar o status de uma entrega que está com status Desvinculada.
Mensagem exibida: “Entrega {número} está desvinculada do processo de transporte.”
O que fazer: vincular a entrega novamente (aba Desvinculada, ação Vincular) antes de alterar seu status.
Transferir Carga recusa a ação sem carga, veículo ou motorista selecionados
Cenário: o usuário tentou transferir uma carga sem preencher todos os três campos obrigatórios.
Mensagem exibida: “A CARGA deve ser selecionada.” / “O NOVO VEÍCULO deve ser selecionado.” / “O NOVO MOTORISTA deve ser selecionado.”
O que fazer: preencher os três campos e tentar novamente.
Transferir Carga não encontra entregas elegíveis
Cenário: a combinação de carga, placa e motorista de origem informada não corresponde a nenhuma entrega com status Aguardando ou A caminho.
Mensagem exibida: “Não foram encontradas entregas com status AGUARDANDO ou EM ANDAMENTO na carga {carga} para serem transferidas.”
O que fazer: confirmar os dados da carga de origem informados.
Sincronizar recusa abrir por falta de configuração de integração
Cenário: a transportadora não tem uma integração configurada (ou, sendo cliente Atak, o endereço de acesso ao sistema integrado não está preenchido) em Configurações → Roteirização.
Mensagem exibida: “Configuração de integração não selecionada em: Configurações -> Roteirização.” ou “Endereço da API de integração não informado em: Configurações -> Roteirização.”
O que fazer: completar a configuração de integração na tela Configurações antes de sincronizar.
A sincronização informa que pedidos ficaram pendentes de confirmação de posição
Cenário: o usuário tentou sincronizar pedidos selecionados enquanto algum deles ainda precisa de confirmação manual da posição do endereço no mapa.
Mensagem exibida: “Ainda há pedidos que necessitam de confirmação da posição do endereço.”
O que fazer: abrir o mapa de cada pedido pendente, confirmar a posição correta e sincronizar novamente.
A sincronização avisa sobre entregas com endereço inconsistente
Cenário: ao concluir a busca automática de pedidos do sistema integrado, o sistema identificou que uma ou mais entregas recém-sincronizadas ficaram sem endereço definitivo.
Mensagem exibida: “Alguns pedidos foram direcionados para a aba Inconsistentes. Revise as informações para regularização.”
O que fazer: acessar a aba Inconsistentes e corrigir os endereços apontados.
O mapa de rota informa que não há rota disponível
Cenário: o usuário abriu o mapa de rota de uma entrega finalizada, não entregue ou cancelada, mas o sistema não retornou nenhum ponto de rota registrado.
Mensagem exibida: “Nenhuma rota disponível neste momento.”
O que fazer: verificar se o motorista de fato executou essa entrega com o aplicativo; se persistir, contatar o suporte.
A aba Pagamento não consegue exibir o status do link de pagamento
Cenário: o usuário abriu a aba Pagamento de uma entrega que possui um link de pagamento associado.
Mensagem exibida: Nenhuma — a área de status do pagamento permanece indicando carregamento indefinidamente, sem concluir a consulta.
O que fazer: considerar o link de pagamento exibido como referência e confirmar o recebimento por outro meio; reportar ao suporte técnico caso a consulta de status nunca seja concluída.
A miniatura de uma evidência não é exibida na galeria
Cenário: o sistema não conseguiu devolver a miniatura de uma evidência ao abrir a galeria de evidências da entrega.
Mensagem exibida: Nenhuma — a miniatura é substituída por uma imagem padrão de arquivo não encontrado, sem impedir a exibição das demais evidências.
O que fazer: tentar baixar o arquivo original diretamente pelo botão Download; se persistir, contatar o suporte técnico.
Casos de Uso
Caso 1 — Cadastro manual de uma entrega avulsa
Um usuário da transportadora precisa registrar manualmente uma entrega que não veio de nenhum arquivo nem do sistema integrado. Ele clica em ADICIONAR, seleciona o emissor, informa tipo Nota Fiscal, número, data de embarque, seleciona o cliente já cadastrado (o endereço é preenchido automaticamente a partir do cadastro do cliente), informa o motorista e a placa do veículo, adiciona dois itens e salva. A tela confirma “Entrega processada com sucesso.” e a nova entrega aparece na aba Aguardando.
Caso 2 — Importação de um arquivo de pedidos em lote
Uma transportadora recebe diariamente um arquivo .csv do seu sistema de faturamento com todos os pedidos do dia. O usuário clica em IMPORTAR, seleciona o arquivo, envia; a tela mostra a lista de registros identificados, com dois deles marcados como “Necessita identificar posição precisa” por ambiguidade de endereço. O usuário resolve as duas posições no mapa, mantém os demais registros pré-selecionados e clica em Importar; a tela mostra o progresso registro a registro até concluir.
Caso 3 — Regularização de uma carga cujo motorista não finalizou pelo aplicativo
Ao final do dia, o usuário percebe que uma carga com 15 entregas continua com 3 entregas em status A caminho, mesmo o motorista tendo relatado que concluiu todas. Ele usa ALTERAR STATUS, seleciona a carga, confirma que as 3 entregas pendentes estão pré-selecionadas junto com eventuais outras ainda abertas, e finaliza.
Caso 4 — Transferência de carga por troca de veículo no meio do dia
O veículo designado para uma carga quebra no meio da rota. O usuário abre TRANSFERIR CARGA, seleciona a carga em andamento, escolhe o veículo reserva e o motorista que assumirá o restante da rota; como o peso da carga está dentro da capacidade do novo veículo, a transferência é confirmada sem aviso adicional, e todas as entregas ainda não finalizadas passam a constar sob o novo veículo e motorista, com as que estavam A caminho retornando para Aguardando para nova roteirização.
