Relatórios
A tela de Relatórios centraliza a geração de todos os relatórios pré-configurados do idworks — Vendas, Financeiro, Fiscal, Estoque, WMS (logística interna), TMS (transporte), Anúncios, Integração, Produtos, Ordem de Serviço e Customizado. Cada relatório aparece numa aba (categoria) e sub-aba (relatório específico), com os filtros próprios (intervalo de datas, conta, integração, status, faixa de valor, etc.). A geração é assíncrona: o usuário define os filtros, dispara o Gerar, e o relatório fica em processamento — o arquivo final aparece como link de download na aba Meus Relatórios quando termina (e opcionalmente o link é enviado por e-mail).
A tela tem duas abas principais no topo: Gerar Relatório (catálogo de relatórios + formulário de filtros) e Meus Relatórios (histórico dos relatórios que o próprio usuário gerou, com status e link de download). Não há ações em lote — cada relatório é gerado individualmente.
Esta tela não tem parametrizações próprias — o catálogo de relatórios disponíveis vem da configuração da conta e os privilégios por grupo decidem quais o usuário consegue ver.
Índice
Conceito
- O que é a tela de Relatórios?
- Quais grupos de relatórios existem?
- O que significa "geração assíncrona"?
- O que significa cada status de relatório?
- Por que alguns relatórios não aparecem para mim?
Gerar relatório
- Como gerar um relatório?
- Quais filtros cada relatório aceita?
- Como o sistema escolhe a conta da empresa?
- Posso pedir o link por e-mail?
Meus relatórios
- Como acompanhar o status de um relatório?
- Como baixar o arquivo de um relatório pronto?
- Como buscar relatórios já gerados na lista?
Regras de negócio
- Por que aparece "Relatório já esta em processamento, favor aguardar"?
- Quanto tempo o relatório leva para ficar pronto?
- O sistema guarda relatórios antigos?
Boas práticas
Referência rápida
O que é a tela de Relatórios?
É a tela onde você gera relatórios pré-configurados para análise — extrações de dados do sistema (pedidos, contas a pagar/receber, notas fiscais, estoque, etc.) em formato de planilha (XLSX) ou PDF. Cada relatório tem um conjunto fixo de filtros (intervalo de datas, conta, status, integração, etc.) que você preenche antes de gerar. O processamento é assíncrono — quando o relatório fica pronto, aparece com link de download na aba Meus Relatórios e (opcionalmente) o link é enviado para o seu e-mail.
📍 Onde: menu lateral → Relatórios.
Quais grupos de relatórios existem?
Os relatórios são organizados em grupos (abas) por área da operação. Os grupos comuns são:
| Grupo | O que inclui |
|---|---|
| Vendas | Pedidos por período, ranking de produtos, vendas por canal, comissão de vendedor, ticket médio. |
| Financeiro | Contas a pagar/receber, fluxo de caixa, conciliação adquirente, extrato bancário. |
| Fiscal | Notas fiscais emitidas, NFCe, NFSe, livro fiscal, GNRE. |
| Estoque | Posição de estoque, movimentação, inventário, curva ABC, recebimento de movimentação. |
| WMS (Logística interna) | Picking, packing, conferência, inconformidades. |
| TMS (Transporte) | Romaneios, custo de frete, cotação, prazos de entrega. |
| Anúncios | Performance de anúncios nos marketplaces. |
| Integração | Importações e exportações por canal de venda. |
| Produtos | Cadastros e atributos de SKU (etiquetas de preços, código de barras de embalagem, tags). |
| Ordem de Serviço | Relatórios da operação de Ordem de Serviço. |
| Customizado | Relatórios desenhados especificamente para a empresa (configurados em Relatório Customizado). |
A lista exata depende dos relatórios habilitados para a sua conta — pode haver grupos a mais ou a menos do que essa lista padrão.
O que significa "geração assíncrona"?
Geração assíncrona significa que o sistema não espera o relatório terminar para devolver uma resposta. Em vez disso, quando você clica em Gerar, o pedido entra em uma fila de processamento e o sistema responde imediatamente que o relatório está em processamento. O sistema vai pegando os pedidos da fila um a um, monta o arquivo e disponibiliza o link de download quando termina.
Esse modelo é necessário porque alguns relatórios consultam muitos dados (milhões de linhas, totais e agrupamentos pesados) e podem levar minutos para gerar. Se a tela esperasse, o navegador travaria. Com o modelo assíncrono, você pode continuar usando o sistema enquanto o relatório é processado.
Para acompanhar, vá em Meus Relatórios — quando o relatório fica pronto, o Status muda e o botão de download aparece na linha.
O que significa cada status de relatório?
Na aba Meus Relatórios, a coluna Status mostra em que fase o relatório está:
| Status | Significado |
|---|---|
| Processando | O pedido foi enfileirado e está sendo gerado — desde o momento em que entra na fila até o arquivo ficar pronto. O ícone de Baixar ainda fica desabilitado. |
| Gerado | O arquivo foi gerado e está disponível para download (ícone de Baixar ativo). |
| Sem dados | O relatório rodou normalmente, mas os filtros escolhidos não retornaram nenhum registro — não há arquivo para baixar. Ajuste o período ou os filtros e gere de novo. |
Se a geração falhar por algum problema, o relatório fica marcado como erro e o ícone de Baixar não funciona — gere o relatório de novo (revisando os filtros).
A lista é atualizada a cada recarga — não há atualização em tempo real; recarregue para ver o status mais recente.
Por que alguns relatórios não aparecem para mim?
Por privilégios. Cada grupo de relatórios tem um privilégio próprio (Relatório Vendas, Relatório Financeiro, Relatório Estoque, etc.) — para ver os relatórios de um grupo, o usuário precisa ter o privilégio correspondente. Quem não tem o privilégio simplesmente não enxerga a aba do grupo.
Se um relatório esperado não aparece, fale com o administrador da empresa para verificar os privilégios do seu perfil de acesso em Configurações → Perfis de Acesso. A lista de privilégios por grupo está no fim desta página.
Como gerar um relatório?
Acesse Relatórios. Na aba Gerar Relatório no topo:
- Escolha a aba do grupo (Vendas, Financeiro, Fiscal, etc.) e a sub-aba do relatório específico.
- Preencha os filtros do relatório — cada relatório tem os seus (intervalo de datas, conta, integração, status, etc.). Pelo menos um filtro precisa estar preenchido para gerar (alguns relatórios específicos rodam sem filtro obrigatório).
- (Quando a empresa tem mais de uma conta) Escolha a Conta no topo.
- Clique em Gerar Relatório.
A janela exibe uma mensagem confirmando que o relatório foi enfileirado. O sistema te leva automaticamente para a aba Meus Relatórios, onde a nova linha aparece com status Processando. Acompanhe ali — quando o status muda para Gerado, clique no ícone de Baixar para abrir o arquivo.
Pré-requisito: privilégio Visualizar relatórios + o privilégio do grupo específico (Vendas, Financeiro, Estoque, etc.).
Quais filtros cada relatório aceita?
Cada relatório tem seus próprios filtros, definidos no catálogo do sistema. Os tipos de filtro comuns são:
- Intervalo de datas — para período (ex.: "de 01/01/2026 a 31/01/2026"). Aceita atalhos como "Hoje", "Semana", "Mês".
- Par de valores — para faixas numéricas (ex.: valor mínimo e máximo).
- Seleção — para escolher entre opções pré-carregadas (ex.: integração adquirente, status, canal de venda).
- Texto livre — para busca textual (ex.: nome do cliente, número do pedido).
A combinação varia: o relatório de Pedidos por período pede data de início e data fim; o de Conciliação Adquirente pede integração; o de Estoque por SKU aceita um filtro de busca. A tela renderiza dinamicamente os campos com base no que o catálogo informa para cada relatório selecionado.
Como o sistema escolhe a conta da empresa?
Quando a empresa tem uma única conta cadastrada, o relatório é gerado nessa conta automaticamente. Quando a empresa é multi-conta (matriz + filiais, por exemplo), a tela exige que você selecione a Conta no topo antes de gerar — se você não selecionar, o sistema mostra a mensagem *Por Favor, O campo CONTA precisa ser selecionado.
A conta selecionada determina quais dados entram no relatório — pedidos só dessa conta, contas a pagar só dessa conta, etc. Para um relatório consolidado entre filiais, escolha a matriz (que dependendo da configuração consolida todas) ou use o Relatório Customizado.
Posso pedir o link por e-mail?
Sim. Existe um interruptor Enviar por e-mail no formulário de geração. Quando ativo, o sistema envia o link do arquivo para o e-mail cadastrado no seu usuário assim que o relatório fica pronto — útil para relatórios grandes que podem demorar e quando você não quer ficar checando a tela. O e-mail tem o link de download direto.
Quando desativado, o relatório fica disponível apenas pela aba Meus Relatórios (link aparece quando o processamento termina).
Como acompanhar o status de um relatório?
Acesse a aba Meus Relatórios. A lista mostra todos os relatórios que você gerou (cada usuário vê apenas os seus), ordenados pelo mais recente. Cada linha tem:
- Data — quando o relatório foi pedido.
- Relatório — código + nome + observações.
- Status — processando / gerado / sem dados (ou erro, se a geração falhar).
- Conta — empresa do relatório.
- Baixar — ícone de download (ativo só quando o status é Gerado).
Recarregue a página (ou volte à aba) para ver o status mais recente — não há atualização em tempo real automática.
Como baixar o arquivo de um relatório pronto?
Quando o status do relatório fica Gerado, o ícone de Baixar (nuvem com seta) na linha fica ativo. Clique nele — o sistema abre o arquivo (planilha XLSX, PDF ou outro formato dependendo do relatório) em uma nova aba do navegador, e você pode salvar no computador.
Enquanto o status é Processando, Sem dados ou em caso de erro, o ícone fica desabilitado.
Como buscar relatórios já gerados na lista?
A aba Meus Relatórios tem busca interna por coluna: clique no ícone de lupa no cabeçalho da coluna (Data, Relatório, Status, Conta) e digite o termo desejado. A lista é filtrada conforme você digita.
Útil quando você gerou muitos relatórios e quer encontrar um específico — busca por data, código do relatório ou conta.
Por que aparece "Relatório já esta em processamento, favor aguardar"?
Porque o sistema bloqueia a geração de um relatório quando já existe um pedido idêntico ainda em processamento. A regra exata é:
- Mesmo tipo de relatório,
- Mesma combinação de filtros aplicados,
- Mesmo usuário,
- Mesma conta,
- Ainda em Processando (sem link de download disponível),
- Criado nas últimas 3 horas.
Se você tenta gerar um relatório que satisfaz todas essas condições, o sistema responde com a mensagem Relatório já esta em processamento, favor aguardar. A regra evita duplicidade — gerar duas vezes o mesmo relatório em paralelo consumiria recursos do worker sem necessidade. Espere o anterior terminar (ou mude algum filtro) e tente de novo.
Quanto tempo o relatório leva para ficar pronto?
Depende do volume de dados e da complexidade da query:
- Relatórios pequenos (poucos milhares de linhas, sem agregações complexas): segundos a 1-2 minutos.
- Relatórios médios (dezenas a centenas de milhares de linhas): 2-10 minutos.
- Relatórios grandes (milhões de linhas, agregações pesadas): 10-30 minutos ou mais.
A fila de geração processa um relatório por vez por empresa — então se você pediu três relatórios em sequência, eles são processados um após o outro, não em paralelo, para a mesma empresa.
Para relatórios muito grandes que precisem de mais agilidade ou customização, considere um Relatório Customizado com query otimizada.
O sistema guarda relatórios antigos?
Sim — a aba Meus Relatórios mostra todos os relatórios já gerados pelo usuário, sem cortes por tempo. Cada relatório fica disponível para download enquanto o arquivo estiver no storage do idworks (geralmente por longos períodos). Se um arquivo antigo ficar indisponível, o link fica quebrado — basta gerar de novo o relatório com os mesmos filtros.
Boas práticas para gerar relatórios
Algumas atitudes simples evitam relatório vazio, espera à toa e dado fora do esperado:
- Confira a conta antes de gerar. A conta selecionada define quais dados entram no relatório — gerar na conta errada traz pedidos ou contas de outra filial. Em empresa com mais de uma conta, escolha a conta certa (ou a matriz, para o consolidado) antes de clicar em Gerar.
- Refine os filtros para não voltar Sem dados. Se o status do relatório vier como Sem dados, o período ou os filtros não bateram com nenhum registro — ajuste o intervalo de datas ou os filtros e gere de novo, em vez de repetir igual.
- Não gere o mesmo relatório duas vezes seguidas. O sistema bloqueia um pedido idêntico (mesmo relatório, mesmos filtros, mesma conta) que ainda está processando — espere o anterior terminar ou mude algum filtro, assim você não fica esperando à toa.
- Peça o link por e-mail nos relatórios grandes. Para extrações pesadas que podem levar minutos, ative Enviar por e-mail e siga trabalhando — o link chega assim que o arquivo fica pronto, sem precisar ficar recarregando a tela.
- Recarregue para ver o status mais recente. A aba Meus Relatórios não atualiza sozinha — recarregue a página para ver quando o relatório passa de Processando para Gerado e o botão de baixar libera.
- Lembre que a fila roda um por vez na sua empresa. Se pedir vários relatórios em sequência, eles são gerados um após o outro — peça primeiro o que você mais precisa, ou agrupe num período menor para sair mais rápido.
- Para volumes muito grandes, use o Relatório Customizado. Quando um relatório padrão demora demais ou precisa de recortes específicos, um relatório customizado com a consulta otimizada costuma sair mais rápido e do jeito que você precisa.
Privilégios da tela
Esta tela tem privilégios próprios — um geral para acessar a tela, e um por grupo de relatório para filtrar quais grupos cada perfil enxerga. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados.
| Privilégio | Libera |
|---|---|
| Visualizar relatórios | Acesso à tela e à aba Meus Relatórios (histórico). |
| Relatório Anúncios | Vê e gera relatórios do grupo Anúncios. |
| Relatório Customizado | Vê e gera relatórios do grupo Customizado (configurados em Relatório Customizado). |
| Relatório Estoque | Vê e gera relatórios do grupo Estoque. |
| Relatório Financeiro | Vê e gera relatórios do grupo Financeiro. |
| Relatório Fiscal | Vê e gera relatórios do grupo Fiscal. |
| Relatório Integração | Vê e gera relatórios do grupo Integração. |
| Relatório TMS | Vê e gera relatórios do grupo TMS (Transporte). |
| Relatório Vendas | Vê e gera relatórios do grupo Vendas. |
| Relatório WMS | Vê e gera relatórios do grupo WMS (Logística interna). |
Sem o privilégio principal (Visualizar relatórios), o usuário não consegue acessar a tela. Com ele mas sem nenhum privilégio de grupo, a tela abre vazia. Para que o usuário gere relatórios, dê o privilégio principal e pelo menos um privilégio de grupo.
Os grupos Produtos e Ordem de Serviço não têm privilégio próprio e ficam visíveis para qualquer usuário com Visualizar relatórios — controle o acesso a esses grupos pelos privilégios das respectivas áreas (Produtos / Ordem de Serviço).