Relatório
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Relatório — Painel
A tela Relatório é onde a transportadora exporta, em PDF ou CSV, o status consolidado das entregas de uma carga ou de um período — sequência, tempos de check-in, distância percorrida, peso e observações de cada entrega.
Visão Geral
A tela Relatório é onde a transportadora exporta, em PDF ou CSV, o status consolidado das entregas de uma carga ou de um período — sequência, tempos de check-in, distância percorrida, peso e observações de cada entrega. É uma tela de um único formulário de filtragem seguido da geração e abertura do arquivo em uma nova aba do navegador; não há listagem em tela, cadastro nem edição. O relatório reúne os mesmos dados de entrega, motorista e veículo já usados nas telas Entregas, Motoristas e Veículos, e é o ponto do Painel onde a transportadora consolida esses dados para análise externa ou para envio a terceiros.
Pré-requisitos
Para a tela Relatório funcionar, é necessário que:
- o usuário tenha uma sessão ativa no Painel — sem sessão ativa, qualquer requisição feita a partir da tela retorna erro de sessão expirada (ver Troubleshooting).
- o perfil do usuário tenha a permissão de área “Relatório” ativa, ou seja administrador da conta — sem essa condição, uma tentativa de acesso pela URL redireciona automaticamente para a tela Início, sem nenhum aviso, e o item de menu não é exibido.
- a empresa tenha ao menos uma carga ou entrega registrada dentro do período informado — sem isso, a geração retorna sem arquivo (ver Troubleshooting).
- para gerar o relatório é necessário informar, no mínimo, uma carga específica OU um período completo (início e fim); o formulário bloqueia o envio antes de gerar o arquivo caso nenhuma das duas condições esteja satisfeita.
Fluxo Operacional
- O usuário acessa a tela Relatório pelo menu (item exibido apenas com a permissão de área ativa).
- A tela carrega automaticamente a lista de cargas, a lista de motoristas e a lista de veículos da empresa, para alimentar as opções do formulário de filtragem.
- O usuário preenche o formulário: pode restringir por motorista(s), veículo(s) (placa), tipo de documento, uma carga específica OU um período de datas, e pode marcar para exibir a carga completa e/ou somente entregas do tipo CrossDock.
- O usuário escolhe as colunas que deseja no relatório e o tipo de arquivo de saída, PDF ou CSV — ambas as escolhas ficam memorizadas no navegador para a próxima geração.
- O usuário clica em GERAR RELATÓRIO. Enquanto o arquivo é montado, a tela exibe um indicador de carregamento.
- Se a geração for concluída com sucesso, o arquivo (PDF ou CSV) abre automaticamente em uma nova aba do navegador e uma mensagem de sucesso é exibida; a tela permanece no formulário de filtragem, pronta para uma nova geração.
- Se a geração falhar (nenhum dado encontrado, filtro incompleto ou erro do sistema), uma mensagem de erro é exibida e nenhum arquivo é aberto.
Interface e Comportamentos
Formulário de Filtragem do Relatório
O formulário de filtragem oferece os seguintes campos: Motoristas (múltipla escolha), Veículos por placa (múltipla escolha), Tipo — Nota Fiscal ou Pedido (múltipla escolha), Carga (escolha única, entre as cargas já cadastradas na empresa), Início do Período, Fim do Período, “Exibir carga completa” (marcação), “Somente entregas CrossDock” (marcação), e a seleção de colunas a exibir no relatório. O tipo de arquivo de saída (PDF ou CSV) é escolhido em um campo próprio, obrigatório.
Se o campo Carga não for preenchido, Início e Fim do Período passam a ser obrigatórios — a mensagem de erro correspondente é exibida no campo e como notificação (ver Feedbacks ao Usuário). Se Carga estiver preenchida, o período é opcional.
A relação de motoristas exibida no filtro mostra o nome em maiúsculas seguido do CPF formatado (com pontuação). A relação de veículos mostra a placa seguida da marca e da carroceria entre colchetes. A relação de cargas trata a ausência de valor de carga como a opção “NÃO DEFINIDA”, tratada de forma equivalente a uma carga própria para fins de filtro.
Seleção de Colunas e Tipo de Arquivo
A seleção de colunas do relatório e o tipo de arquivo (PDF/CSV) escolhidos pelo usuário ficam memorizados no navegador utilizado — a próxima vez que a tela Relatório for aberta nesse mesmo navegador, as últimas colunas e o último tipo de arquivo escolhidos são pré-selecionados automaticamente. Essa memorização é local ao navegador: não é compartilhada entre usuários nem entre dispositivos diferentes.
Exibição e Download do Arquivo Gerado
Diferente do padrão de outras telas do Painel, a tela Relatório não possui uma etapa de pré-visualização em tela do conteúdo do relatório antes da geração: ao clicar em GERAR RELATÓRIO, o arquivo (PDF ou CSV) é montado e aberto diretamente em uma nova aba do navegador, sem etapa intermediária de revisão dentro do Painel.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Carga não preenchida e Início ou Fim do Período também não preenchidos | Notificação de erro + destaque no campo Carga | “‘CARGA’ deve ser informada em caso de ‘INÍCIO DA ENTREGA’ ou ‘TÉRMINO DA ENTREGA’ não informados.” |
| Carga não preenchida (ou “NÃO DEFINIDA”) e Início do Período vazio | Notificação de erro + destaque no campo Início do Período | “‘INÍCIO DO PERÍODO’ deve ser informado em caso de ‘CARGA’ não informada.” / “‘INÍCIO DO PERÍODO’ deve ser informado em caso de ‘CARGA’ não definida.” |
| Carga não preenchida (ou “NÃO DEFINIDA”) e Fim do Período vazio | Notificação de erro + destaque no campo Fim do Período | “‘FIM DO PERÍODO’ deve ser informado em caso de ‘CARGA’ não informada.” / “‘FIM DO PERÍODO’ deve ser informado em caso de ‘CARGA’ não definida.” |
| Início do Período informado é posterior ao Fim do Período | Notificação de erro + destaque nos dois campos | “‘INÍCIO DO PERÍODO’ não pode ser maior que o ‘FIM DO PERÍODO’.” |
| Intervalo entre Início e Fim do Período maior que três meses | Notificação de erro + destaque nos dois campos | “‘FIM DO PERÍODO’ deve estar dentro do período de três meses posterior ao ‘INÍCIO DO PERÍODO’.” |
| Tipo de arquivo não selecionado | Notificação de erro + destaque no campo Tipo de arquivo | “‘TIPO DE ARQUIVO’ deve ser informdo” (grafia exata do sistema, sem o “a” em “informado”) |
| Geração concluída com sucesso | Notificação de sucesso, arquivo aberto em nova aba | “Arquivo gerado com sucesso!” |
| Filtro aplicado não encontra nenhuma entrega | Notificação de erro | “Não foram encontrados dados referente a essa filtragem. Por favor, tente novamente.” |
| Nenhuma carga, motorista, veículo, ou período informados (nenhum filtro mínimo) | Notificação de erro | “É necessário informar no mínimo ou a ‘CARGA’, ou o ‘PERÍODO DE ENTREGA’.” |
| Falha de comunicação ao solicitar a geração do arquivo | Notificação de erro | “Não foram encontrados dados referente a essa filtragem.” |
| Erro interno ao montar o arquivo | Notificação de erro | “Ocorreu um erro ao gerar o relatório. Por favor, tente novamente.” |
| Falha ao carregar a lista de cargas na abertura da tela | Notificação de erro | “Não foi possível obter todas as informações de cargas da empresa.” |
| Falha ao carregar a lista de motoristas ou de veículos na abertura da tela | Notificação de erro | “Não foi possível obter todas as informações necessárias.” |
Regras de Negócio
Filtros Aplicáveis e Combinação Mínima Obrigatória
O relatório aceita os seguintes filtros, combináveis entre si: motorista(s), veículo(s) por placa, tipo de documento (Nota Fiscal e/ou Pedido), uma carga específica, um período (início e fim), “exibir carga completa” e “somente CrossDock”. É obrigatório informar uma carga específica OU um período completo — o formulário impede o envio sem essa condição.
Quando “somente CrossDock” está marcado, somente entregas marcadas como CrossDock e já carregadas no ponto de transbordo entram no relatório.
Quando “exibir carga completa” está marcado, o filtro de período passa a considerar a data de embarque/desembarque da carga como um todo, e não apenas as datas de início/fim de cada entrega individual dentro dela.
Quando nenhum tipo de documento é selecionado no filtro, o relatório aplica automaticamente o tipo de entrega configurado nas preferências da empresa (Nota Fiscal ou Pedido); se a empresa estiver configurada para trabalhar com os dois tipos, o filtro de tipo não restringe o relatório.
Ordenação e Agrupamento dos Resultados
As entregas do relatório são agrupadas em três níveis: empresa, motorista e carga (entregas sem carga definida entram no grupo “NÃO DEFINIDA”). Para cada carga, o relatório soma a distância total percorrida e o peso total das entregas do grupo. Dentro de uma mesma carga, as entregas aparecem na ordem em que foram concluídas (as que ainda não têm data de encerramento aparecem primeiro), depois pela ordem de início e, por fim, pela sequência de entrega definida na rota.
Cálculo da Distância Percorrida por Entrega
A distância percorrida de cada entrega é a soma das distâncias entre os pontos de localização consecutivos registrados para aquela entrega. Um trecho entre dois pontos consecutivos só é somado ao total quando a distância entre eles é menor que 1 km — trechos com salto igual ou maior que 1 km entre dois pontos consecutivos são descartados do somatório (contam como zero), tratados como ruído de sinal de localização em vez de deslocamento real.
Formatos de Exibição das Colunas do Relatório
- Status da entrega: “Aguardando”, “A caminho”, “Finalizado”, “Não entregue” ou “Cancelado”.
- Tipo de documento: documento tipo Nota Fiscal exibe “NF” (ou “NOTA FISCAL” no filtro do formulário); documento tipo Pedido exibe “PED” (ou “PEDIDO” no filtro do formulário).
- Reentrega: para entregas com status conhecido, exibe “SIM” quando a entrega teve uma pausa ou um reinício registrados, “NÃO” caso contrário; para qualquer outro status, a coluna fica em branco.
- Início: para entregas que não estejam com status “Aguardando”, exibe a data/hora do reinício da entrega, se houver, ou a data/hora de início original, caso contrário; entregas “Aguardando” ficam em branco.
- Check-in: para entregas nos status “A caminho”, “Finalizado”, “Não entregue” ou “Cancelado”, exibe a data/hora do check-in quando registrado, ou o texto “NÃO REALIZADO” (destacado) quando não há check-in registrado; para o status “Aguardando”, a coluna fica em branco.
- Distância percorrida e Peso: quando a entrega não está com status “Aguardando” e o valor (distância ou peso) não foi registrado ou é zero, o relatório exibe “NAO REGISTRADO” (distância) ou “NAO INFORMADO” (peso), destacado; entregas “Aguardando” sem valor ficam em branco.
- Peso: valores abaixo de 1.000 são exibidos em quilogramas (kg); valores a partir de 1.000 são convertidos e exibidos em toneladas (t), com separador decimal em vírgula.
- Coluna “CARGA EXTERNA”: aparece apenas no relatório de empresas integradas ao sistema ERP Atak, mostrando o identificador de carga do sistema integrado, quando disponível.
- Separador de campos do arquivo CSV: é o configurado nas preferências da empresa; se a empresa não tiver um separador configurado, o padrão é vírgula.
Evidências e Documentos Gerados
O relatório gerado (PDF ou CSV) é um documento produzido a partir dos dados de entrega já registrados na empresa. Cada clique em GERAR RELATÓRIO produz um arquivo novo; nenhum arquivo de uma geração anterior é reaproveitado, mesmo que os filtros aplicados sejam idênticos aos de uma geração anterior. O arquivo não fica disponível para novo acesso depois de gerado — se a aba for fechada ou o arquivo for perdido, é necessário gerar um novo relatório com os mesmos filtros. O conteúdo, a formatação e as colunas do documento seguem as regras descritas em “Regras de Negócio”.
Troubleshooting
O botão “GERAR RELATÓRIO” mostra erro dizendo que é necessário informar carga ou período
Cenário: o usuário tentou gerar o relatório sem informar nenhuma carga específica e sem informar o período de datas.
Mensagem exibida: “‘CARGA’ deve ser informada em caso de ‘INÍCIO DA ENTREGA’ ou ‘TÉRMINO DA ENTREGA’ não informados.” (ou a mensagem equivalente pedindo Início/Fim do Período, conforme o campo vazio)
O que fazer: informar uma carga específica no filtro OU preencher Início e Fim do Período antes de gerar o relatório.
O período informado é rejeitado mesmo com as duas datas preenchidas
Cenário: o usuário preencheu Início e Fim do Período, mas a data de início é posterior à de fim, ou o intervalo entre as duas datas é maior que três meses.
Mensagem exibida: “‘INÍCIO DO PERÍODO’ não pode ser maior que o ‘FIM DO PERÍODO’.” ou “‘FIM DO PERÍODO’ deve estar dentro do período de três meses posterior ao ‘INÍCIO DO PERÍODO’.”
O que fazer: corrigir as datas de forma que o início seja anterior ao fim e que o intervalo entre elas não ultrapasse três meses; para períodos mais longos, gerar o relatório em mais de uma consulta.
O relatório é gerado, mas nenhum arquivo é aberto e aparece uma mensagem dizendo que não há dados
Cenário: o filtro aplicado (carga, motorista, veículo, tipo ou período) não corresponde a nenhuma entrega registrada na empresa.
Mensagem exibida: “Não foram encontrados dados referente a essa filtragem. Por favor, tente novamente.”
O que fazer: revisar os filtros aplicados — em especial carga, período e motorista/veículo — e tentar novamente com um filtro mais amplo.
Aparece uma mensagem de “dados não encontrados” mesmo quando os filtros parecem corretos
Cenário: a solicitação de geração falhou por qualquer motivo de comunicação (não necessariamente ausência de dados) — a mensagem exibida neste caso é sempre a mesma, independentemente da causa real da falha.
Mensagem exibida: “Não foram encontrados dados referente a essa filtragem.” (sem o complemento “Por favor, tente novamente.”, que só aparece quando o sistema efetivamente responde que não há dados)
O que fazer: verificar a conexão com a internet e tentar gerar o relatório novamente; se o problema persistir, contatar o suporte informando os filtros utilizados.
Erro genérico ao gerar o arquivo, sem detalhe do motivo
Cenário: ocorreu uma falha interna durante a montagem do arquivo.
Mensagem exibida: “Ocorreu um erro ao gerar o relatório. Por favor, tente novamente.”
O que fazer: tentar gerar o relatório novamente; se o erro se repetir com os mesmos filtros, contatar o suporte informando os filtros utilizados e o horário da tentativa.
A tela de Relatório não é acessível ou não aparece no menu
Cenário: o usuário tenta acessar a tela Relatório diretamente pela URL, mas não tem a permissão de área correspondente ativa em seu perfil.
Mensagem exibida: Nenhuma — o usuário é redirecionado automaticamente para a tela Início, sem nenhum aviso explicando o motivo.
O que fazer: solicitar ao administrador da conta que ative a permissão de área “Relatório” para o usuário.
O indicador de carregamento gira indefinidamente ao gerar o relatório, sem mensagem de sucesso nem de erro
Cenário: o sistema encontrou uma falha ao montar o conteúdo do arquivo que não se encaixa nas mensagens de erro tratadas.
Mensagem exibida: Nenhuma — o indicador de carregamento permanece girando indefinidamente, sem nenhum arquivo aberto e sem notificação de erro.
O que fazer: recarregar a página e tentar gerar o relatório novamente, preferencialmente com um filtro mais restrito (carga específica, período mais curto); se o problema persistir, contatar o suporte informando os filtros exatos utilizados.
Falha ao abrir a tela de Relatório com listas de motoristas ou veículos vazias
Cenário: ocorreu uma falha de comunicação ao carregar a lista de cargas, motoristas ou veículos assim que a tela foi aberta.
Mensagem exibida: “Não foi possível obter todas as informações de cargas da empresa.” (falha ao carregar cargas) ou “Não foi possível obter todas as informações necessárias.” (falha ao carregar motoristas ou veículos)
O que fazer: atualizar a página; se o filtro correspondente continuar vazio, verificar a conexão com a internet e contatar o suporte se o problema persistir.
Casos de Uso
Caso 1 — Geração de relatório em PDF de uma carga específica
Um usuário do Painel seleciona a carga “CARGA-0921” no filtro, deixa motorista, veículo, tipo e período em branco, mantém “Exibir carga completa” marcado, escolhe as colunas Sequência, Status, Cliente, Check-in e KM Percorrido, seleciona o tipo de arquivo PDF e clica em GERAR RELATÓRIO. O sistema localiza as entregas da carga (independentemente de estarem dentro de um período específico, já que “carga completa” está marcado), monta o PDF agrupado por motorista e abre o arquivo em uma nova aba, com a mensagem “Arquivo gerado com sucesso!”.
Caso 2 — Geração de relatório em CSV por período, sem carga definida
Um usuário filtra pelo motorista “João da Silva”, período de 01/09/2026 a 30/09/2026, sem informar carga, seleciona o tipo de arquivo CSV e clica em GERAR RELATÓRIO. O sistema busca automaticamente as cargas desse motorista no período informado, inclui também as entregas sem carga definida do mesmo motorista e período, agrupa os resultados e devolve um arquivo CSV com o separador de campos configurado para a empresa, aberto em uma nova aba.
Caso 3 — Filtro combinando CrossDock e tipo de documento
Um usuário marca “Somente entregas CrossDock”, seleciona o tipo “PEDIDO” e informa um período de 15 dias, sem carga nem motorista específicos. O sistema retorna somente as entregas do tipo Pedido, marcadas como CrossDock e já carregadas no ponto de transbordo, dentro do período informado.
Caso 4 (borda) — Tentativa de gerar relatório sem nenhum filtro mínimo
Um usuário abre o formulário e clica em GERAR RELATÓRIO sem preencher carga, período, motorista ou veículo. O Painel bloqueia o envio antes mesmo de tentar gerar o arquivo, destacando os campos Carga e Início/Fim do Período com a mensagem de obrigatoriedade correspondente.
