Pular para o conteúdo principal

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 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 (CompanyReport) e os privilégios por grupo decidem quais o usuário consegue ver.

Índice​

Conceito

Gerar relatório

Meus relatórios

Regras de negócio

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:

GrupoO que inclui
VendasPedidos por período, ranking de produtos, vendas por canal, comissão de vendedor, ticket médio.
FinanceiroContas a pagar/receber, fluxo de caixa, conciliação adquirente, extrato bancário.
FiscalNotas fiscais emitidas, NFCe, NFSe, livro fiscal, GNRE.
EstoquePosição de estoque, movimentação, inventário, curva ABC.
WMS (Logística interna)Picking, packing, conferência, inconformidades.
TMS (Transporte)Romaneios, custo de frete, cotação, prazos de entrega.
AnúnciosPerformance de anúncios nos marketplaces.
IntegraçãoImportações e exportações por canal de venda.
CustomizadoRelató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 é colocado em uma fila de processamento (SQS) e o sistema responde imediatamente que o relatório está em processamento. Um worker (programa que processa fila) pega o pedido, executa a query no banco, monta o arquivo e atualiza o registro com o link de download.

Esse modelo é necessário porque alguns relatórios consultam muitos dados (milhões de linhas, agregações pesadas) 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á:

StatusSignificado
Pendente / Em filaO pedido foi enfileirado e está aguardando o worker pegar.
ProcessandoO worker já pegou o pedido e está executando a query / montando o arquivo.
ConcluídoO arquivo foi gerado e está disponível para download (botão Baixar ativo).
ErroAlgum problema impediu a geração. O campo Comentários geralmente traz a mensagem do erro.

A lista é atualizada a cada recarga — não há atualização em tempo real (não há push); 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:

  1. Escolha a aba do grupo (Vendas, Financeiro, Fiscal, etc.) e a sub-aba do relatório específico.
  2. 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 (exceto em alguns relatórios sem filtro obrigatório, como o de id 36).
  3. (Quando a empresa tem mais de uma conta) Escolha a Conta no topo.
  4. 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 Pendente ou Processando. Acompanhe ali — quando o status muda para Concluído, 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 (TypeCompanyReportQuery). Os tipos de filtro comuns são:

  • Intervalo de datas (RangerPicker) — para período (ex.: "de 01/01/2026 a 31/01/2026"). Aceita atalhos como "Hoje", "Semana", "Mês".
  • Par de valores (InputGroup) — para faixas numéricas (ex.: valor mínimo e máximo).
  • Seleção (Select) — para escolher entre opções pré-carregadas (ex.: integração adquirente, status, canal de venda).
  • Texto livre (Input) — para busca textual (ex.: nome do cliente, número do pedido).

A combinação varia: o relatório de Pedidos por período pede DateFrom/DateTo; 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.

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 — pendente / processando / concluído / erro.
  • Conta — empresa do relatório.
  • Baixar — ícone de download (ativo só quando o status é concluído).

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 Concluído, 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.

Quando o status é Pendente, Processando ou 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,
  • Ainda não concluído (sem link de download disponível),
  • Status pendente,
  • 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 SQS processa um relatório por vez por empresa (MessageGroupId = subdomínio da 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.

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égioLibera
Visualizar relatóriosAcesso à tela e à aba Meus Relatórios (histórico).
Relatório AnúnciosVê e gera relatórios do grupo Anúncios.
Relatório CustomizadoVê e gera relatórios do grupo Customizado (configurados em Relatório Customizado).
Relatório EstoqueVê e gera relatórios do grupo Estoque.
Relatório FinanceiroVê e gera relatórios do grupo Financeiro.
Relatório FiscalVê e gera relatórios do grupo Fiscal.
Relatório IntegraçãoVê e gera relatórios do grupo Integração.
Relatório TMSVê e gera relatórios do grupo TMS (Transporte).
Relatório VendasVê e gera relatórios do grupo Vendas.
Relatório WMSVê 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.