Relatórios — Como Usar

Passo a passo para criar, filtrar, baixar, regenerar e excluir relatórios na plataforma Abbiamo

Guia prático de todas as ações disponíveis na página de Relatórios.

Fluxo típico

Acessar Relatórios pelo menu lateral (/reports).
(Opcional) Consultar o Dicionário para entender o significado das colunas.
Clicar em Novo relatório → preencher tipo, formato, período, filiais e filtros → Gerar relatório.
Aguardar (a lista atualiza sozinha enquanto o status for "Na fila" ou "Processando").
Quando o status mudar para Completo, abrir o menu ⋮ → Baixar relatório.
Se precisar do mesmo relatório: ⋮ → Gerar relatório novamente (ajustar se necessário).
Para remover: ⋮ → Excluir relatório → confirmar no modal.

Criar um novo relatório

Clique em Novo relatório no cabeçalho da página. O modal que abre tem os seguintes campos:

Campos do formulário

Campo	Descrição
Tipo do relatório	Pedidos, Eventos, Envios, Integrações de Pedidos, Integrações de Transportadoras, Filiais ou CSAT
Formato	CSV ou JSON
Período	Data absoluta ou período dinâmico — máximo de 31 dias (disponível para Pedidos, Eventos, Envios e CSAT)
Filiais	Seletor de filiais — mínimo 1 obrigatória
Status	(Pedidos, Eventos, Envios e CSAT) Filtra pelos status dos pedidos — por padrão, todos os status
Transportadoras	(Pedidos) Filtra por quem entrega (transportadoras) — por padrão, todas

Idioma dos cabeçalhos

Você também escolhe o idioma das colunas do arquivo (Português ou Inglês). Use o Dicionário no cabeçalho da página para conferir o significado de cada coluna em cada idioma.

Aviso de fuso horário

Ao abrir o modal, a plataforma exibe o fuso horário detectado da sua máquina. Todas as datas do relatório serão exportadas nesse fuso. Veja mais em Troubleshooting.

Após preencher, clique em Gerar relatório. Um toast confirma o envio e a lista é atualizada automaticamente.

Exportar a partir da tela de Pedidos

Você não precisa começar pela página de Relatórios: na tela de Pedidos, o botão Exportar (no topo da lista) abre um menu com duas opções.

Exportar tela atual

Baixa na hora um arquivo CSV com os pedidos que estão na tela atual. Ao escolher essa opção, abre um diálogo que mostra:

Quantos pedidos serão exportados (os que estão carregados na tela);
Um resumo dos filtros aplicados (período, filiais, status e transportadoras) — somente leitura;
O idioma dos cabeçalhos (Português ou Inglês).

As colunas do arquivo saem com os mesmos nomes usados no relatório completo, então os dois caminhos ficam consistentes.

Quer mudar o que será exportado?

O resumo de filtros no diálogo é apenas leitura. Para incluir ou tirar pedidos, ajuste os filtros na própria tela de Pedidos (período, filiais, status, transportadoras) e exporte de novo.

Leva você para a página de Relatórios com o formulário de novo relatório já aberto, tipo Pedidos selecionado e os filtros da tela de Pedidos pré-preenchidos (período, filiais, status e transportadoras). Confira e clique em Gerar relatório.

Consultar o dicionário de colunas

No cabeçalho, clique no ícone de Dicionário (ℹ). Escolha o idioma (Português ou Inglês) e o modal exibirá a descrição de todas as colunas de cada tipo de relatório.

Isso é útil para entender exatamente o que cada campo significa no arquivo exportado. A mesma referência, com todas as colunas reunidas, está em Dicionário de Colunas.

Filtrar e buscar relatórios

Busca rápida

Use o campo de busca (placeholder "Nome do relatório") para filtrar a lista pelo nome.

Filtros avançados

Clique no botão de filtros para abrir o painel e selecione:

Nome — texto livre
Tipo do relatório — Pedidos, Eventos, Envios, etc.
Formato — CSV, JSON
Status — Na fila, Processando, Completo, Falha, Expirado

Filtros persistentes

Os filtros são salvos automaticamente no navegador. Ao sair e voltar na página, eles continuam ativos.

Controle de colunas

Ao lado dos filtros, há o botão de visibilidade de colunas: permite mostrar ou ocultar colunas da tabela conforme sua necessidade.

Cada relatório na tabela possui um menu de ações à direita:

Baixar relatório

Situação	Comportamento
Status Na fila ou Processando	Ícone de loading — aguarde a conclusão
Status Completo	Solicita a URL de download e abre o arquivo em nova aba
Status Falha ou Expirado	O download não estará disponível — gere novamente

Um toast de carregamento/sucesso/erro aparece durante o processo.

Gerar relatório novamente

Abre o mesmo modal de criação, já preenchido com o tipo, formato, filiais, período e os filtros (status e transportadoras) daquele relatório. Você pode ajustar os campos e clicar em Gerar relatório para criar um novo.

Relatório expirado

Essa é a forma mais rápida de recriar um relatório expirado: o modal já vem preenchido, basta confirmar.

Excluir relatório

Abre o modal de confirmação:

"Tem certeza que deseja excluir o relatório "Nome do relatório"?"

Excluir: remove o relatório da lista (soft delete) e atualiza a tabela.
Cancelar: fecha o modal sem ação.