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 e Ordem de Serviço. 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 (o link também é enviado automaticamente para o e-mail de quem gerou o relatório).
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.
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. As parametrizações do grupo Relatórios não mudam nada nesta tela — elas apenas informam para quais e-mails o idworks envia, por conta própria, três relatórios recorrentes (alerta de estoque, margem negativa e pedidos de compra em atraso). Veja o resumo no fim da página.
Índice
Conceito
- O que é a tela de Relatórios?
- Quais grupos de relatórios existem?
- Catálogo de relatórios por grupo
- Não achei relatório para o que eu preciso — e agora?
- 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?
- Por que a planilha vem com mais de uma aba?
- Como buscar relatórios já gerados na lista?
Regras de negócio
- Por que aparece "Relatório já está em processamento, favor aguardar"?
- Quanto tempo o relatório leva para ficar pronto?
- O sistema guarda relatórios antigos?
- Como o vínculo com centro de distribuição afeta os relatórios?
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 o link também é enviado automaticamente 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 | Quantos | Exemplos (nomes reais do catálogo) |
|---|---|---|
| Vendas | 10 | Clientes, Clientes X Vendedor, Comissão vendedor… |
| Financeiro | 6 | Contas a Receber, Contas a pagar, Fornecedores… |
| Estoque | 19 | Categoria similar, Composição Kits, Especificação produtos… |
| Fiscal | 3 | Departamento e regras, Itens fiscal (entrada e saída), Nota Fiscal |
| Anúncios | 3 | Anúncios, Atributos de Anúncios, Variações de Anúncios |
| WMS | 7 | Cesto Picking, Itens novo inventário, Listagem de Endereços… |
| Integração | 2 | Anúncios, Pendente vínculo |
| TMS | 1 | Cotação sem transportadora atende |
| Customizado | — | Sem relatório de catálogo geral hoje. |
| Produtos | 5 | Cadastrar variação de grade, Código de barras embalagem, Promoção PDV… |
| Ordem de Serviço | 3 | Histórico de Atendimentos, Ordens de Serviço por Motivo, Performance de Técnicos |
A contagem é dos relatórios de catálogo geral — a lista completa, com os filtros de cada um, está em Catálogo de relatórios por grupo.
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.
Sobre o grupo Customizado: a tela de configuração dos relatórios sob medida foi removida — não há mais onde criar, editar ou consultar esses modelos. Dependendo do que está habilitado na sua conta, a aba Customizado pode continuar aparecendo na lista de grupos — e, quando aparece, fica visível para qualquer usuário que acessa a tela de Relatórios, sem depender de privilégio próprio. Mas pedir um relatório por ali não gera arquivo nenhum (veja O que significa cada status de relatório?). Os arquivos de relatórios customizados que já haviam sido gerados continuam na aba Meus Relatórios, como sempre. O privilégio Relatório Customizado, se ainda aparecer no perfil de acesso, não muda nada na tela de Relatórios: marcar ou desmarcar não altera a aba Customizado. Para extrações sob medida, fale com o suporte do idworks.
Catálogo de relatórios por grupo
Esta é a lista dos relatórios de catálogo do idworks, com os filtros que cada um aceita. Use-a para saber o nome exato do relatório antes de procurá-lo na tela — foi para resolver o "qual relatório eu uso?" que ela existe.
Duas ressalvas antes de usar a tabela:
- A sua conta vê os relatórios habilitados para ela, que são um subconjunto desta lista. Se um nome daqui não aparece na tela, ele não está habilitado — fale com o suporte em vez de procurar em outro grupo.
- Existem relatórios sob medida, criados para contas específicas, que não estão aqui de propósito: eles só existem na conta que os pediu.
Onde não há filtro declarado (—), o relatório é gerado sem parâmetros além
da conta — ele traz a base inteira daquele assunto.
Vendas
| Relatório | Filtros que aceita |
|---|---|
| Clientes | — |
| Clientes X Vendedor | — |
| Comissão vendedor | DATA VENDA, DATA FATURAMENTO, VENDEDOR, DATA LIQUIDAÇÃO, TIPO PEDIDO |
| Fechamento x Itens | DATA PEDIDO, DATA FATURAMENTO, ARMAZÉM, INTEGRAÇÃO, INCLUIR VALOR DASHBOARD, DATA ENVIO |
| Fechamento x Itens e Kits | DATA PEDIDO, DATA FATURAMENTO, ARMAZÉM, INTEGRAÇÃO, INCLUIR VALOR DASHBOARD, DATA ENVIO |
| Fechamento/Faturamento | DATA PEDIDO, DATA FATURAMENTO, INCLUIR VALOR DASHBOARD, SOMAR VALOR DO DESCONTO AO VALOR DO PRODUTO |
| Resultado | DATA CRIAÇÃO, DATA FATURAMENTO, INCLUIR VALOR DASHBOARD, INTEGRAÇÃO, DATA CRIAÇÃO CANAL DE VENDAS |
| Resultado itens | DATA CRIAÇÃO, DATA FATURAMENTO, INCLUIR VALOR DASHBOARD |
| Vendas Clientes | DATA PEDIDO, TIPO PEDIDO |
| Vendas Kits | DATA PEDIDO, INTEGRAÇÃO |
Financeiro
| Relatório | Filtros que aceita |
|---|---|
| Contas a pagar | DATA CRIAÇÃO, DATA VENCIMENTO, EMPRESA FATURADOR, DATA PAGAMENTO, INCLUIR CENTRO DE CUSTO |
| Contas a Receber | DATA CRIAÇÃO, DATA FATURAMENTO, DATA VENCIMENTO, DATA PAGAMENTO, INCLUIR CENTRO DE CUSTO, EMPRESA FATURADOR |
| Fornecedores | CATEGORIA DO FORNECEDOR |
| Modelo Importação Conciliação Marketplace | — |
| Pagamentos contas a receber | — |
| Receber e pagar | DATA VENCIMENTO, DATA PAGAMENTO, EMPRESA FATURADOR, BANCO PAGAMENTO, BANCO PREVISTO, INCLUIR CENTRO DE CUSTO |
Dados bancários no relatório Fornecedores. As colunas de banco, agência, conta e Pix só vêm preenchidas para quem tem o privilégio Visualizar fornecedor ou Editar fornecedor (dado na empresa do fornecedor ou na conta principal do grupo). Para os demais, as colunas continuam na planilha, mas saem vazias.
Estoque
| Relatório | Filtros que aceita |
|---|---|
| Categoria similar | MARCA PRODUTO |
| Composição Kits | — |
| Especificação produtos | — |
| Imagens itens | CATEGORIA, MARCA PRODUTO, STATUS SKU |
| Itens X fornecedor | MARCA PRODUTO, FORNECEDOR |
| Kit sem componentes | — |
| Pedido de compra atrasado | DATA ESTIMADA RECEBIMENTO, INCLUIR APENAS PEDIDOS DE COMPRAS EM ATRASO |
| Posição Estoque Analítica | DATA CRIAÇÃO, DATA FATURAMENTO, ARMAZÉM |
| Posição Estoque Sintética (simplificada) | MARCA PRODUTO, ARMAZÉM, DATA POSIÇÃO, INCLUIR SOMENTE ITENS COM SALDO, TAGS, AGRUPAR POR ARMAZÉM, POLÍTICA COMERCIAL |
| Preços | MARCA PRODUTO, POLÍTICA COMERCIAL, INCLUIR PREÇOS NÃO EXISTES PARA POLÍTICA COM., STATUS SKU, FORNECEDOR, Categoria |
| Produtos e SKU - Para Atualização | MARCA PRODUTO, STATUS SKU, TIPO SKU |
| Produtos e SKUs | — |
| Produção | DIAS, CURVA ABC |
| Recebimento (compras) | DATA CRIAÇÃO, DATA NOTA FISCAL |
| Recebimento Movimentação | DATA CRIAÇÃO, DATA FINALIZAÇÂO NF |
| Resumo kits | — |
| Saldo por armazém | MARCA PRODUTO, ARMAZÉM, POLÍTICA COMERCIAL, TAGS |
| Skus mais vendidos | DATA VENDA, DATA FATURAMENTO, ARMAZÉM, FORNECEDOR, TIPO PEDIDO |
| Tipo Variações (Grade) | — |
Custo médio no Preços. A coluna R$ Custo Médio é o valor do estoque do SKU dividido pela quantidade, somando só os armazéns com Somar quantidade ligado. Sem saldo, mostra o custo da última compra; sem nenhum dos dois, a célula fica vazia. Com a parametrização Utilizar custo manual SKU ligada (Configurações → Parametrizações → Produto), a coluna traz o custo manual da ficha do SKU.
Fiscal
| Relatório | Filtros que aceita |
|---|---|
| Departamento e regras | EMPRESA FATURADOR |
| Itens fiscal (entrada e saída) | DATA FATURAMENTO |
| Nota Fiscal | EMPRESA FATURADOR, SERIE NF, DATA FATURAMENTO, INTERVALO DE NÚMERO |
Anúncios
| Relatório | Filtros que aceita |
|---|---|
| Anúncios | INTEGRAÇÃO |
| Atributos de Anúncios | CANAL DE VENDAS, INTEGRAÇÃO |
| Variações de Anúncios | INTEGRAÇÃO |
WMS
| Relatório | Filtros que aceita |
|---|---|
| Cesto Picking | — |
| Itens novo inventário | — |
| Listagem de Endereços | ARMAZÉM, ANDAR, RUA |
| Lotes e Estoque | ARMAZÉM |
| Modelo romaneio | — |
| Produtividade Picking e Packing | DATA PICKING E PACKING |
| Transferencia sku endereço | — |
Integração
| Relatório | Filtros que aceita |
|---|---|
| Anúncios | INTEGRAÇÃO |
| Pendente vínculo | INTEGRAÇÃO |
TMS
| Relatório | Filtros que aceita |
|---|---|
| Cotação sem transportadora atende | DATA COTAÇÃO |
Produtos
| Relatório | Filtros que aceita |
|---|---|
| Cadastrar variação de grade | — |
| Código de barras embalagem | — |
| Promoção PDV | TIPO PROMOÇÃO, STATUS PROMOÇÃO |
| Tags produtos e SKUs | — |
| Vincular SKU/KIT ao produto pai | — |
Ordem de Serviço
| Relatório | Filtros que aceita |
|---|---|
| Histórico de Atendimentos | PERÍODO, Cód. Cliente, Cód. SKU (Equipamento) |
| Ordens de Serviço por Motivo | PERÍODO, Cód. Cliente, TÉCNICO, Status, Cód. SKU (Equipamento) |
| Performance de Técnicos | PERÍODO, TÉCNICO, Cód. SKU (Serviço) |
Onde caem as perguntas mais comuns
A armadilha aqui é o grupo: vários relatórios não estão onde a intuição manda.
| O que você quer | Relatório | Grupo |
|---|---|---|
| Quais SKUs mais venderam no período | Skus mais vendidos (filtro DATA VENDA) | Estoque — não é em Vendas |
| Saldo atual por SKU e armazém | Posição Estoque Analítica ou Saldo por armazém | Estoque |
| Uma foto do estoque numa data passada | Posição Estoque Sintética (simplificada) (filtro DATA POSIÇÃO) | Estoque |
| Faturamento do período, pedido a pedido | Fechamento/Faturamento | Vendas |
| O mesmo, item a item | Fechamento x Itens (ou … e Kits) | Vendas |
| Comissão a pagar ao vendedor | Comissão vendedor (filtro DATA LIQUIDAÇÃO) | Vendas |
| Títulos a vencer / pagos, dos dois lados | Receber e pagar | Financeiro |
| Notas emitidas por série e faixa de número | Nota Fiscal | Fiscal |
| Preço de cada SKU numa política comercial | Preços (filtro POLÍTICA COMERCIAL) | Estoque — não é em Produtos |
| Produtividade de quem separa e embala | Produtividade Picking e Packing | WMS |
| Anúncios, variações e atributos por canal | Anúncios, Variações de Anúncios, Atributos de Anúncios | Anúncios |
| Ordens de serviço por técnico ou por motivo | Performance de Técnicos, Ordens de Serviço por Motivo | Ordem de Serviço |
Não achei relatório para o que eu preciso — e agora?
Primeiro confirme o que existe na sua conta: a lista de relatórios é montada a partir dos relatórios habilitados para a empresa, então o que não aparece na lista da tela não existe para você — não há um nome "oculto" para pedir ao suporte. Abra Relatórios → Gerar Relatório, percorra as abas de grupo e leia os nomes; é a única lista que vale.
Se nenhum relatório da lista responde à sua pergunta, estas telas resolvem boa parte dos pedidos que costumam chegar como "qual relatório traz…":
| O que você quer saber | Onde isso já existe |
|---|---|
| Quais SKUs vendem mais, giro, curva ABC, o que reabastecer | Compras → Análise de Compra — Curva ABC, vendas mês a mês, médias móveis e médias de venda por SKU/armazém, com exportação para Excel. Veja Análise de Compra |
| Todas as entradas e saídas de um produto, com saldo e custo médio acumulados | Produtos → Movimentação Kardex — a linha do tempo do SKU no armazém, com exportação. Veja Movimentação Kardex |
| Quanto tem de cada SKU, por armazém e por situação (disponível, reservado, em manuseio) | Produtos → Estoque. Veja Estoque |
| Um indicador próprio, com o corte que você quiser, atualizado e enviado por e-mail | Dashboards — medidas e dimensões sem escrever consulta, com PDF e envio agendado. Veja Dashboards |
| Um recorte que nenhuma tela cobre (por canal, por tipo de pedido, por período fechado) | A API — por exemplo GET /sku/movement (Lista movimentações de estoque), que aceita filtros de tipo de movimento, integração e período. Comece pelo portal da API |
Duas ressalvas que evitam perda de tempo:
- O grupo Customizado foi descontinuado. A tela onde esses modelos eram configurados saiu do sistema; pedir por ali não gera arquivo. Veja Quais grupos de relatórios existem?.
- Nome parecido não é o mesmo relatório. Antes de montar um processo em cima de um relatório, gere uma vez com um período curto e confira as colunas — o que ele traz está no arquivo, não no nome.
Para extração sob medida que nenhuma dessas saídas cobre, fale com o suporte do idworks e descreva as colunas e o período que você precisa (não o nome de um relatório): é isso que permite dizer se dá para montar com o que existe hoje.
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.
Você não precisa ficar vigiando: assim que o arquivo fica pronto, o idworks mostra um aviso na tela — Relatório pronto, com o nome do relatório e um link Baixar — para o usuário que pediu, esteja ele em qualquer tela do sistema. O link também chega por e-mail.
Para acompanhar pela lista, vá em Meus Relatórios — quando o relatório fica pronto, o Status muda para Gerado e o botão de download libera 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. |
Não existe um status de "erro": quando a geração falha, o relatório continua aparecendo como Processando e o arquivo nunca fica disponível — o sistema não tenta gerar de novo sozinho. Se um relatório ficar horas em Processando, considere que ele falhou e gere de novo (revisando os filtros).
Caso especial — relatório de um grupo que o sistema não gera mais. Se você pedir um relatório de um grupo que não tem geração disponível (é o caso do grupo Customizado, descontinuado, e de qualquer grupo novo cujos relatórios ainda não estejam implementados), o pedido é encerrado sem produzir arquivo. Na prática, na aba Meus Relatórios:
- O Status continua Processando — o sistema não cria um status "Erro" para esse caso, e a linha não muda mais depois disso.
- O botão Baixar pode ficar habilitado, mas não abre relatório nenhum: ele aponta para um destino inválido. Se clicar e não vier arquivo, é isso que aconteceu.
Não adianta gerar de novo nem esperar: enquanto o grupo não tiver relatórios disponíveis, o resultado será sempre esse. O sistema também não envia aviso na tela nem e-mail nessa situação — o e-mail com o link só chega quando o relatório é realmente gerado.
Caso especial — relatório recusado pelo sistema. Quando o idworks recusa o pedido por um motivo que você precisa saber (por exemplo, o vínculo do usuário com centro de distribuição, descrito em Como o vínculo com centro de distribuição afeta os relatórios?, um filtro com valor inválido ou um canal de vendas que não é de nenhuma empresa da conta), aparece na tela o aviso Relatório não gerado com o motivo, em qualquer tela do sistema em que você esteja. Na lista, a linha fica como no caso anterior: Status em Processando e botão Baixar possivelmente habilitado, sem abrir arquivo. Nenhum e-mail é enviado. Leia o motivo no aviso e, se for o caso, gere de novo.
A lista em si não se atualiza sozinha — recarregue a página para ver o status mais recente. O aviso de Relatório pronto com o link Baixar, esse sim, aparece na hora, sem recarregar.
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.
Se o relatório aparece, mas vem com menos dados do que o esperado, veja Como o vínculo com centro de distribuição afeta os relatórios?.
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"). Traz os atalhos Hoje, Ontem, Semana Atual, Semana Anterior, Mês Atual e Mês Anterior. Atenção às semanas: nesta tela, Semana Atual vai de hoje até daqui a 7 dias e Semana Anterior vai de 7 dias atrás até hoje — não são a semana do calendário. Se precisar de uma semana fechada, escolha as datas no calendário.
- 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, status, canal de venda).
- Texto livre — para busca textual (ex.: nome do cliente, número do pedido).
A combinação varia: o Comissão vendedor aceita datas, vendedor e tipo de pedido; o Anúncios aceita só a integração; o Clientes não tem filtro. A tela monta os campos conforme o que o catálogo informa para cada relatório selecionado — a lista por relatório está em Catálogo de relatórios por grupo.
Filtro de categoria do produto. Nos relatórios que filtram pela categoria do produto (como o Imagens itens e o Preços), o campo é uma árvore de categorias com caixas de seleção, já aberta, com busca pelo nome — o campo vem escrito Selecione uma Categoria. O nome do filtro muda de um relatório para outro: CATEGORIA no Imagens itens e Categoria no Preços. Outros filtros de categoria, como a CATEGORIA DO FORNECEDOR do relatório Fornecedores, continuam sendo uma lista comum. Na árvore, marque quantas categorias quiser. Alguns cuidados:
- Em empresa com mais de uma conta, o campo fica bloqueado até você escolher a Conta. Trocar a Conta limpa as categorias marcadas; ao abrir o campo de novo, a árvore traz as categorias da nova conta.
- Deixar o campo sem nada marcado não conta como filtro preenchido: se nenhum outro filtro estiver preenchido, a tela avisa Por favor, faça um filtro para Gerar o Relatório.
- Hoje, ao marcar uma categoria que tem subcategorias, a árvore marca todas as subcategorias dela, e o relatório recebe só as subcategorias do último nível — não a categoria-mãe. Como esses relatórios (o Imagens itens e o Preços, por exemplo) filtram pela categoria exata do SKU, um SKU cadastrado direto na categoria-mãe (e não numa subcategoria) fica de fora. Se você cadastra SKUs na categoria-mãe, gere sem o filtro de categoria (usando outro filtro do relatório, como a marca) e filtre a planilha depois.
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).
Posso pedir o link por e-mail?
Sim, e você não precisa ativar nada: o idworks já envia automaticamente o link de download para o e-mail cadastrado no usuário que gerou o relatório, assim que o arquivo fica pronto. Isso é especialmente útil em relatórios grandes, que podem levar minutos: você não precisa ficar checando a aba Meus Relatórios, o e-mail chega sozinho com o link direto.
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 (não há status de erro: relatório que falhou fica parado em Processando).
- Conta — empresa do relatório.
- Baixar — ícone de download, ativo quando há arquivo disponível (na prática, quando o status é Gerado). A exceção são os relatórios de grupos que o sistema não gera mais, em que o ícone pode ficar ativo sem abrir arquivo algum — veja O que significa cada status de relatório?.
Recarregue a página (ou volte à aba) para ver o status mais recente — a lista não se atualiza sozinha. Na prática você raramente precisa disso: o aviso Relatório pronto, com link Baixar, aparece na tela assim que o arquivo fica disponível.
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 ou Sem dados, o ícone fica desabilitado. Você também pode baixar direto pelo link Baixar do aviso Relatório pronto (ou pelo link que chega no e-mail), sem passar pela lista.
Por que a planilha vem com mais de uma aba?
Porque alguns relatórios entregam, no mesmo arquivo, listas auxiliares que ajudam a interpretar (ou a preencher de volta) a lista principal. Cada lista vem em uma aba separada, com o nome dela.
O relatório Clientes (grupo Vendas) é o exemplo mais completo. Além da aba de clientes, o arquivo traz:
| Aba | O que traz |
|---|---|
| Clientes | Um cliente por linha (com endereço, vendedores vinculados e, agora, a transportadora e a política comercial do cadastro do cliente). |
| Vendedores | Os vendedores ativos da conta. |
| Transportadoras | As transportadoras ativas cadastradas na conta, com nome e CNPJ. |
| Políticas Comerciais | As políticas comerciais cadastradas na conta. |
Alguns relatórios trazem ainda uma aba Ajuda, com a explicação de cada coluna e o formato esperado — é o caso de Preços, Produtos e SKU - Para Atualização, Itens X fornecedor, Categoria similar, Pendente vínculo e Clientes. Vale conferir essa aba antes de usar a planilha como base para atualização em massa.
Atenção em relatórios com abas auxiliares: o sistema considera a aba principal para decidir se houve resultado. Se a lista principal vier vazia, o relatório é marcado como Sem dados e nenhum arquivo é gerado, mesmo que as listas auxiliares tivessem conteúdo.
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á está 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á está 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, o caminho é reduzir o recorte: gere por períodos menores (semana ou quinzena, em vez do ano inteiro) e aplique os filtros mais restritivos que atendam à sua análise.
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.
Como o vínculo com centro de distribuição afeta os relatórios?
Se o seu usuário está vinculado a centros de distribuição (CDs) — aba Centro de Distribuição do cadastro de usuário —, os relatórios com dados de pedido ou de estoque saem recortados para esses CDs. Sem nenhum CD vinculado, o usuário gera o relatório completo.
O recorte vale para os relatórios de Vendas, Estoque, WMS, TMS e Ordem de Serviço que trazem dados de pedido ou de estoque, e para o Itens fiscal (entrada e saída), do grupo Fiscal. Depende do que o relatório lê:
- Quando o relatório parte do pedido, entram só os pedidos dos CDs vinculados (vale o CD do pedido). No Vendas Clientes, o total gasto de cada cliente também soma só esses pedidos.
- Quando o relatório parte do movimento, do saldo, do endereço ou do lote de estoque, entram só os armazéns dos CDs vinculados (vale o CD do armazém).
- Quando o relatório parte da lista de picking, do cesto ou do cadastro de CDs (WMS), entram só as listas, os cestos e os CDs vinculados ao seu usuário (vale o CD da própria lista, do cesto ou do cadastro).
- O custo médio não muda: continua sendo o da empresa toda.
- Pedido ou armazém sem CD informado não entra no relatório de quem tem CD vinculado.
- Se o filtro de armazém pede um armazém de outro CD, o relatório sai com status Sem dados.
- Os relatórios de Financeiro, Anúncios, Integração e Produtos não têm esse recorte. No grupo Fiscal, o Nota Fiscal (que lista a numeração inteira da série, inclusive notas de pedidos de outros CDs) e o Departamento e regras também saem completos.
Quando o idworks recusa o relatório. Por causa do vínculo com CD, dois avisos podem chegar na tela, com o título Relatório não gerado (veja o caso especial de relatório recusado):
Relatório de pedidos indisponível para usuário restrito por centro de distribuição— o relatório Fechamento/Faturamento só sai para quem tem CD vinculado quando a consulta cadastrada dele traz o recorte por CD. Sem o recorte, o idworks não gera o relatório, para não entregar pedidos de outros CDs. Peça o relatório a um usuário sem CD vinculado ou fale com o suporte do idworks.Não foi possível conferir o seu acesso ao centro de distribuição, tente de novo— o idworks não conseguiu ler os seus CDs naquele momento. Gere o relatório de novo.
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.
- Não se preocupe em pedir o e-mail — ele já chega sozinho. Para relatórios grandes, você pode seguir trabalhando: o sistema envia automaticamente o link por e-mail ao usuário que gerou o relatório assim que ele fica pronto, sem precisar ficar recarregando a tela.
- Não fique recarregando a lista para saber se terminou. A aba Meus Relatórios não atualiza sozinha, mas você não precisa vigiá-la: quando o arquivo fica pronto aparece o aviso Relatório pronto com link Baixar, e o link também chega por e-mail. Recarregue a página só quando quiser conferir o status na lista.
- Relatório parado em Processando por horas provavelmente falhou. Não existe status de erro e o sistema não tenta de novo sozinho — gere o relatório outra vez, de preferência com um período menor.
- 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, quebre o período. Quando um relatório demora demais, gere por partes (semana ou quinzena, em vez do ano inteiro) e use os filtros mais restritivos possíveis — sai mais rápido e com menos risco de ficar travado na fila.
- Não conte mais com o relatório customizado. A tela onde os relatórios sob medida eram configurados saiu do sistema e esse tipo de relatório não é mais gerado — se precisar de uma extração específica, fale com o suporte do idworks.
Resumo de parametrizações
Existe um grupo de parametrizações chamado Relatórios, mas ele não muda o comportamento desta tela: cada campo é um e-mail de destino de um relatório que o idworks monta e envia sozinho, em anexo (planilha), sem ninguém precisar gerar nada aqui. Para configurar, vá em Configurações → Parametrizações → Relatórios.
| Parametrização | Submenu | O que muda quando ativada |
|---|---|---|
| Email para receber relatório de estoque | Relatórios | Passa a receber o Alerta de estoque: planilha com os SKUs cuja quantidade disponível está abaixo da quantidade de alerta cadastrada no SKU (ou, quando ela não existe, abaixo do estoque de referência). Em branco, a conta não recebe esse e-mail. |
| Email para receber relatório de margem negativa | Relatórios | Passa a receber o Pedidos com margem negativa: planilha com os pedidos criados nos últimos dois dias cuja margem de contribuição ficou negativa. Em branco, a conta não recebe esse e-mail. |
| Email para receber relatório de pedidos de compra com recebimento em atraso | Relatórios | Passa a receber o Pedidos de compra em atraso: planilha com os pedidos de compra ainda pendentes (Aberto, Pedido Confirmado, Aguardando Recebimento ou Recebido Parcialmente) cuja data prevista de recebimento já passou. Em branco, a conta não recebe esse e-mail. |
Esses três e-mails são independentes da aba Meus Relatórios — eles não aparecem no histórico da tela, chegam direto na caixa de entrada dos endereços informados. Para avisar mais de uma pessoa, informe os endereços no mesmo campo separados por vírgula.
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 | Não tem efeito na tela de Relatórios: marcar ou desmarcar não muda a aba Customizado, e o grupo Customizado, descontinuado, não gera arquivo. |
| 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 mostra só os grupos que não têm privilégio próprio (Produtos, Ordem de Serviço e, se estiver habilitado na sua conta, Customizado). Para que o usuário gere relatórios dos demais grupos, dê o privilégio principal e o privilégio de cada grupo que ele deve usar.
Os grupos Produtos e Ordem de Serviço não têm privilégio próprio: qualquer usuário com Visualizar relatórios vê e gera os relatórios deles. Os privilégios das telas de Produtos e de Ordem de Serviço não escondem esses dois grupos aqui. A aba Customizado, quando habilitada na sua conta, também não depende de privilégio próprio: aparece para qualquer usuário com Visualizar relatórios, embora pedir um relatório por ali não gere arquivo.
A mesma regra vale para pedidos feitos por fora da tela. Quando um relatório é pedido pela API do idworks ou pela virgginIA no WhatsApp, o idworks confere os mesmos privilégios antes de aceitar o pedido: Visualizar relatórios mais o privilégio do grupo do relatório (só Visualizar relatórios para Produtos e Ordem de Serviço). Na tela isso quase não aparece, porque a aba do grupo já some para quem não tem o privilégio. Pela API, hoje a recusa vale só para quem está em algum grupo de privilégios da conta: um usuário que não está em nenhum grupo da conta ainda não tem o pedido recusado. As chaves de acesso de serviço liberadas para todas as contas também não passam por essa conferência. Quem está num grupo de privilégios da conta mas não tem o privilégio exigido tem o pedido recusado pela API com uma mensagem neste formato:
Falta o acesso “nome do privilégio” na conta conta para gerar o relatório “nome do relatório”. Peça ao administrador para incluí-lo no seu grupo.
Quando faltam os dois privilégios (o da tela e o do grupo), a mensagem cita os dois. O nome do acesso é o que aparece na tela de Perfis de Acesso, que pode estar escrito um pouco diferente da tabela desta página. A mensagem tem tamanho limitado: quando o texto fica longo, o nome do relatório é trocado por "este relatório" ou sai da mensagem. Outras recusas possíveis:
- Seu usuário está inativo e não pode gerar relatórios. Fale com o administrador da conta. — o usuário está inativo ou não foi encontrado.
- Não foi possível validar o privilégio para gerar o relatório. Tente novamente. — a conferência não conseguiu ser feita naquele momento; peça o relatório de novo.
No pedido feito pela virgginIA, a conferência do privilégio do grupo acontece antes, na própria conversa, e vale também para quem não está em nenhum grupo da conta: a resposta avisa que falta a permissão do grupo do relatório.