Relatórios — Visão Geral

Tudo sobre a página de Relatórios: o que é, onde acessar, tipos disponíveis, status, permissões e comportamentos da plataforma

A página de Relatórios permite extrair, filtrar e baixar dados da sua operação logística em diversos formatos. É o ponto central para análise de pedidos, envios, eventos, integrações, filiais e pesquisa de satisfação.


Onde acessar


O que o cliente vê ao entrar

Cabeçalho

ElementoDescrição
Menu lateral duploBotão para abrir/fechar a sidebar
Título"Relatórios"
DicionárioAbre o dicionário de colunas (PT ou EN), explicando cada coluna dos relatórios
Novo relatórioAbre o modal de criação de novo relatório

Área de filtros e busca

  • Campo de busca: filtra pelo nome do relatório.
  • Botão atualizar: recarrega a lista manualmente.
  • Filtros avançados:
    • Nome
    • Tipo do relatório
    • Formato (CSV, JSON)
    • Status (Na fila, Processando, Completo, Falha, Expirado)
  • Controle de colunas: permite mostrar/ocultar colunas da tabela.

Tabela de relatórios

ColunaO que mostra
NomeNome dado ao relatório
TipoBadge indicando a categoria (Pedidos, Eventos, etc.)
FormatoÍcone de CSV ou JSON
StatusBadge com o estado atual do relatório
FiliaisChips das filiais incluídas ou "Todos"
Criado emData e hora de criação
AçõesMenu (⋮) com opções: baixar, gerar novamente, excluir

Paginação

No rodapé da tabela: tamanhos de página (50, 100, 150, 200) e navegação entre páginas.

Estado vazio

Se não houver relatórios ou nenhum resultado dos filtros, aparece a mensagem:

"Nenhum relatório encontrado, ainda... Crie um novo agora mesmo!"


Tipos de relatório

TipoDescrição
Pedidos (ORDERS)Dados completos dos pedidos — com filtros de período, filiais, transportadoras e status
Eventos (EVENTS)Registros de eventos logísticos
Envios (DELIVERIES)Dados dos envios realizados
Integrações de PedidosInformações das integrações de pedidos com sistemas externos
Integrações de TransportadorasDados das integrações com transportadoras
Filiais (SELLERS)Dados cadastrais das filiais
Pesquisa de Satisfação (CSAT)Respostas da pesquisa de satisfação — com filtro de período

Status do relatório

StatusSignificado
Na fila (QUEUED)Aguardando processamento
Processando (PROCESSING)O arquivo está sendo gerado com os filtros aplicados
Completo (DONE)Pronto para download
Falha (FAILED)Houve um erro na geração
Expirado (EXPIRED)Não está mais disponível — gere novamente se necessário

Atualização automática

Se você acabou de gerar um relatório, não precisa atualizar a página manualmente: enquanto ele estiver Na fila ou Processando, a lista se atualiza sozinha até o arquivo ficar pronto para download.


Formatos disponíveis

FormatoObservação
CSVFormato padrão, compatível com Excel, Google Sheets etc.
JSONIdeal para integrações e consumo programático

Comportamentos automáticos

  • Polling de status: relatórios recentes com status pendente são atualizados a cada 5 segundos (até 2 horas).
  • Filtros persistentes: as condições de filtro são salvas no navegador por grupo de filiais e por página (reports). Ao retornar, os filtros permanecem como estavam.
  • Reset de paginação: ao alterar texto de busca ou condições de filtro, a tabela volta para a primeira página.

Próximos passos

  • Como usar — passo a passo para criar, baixar, filtrar e excluir relatórios.
  • Troubleshooting — resolver divergências de datas, timezone e problemas de status.

Nesta página