Perguntas Frequentes

O contador de Ofertas exibe o total de promoções e preços especiais monitorados em todos os supermercados cadastrados no sistema. Inclui ofertas de encartes, campanhas e reduções temporárias de preço.

O indicador Hoje mostra quantas novas ofertas foram coletadas e registradas no banco de dados nas últimas 24 horas. É atualizado automaticamente pelo scraper a cada ciclo de coleta.

Indica o número de cidades distintas onde existem ofertas monitoradas. As cidades são detectadas automaticamente a partir dos dados dos supermercados.

Exibe o total de redes de supermercados diferentes (ex: Carrefour, Pão de Açúcar, Atacadão) cujas ofertas estão sendo acompanhadas.

O status de sincronização mostra a última vez que o scraper automático (n8n) coletou dados de ofertas dos supermercados. O ponto verde indica que a coleta está ativa e funcionando.

• Ponto verde: sincronização recente (últimas 24h)
• Ponto amarelo: sem atualização há mais de 24h
• Ponto vermelho: mais de 48h sem atualização

Compara o preço médio de um produto em toda a região (cidade/estado) com o preço praticado por um supermercado específico. Útil para identificar se um supermercado está acima ou abaixo da média regional.

• Eixo X: Produtos ou categorias
• Eixo Y: Preço em R$
• Barras azuis: Média da região
• Barras roxas: Preço do supermercado selecionado

Permite comparar o preço médio de um produto ou categoria entre diferentes cidades ou estados. Ideal para análises de precificação geográfica e expansão regional.

• Cada barra representa uma cidade/região diferente
• Configure até 5 cidades simultaneamente

Gráfico de linha temporal que mostra como o preço de um produto variou ao longo do tempo. Perfeito para identificar tendências de alta, sazonalidade e flutuações.

• Eixo X: Datas (dias, semanas ou meses)
• Eixo Y: Preço em R$
• Use o zoom para explorar períodos específicos

Lista os supermercados ordenados pelo menor preço médio para o produto ou categoria selecionada. Ajuda a identificar onde estão os melhores preços.

• Barras horizontais — o mais barato no topo
• Cores indicam a variação em relação à média

Compara preços de itens similares do mesmo segmento entre diferentes marcas e supermercados. Ajuda a entender o posicionamento de preço de cada marca em relação à concorrência.

Os filtros globais (barra no topo da tela) aplicam a mesma condição a todos os gráficos simultaneamente. Ao definir uma categoria, período ou cidade e clicar em "Aplicar", todos os widgets serão recalculados com os novos critérios.

• Período Inicial / Final: Delimita o intervalo de datas das ofertas
• Categoria: Filtra por tipo de produto (Mercearia, Bebidas, etc.)
• Estado (UF): Filtra por unidade federativa
• Cidade: Filtra por município (ex: Campinas, Valinhos)
• Supermercado: Filtra por rede específica (ex: Atacadão)
• Produto / Marca: Busca textual por nome do produto ou marca

Clique em "✖ Limpar" para remover todos os filtros e voltar à visão geral.

Sim! Clique no ícone de engrenagem (⚙️) que aparece no canto de cada widget. Um painel lateral será aberto onde você pode definir filtros específicos para aquele gráfico, como produto, cidade ou supermercado. Isso permite ter gráficos com visões diferentes na mesma tela.

A Visão Estratégica é um painel executivo que apresenta métricas financeiras e projeções baseadas nos dados coletados. Inclui:

• Revenue Target (Meta de Receita): Projeção de faturamento para o período
• Active Clients (Clientes Ativos): Número de clientes ativos na base
• Avg Margin Rate (Margem Média): Percentual médio de margem de lucro
• Stockout Rate (Taxa de Ruptura): Percentual de produtos em falta nas gôndolas

Os três cenários representam projeções financeiras:

• Worst Case (Pior Cenário): Projeção pessimista — considera baixa adesão de clientes e preços abaixo do esperado
• Base Case (Cenário Base): Projeção realista — baseada nas tendências atuais do mercado
• Best Case (Melhor Cenário): Projeção otimista — considera crescimento acelerado e condições favoráveis

A tabela Income Statement (DRE — Demonstrativo de Resultado) apresenta uma projeção simplificada de receitas e custos para cada cenário. As linhas incluem:

• Revenue (Receita): Total de vendas projetado
• COGS (Custo dos Produtos): Custo direto de aquisição das mercadorias
• Gross Profit (Lucro Bruto): Receita menos custo dos produtos
• Opex (Despesas Operacionais): Custos de operação (equipe, aluguel, tecnologia)
• EBITDA: Lucro antes de juros, impostos, depreciação e amortização
• Net Income (Lucro Líquido): Resultado final após todas as deduções

O upload de XML permite enviar Notas Fiscais Eletrônicas (NF-e) para que o sistema extraia automaticamente dados de compras (notas de entrada) e vendas (notas de saída). Com esses dados, o sistema recalcula a estratégia financeira da empresa.

Apenas arquivos no formato XML são aceitos. Esse é o formato padrão das NF-e (Notas Fiscais Eletrônicas) emitidas no Brasil. Não são aceitos PDF, JPG, PNG ou outros formatos. O tamanho máximo por arquivo é de 10 MB.

Existem duas formas de acessar o upload:

• Clique no menu hamburger (☰) no canto superior esquerdo e selecione "📤 Upload de Faturas (XML)"
• Acesse diretamente a página Visão Estratégica — o modal de upload estará disponível no menu

Selecione o arquivo XML no seu computador. O sistema irá processá-lo automaticamente e atualizar os dados estratégicos.

O arquivo XML em si é processado e excluído do servidor após a extração dos dados. Apenas as informações relevantes (valores, produtos, fornecedores) são armazenadas de forma segura para cálculos estratégicos.

No painel principal, clique em "📄 CSV" para baixar em formato texto separado por vírgulas, ou "📊 Excel" para baixar em formato .xlsx compatível com Microsoft Excel e Google Sheets.

A exportação respeita os filtros globais aplicados — ou seja, se você filtrou por "Campinas" e "Bebidas", apenas esses dados serão exportados.

Use os botões no canto superior direito:

• 💾 (Salvar): Salva a posição, tamanho e configuração de todos os gráficos no navegador
• ↺ (Resetar): Restaura o layout padrão com os gráficos iniciais

O layout é salvo localmente no seu navegador. Se trocar de computador, o layout padrão será carregado.

O sistema possui os seguintes níveis de permissão:

• Admin: Acesso total — gerencia usuários, configurações e todos os dados
• Gestão: Acesso ao painel administrativo e todas as análises
• Nacional: Visualiza dados de todo o país
• Estadual: Visualiza dados filtrados pelo seu estado
• Regional: Visualiza dados filtrados pela sua região/cidade