> For the complete documentation index, see [llms.txt](https://docs.sellermagnet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sellermagnet.com/pt-or-guia-do-sellermagnet/dashboard-e-analises/dashboard-overview/reports.md).
# Relatórios
{% hint style="info" %}
**Dificuldade:** 🟢 Iniciante · **Tempo de leitura:** \~15 min
{% endhint %}
{% hint style="success" icon="rocket" %}
**Abrir esta página no seu painel:** [**Ir para Relatórios →**](https://dashboard.sellermagnet.com/dashboard/reports)
{% endhint %}
A página de **Relatórios** é o seu centro para gerar, gerenciar e baixar exportações de dados personalizadas do SellerMagnet. Seja para um relatório financeiro pontual para o seu contador, um resumo semanal de vendas para sua equipe ou uma exportação mensal de desempenho para partes interessadas, o modulo de Relatórios cuida de tudo com tipos de relatórios flexiveis, agendamento e opções de entrega.
{% hint style="info" %}
Os relatórios extraem dados de todos os outros modulos do SellerMagnet, pedidos, produtos, transações, despesas e desempenho de listagens. Eles fornecem um instantâneo dos seus dados no momento da geração, formatados para fácil consumo fora do SellerMagnet.
{% endhint %}
***
## Vídeo Explicativo
{% hint style="info" %}
**Tutorial em vídeo em breve.** Um guia completo desta funcionalidade estará disponível aqui em breve.
{% endhint %}
***
## 🗂️ Estrutura da Página
| Seção | Finalidade |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Resumo de Estatisticas** | Quatro cartões de estatisticas mostrando contagens de relatórios totais, concluidos, pendentes e com falha |
| **Barra de Ações Rapidas** | Botoes para gerar, agendar e atualizar relatórios |
| **Abas de Filtro por Status** | Filtre a tabela de relatórios por status (Todos, Concluidos, Pendentes, Com Falha) |
| **Barra de Pesquisa** | Pesquise relatórios por tipo ou nome |
| **Tabela de Relatórios** | Lista completa de todos os relatórios gerados com status, download e ações |
| **Seção de Relatórios Agendados** | Tabela de agendamentos de relatórios recorrentes com status e informações da próxima execução |
***
## Resumo de Estatisticas
Quatro cartões de estatisticas no topo fornecem um resumo rápido da sua atividade de relatórios:
| Cartão de Estatistica | Descrição | Indicador de Cor |
| --------------------- | ---------------------------------------------------------- | ---------------- |
| **Relatórios Totais** | Número total de relatórios já gerados | Azul |
| **Concluidos** | Relatórios finalizados com sucesso e prontos para download | Verde |
| **Pendentes** | Relatórios sendo gerados ou na fila | Amarelo/Ambar |
| **Com Falha** | Relatórios que encontraram um erro durante a geração | Vermelho |
Cada cartão e **clicável**, clicar em um cartão de estatistica filtra a tabela para mostrar apenas relatórios com aquele status.
{% hint style="info" %}
Relatórios pendentes normalmente são concluidos em 1-5 minutos, dependendo do volume de dados e do período. Relatórios muito grandes (mais de 12 meses em vários marketplaces) podem levar até 15 minutos.
{% endhint %}
***
## Barra de Ações Rapidas
A barra de ações fornece os controles principais:
| Botão | Ação | Descrição |
| ------------------------------------- | ------------------------------------ | ---------------------------------------------- |
| **Gerar Relatório** (azul, principal) | Abre o modal de geração de relatório | Crie um novo relatório pontual |
| **Agendar Relatório** | Abre o modal de agendamento | Configure um relatório recorrente automatizado |
| **Atualizar** | Recarrega a lista de relatórios | Atualize a tabela com os status mais recentes |
***
## Abas de Filtro por Status
Abaixo dos botões de ação, as abas de filtro permitem refinar a lista de relatórios:
| Aba | Mostra | Badge |
| -------------- | ------------------------------------------ | ---------------------- |
| **Todos** | Todos os relatórios independente do status | Contagem total |
| **Concluidos** | Apenas relatórios gerados com sucesso | Contagem de concluidos |
| **Pendentes** | Relatórios em processamento | Contagem de pendentes |
| **Com Falha** | Relatórios que encontraram erros | Contagem de falhas |
***
## 📤 Tabela de Relatórios
A tabela principal exibe todos os seus relatórios gerados.
### Colunas da Tabela
| Coluna | Descrição |
| --------------------- | ------------------------------------------------------------------------------- |
| **Tipo de Relatório** | Tipo do relatório (ex.: Pedidos, Produtos, Transações, Desempenho de Listagens) |
| **Conexao** | Conta/conexão do Amazon Seller a partir da qual o relatório foi gerado |
| **Marketplaces** | Qual(is) marketplace(s) o relatório abrange |
| **Período** | Intervalo de datas coberto pelo relatório |
| **Solicitado Em** | Data e hora em que o relatório foi solicitado |
| **Formato** | Formato do arquivo (CSV, XLSX, JSON) |
| **Registros** | Número de linhas de dados no relatório |
| **Status** | Status atual: Inicial, Pendente, Processando, Concluido, Com Falha |
| **Ação** | Botoes de download ou nova tentativa |
### Badges de Status
| Status | Aparencia | Significado |
| --------------- | ------------------------------------ | -------------------------------------------------------------------- |
| **Inicial** | Amarelo/ambar (contado em Pendentes) | O relatório acabou de ser enviado e está aguardando o worker pega-lo |
| **Concluido** | Badge verde com marca de verificação | Relatório pronto para download |
| **Pendente** | Badge amarelo/ambar com relogio | Relatório na fila ou em processamento |
| **Processando** | Badge azul com spinner | Relatório sendo gerado ativamente |
| **Com Falha** | Badge vermelho com exclamação | Geração do relatório encontrou um erro |
### Ações
| Ação | Ícone | Descrição |
| -------------------- | ------------------------- | ---------------------------------------------------- |
| **Download** | Ícone de download (verde) | Baixar o arquivo do relatório concluido |
| **Tentar Novamente** | Ícone de retry | Tentar novamente a geração de um relatório com falha |
| **Excluir** | Ícone de lixeira | Remover o registro do relatório |
***
## 👣 Passo a Passo: Gerando um Relatório Pontual
1. Clique no botão **"Gerar Relatório"** na Barra de Ações Rapidas.
2. O modal de geração de relatório será aberto.
3. Preencha os parâmetros do relatório:
| Campo | Descrição | Exemplo |
| --------------------- | --------------------------------------------- | --------------------- |
| **Tipo de Relatório** | Selecione o tipo de dados desejado | Relatório de Pedidos |
| **Conexao** | Escolha de qual conta Amazon extrair os dados | Minha Conta Amazon EU |
| **Marketplace(s)** | Selecione um ou mais marketplaces | Amazon.de, Amazon.fr |
| **Data de Início** | Início do período do relatório | 2026-01-01 |
| **Data de Termino** | Fim do período do relatório | 2026-03-31 |
| **Formato** | Escolha o formato do arquivo de saída | CSV |
4. Clique em **"Gerar"** para enviar a solicitação do relatório.
5. O modal fecha e o relatório aparece na tabela com status "Pendente".
6. Aguarde o status mudar para "Concluido" (normalmente 1-5 minutos).
7. Clique no botão **Download** para salvar o arquivo.
{% hint style="success" icon="rocket" %}
**Dica Pro:** Gere relatórios trimestrais no primeiro dia útil de cada novo trimestre. Isso cria um arquivo consistente dos dados do seu negócio na Amazon para análise de tendências e preparação tributaria.
{% endhint %}
***
## 📤 Tipos de Relatórios Disponiveis
| Tipo de Relatório | Dados Incluidos | Melhor Para |
| ---------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- |
| **Relatório de Pedidos** | Todos os registros de pedidos com produtos, taxas, COGS, lucro | Contabilidade, preparação tributaria, análise de lucratividade |
| **Relatório de Produtos** | Catálogo de produtos com volumes de vendas, margens, ROI | Revisão de desempenho de produtos, decisões de sourcing |
| **Relatório de Transações** | Todas as taxas e ajustes da Amazon | Análise de taxas, otimização de custos |
| **Relatório de Desempenho de Listagens** | Sessoes, visualizações de página, conversão, % Buy Box | Análise de marketing, otimização de listagens |
| **Relatório de Despesas** | Todas as despesas empresariais rastreadas manualmente | Deduções fiscais, revisão de orçamento |
| **Relatório de Inventário** | Níveis de estoque, previsoes, dados de lotes | Planejamento de reposição, gestão de armazém |
| **Relatório de Lucros e Perdas** | P\&L abrangente combinando todas as fontes de dados | Revisão mensal/trimestral do negócio |
***
## ⚡ Relatórios de Exportação Direta (Instantâneos)
Algumas entradas no dropdown de tipo de relatório são marcadas com um **⚡ raio**. Essas são fontes de **exportação direta** (sincronas): em vez de serem enfileiradas para um worker em segundo plano, elas geram **sincronamente** e o arquivo é **baixado imediatamente** no seu navegador. Não há uma linha "Pendente" para aguardar nesses casos.
{% hint style="info" %}
Relatórios padrão são enfileirados e aparecem na tabela com um status que você atualiza até "Concluido". Relatórios de exportação direta ⚡ pulam a fila: clique em Gerar e o arquivo comeca a ser baixado imediatamente.
{% endhint %}
As fontes de exportação direta atualmente incluem Pedidos, Pedidos Reembolsados, Produtos e COGS, Despesas, Desempenho de Listagens, Transações / Repasses, Solicitações de Avaliação, Campanhas PPC, Palavras-chave PPC, Histórico de Consultas do Sourcer e um Resumo Financeiro.
### Instantâneos (sem período)
Algumas fontes de exportação direta são **instantâneos pontuais** dos seus dados atuais, então não precisam de um período. Ao selecionar uma delas, os campos de Data de Início e Data de Termino desaparecem.
| Fonte de instantâneo | O que captura |
| ------------------------------------- | ------------------------------------- |
| **Produtos e COGS** | Estado atual do catálogo e dos custos |
| **Despesas** | Ledger completo de despesas |
| **Histórico de Consultas do Sourcer** | Tudo o que você consultou |
| **Campanhas PPC** | Lista atual de campanhas |
| **Palavras-chave PPC** | Lista atual de palavras-chave |
As demais fontes de exportação direta (Pedidos, Pedidos Reembolsados, Transações, Desempenho de Listagens, Solicitações de Avaliação, Resumo Financeiro) ainda exigem uma Data de Início e de Termino.
### Pré-visualize antes de gerar
Apenas para fontes de exportação direta ⚡, um botão **Pré-visualizar** aparece no modal de geração. Clique nele para carregar uma pequena **amostra de linhas e colunas** para que você possa confirmar que escolheu a fonte, o marketplace e o período corretos antes de baixar o arquivo completo.
{% hint style="success" icon="rocket" %}
**Dica Pro:** Use **Pré-visualizar** para conferir as colunas e algumas linhas primeiro. Se a amostra voltar vazia, seu marketplace ou período provavelmente não tem dados, ajuste os filtros antes de gerar a exportação completa.
{% endhint %}
***
## 📤 Relatórios Agendados
A seção de Relatórios Agendados permite automatizar a geração recorrente de relatórios.
### Colunas da Tabela de Relatórios Agendados
| Coluna | Descrição |
| --------------------- | -------------------------------------------------------------------- |
| **Tipo de Relatório** | Tipo de relatório sendo gerado |
| **Frequência** | Com que frequência o relatório e executado (Diário, Semanal, Mensal) |
| **Entrega** | Como o relatório e entregue (Download, E-mail) |
| **Formato** | Formato do arquivo (CSV, XLSX, JSON) |
| **Próxima Execução** | Data e hora da próxima geração agendada |
| **Última Execução** | Data e hora da geração mais recente |
| **Status** | Ativo ou Pausado |
| **Ação** | Editar, pausar/retomar ou excluir o agendamento |
### Passo a Passo: Criando um Relatório Agendado
1. Clique no botão **"Agendar Relatório"** na Barra de Ações Rapidas.
2. O modal de agendamento será aberto.
3. Configure o agendamento:
| Campo | Descrição | Exemplo |
| --------------------- | -------------------------------- | ---------------------------- |
| **Tipo de Relatório** | Tipo de relatório | Relatório de Pedidos |
| **Conexao** | Conta Amazon | Minha Conta Amazon EU |
| **Marketplace(s)** | Marketplaces alvo | Todos os Marketplaces EU |
| **Frequência** | Com que frequência gerar | Semanal (toda segunda-feira) |
| **Período** | Que período cada relatório cobre | Últimos 7 dias |
| **Formato** | Formato de saída | CSV |
| **Método de Entrega** | Como receber o relatório | E-mail + Download |
4. Clique em **"Salvar Agendamento"** para ativar.
5. O agendamento aparece na tabela de Relatórios Agendados com status "Ativo".
{% hint style="warning" %}
Relatórios agendados são gerados automaticamente no horário configurado. Certifique-se de que seu endereço de e-mail está correto em Configurações se você selecionou entrega por e-mail. Relatórios que falham na entrega por e-mail ainda estão disponíveis para download manual.
{% endhint %}
### Gerenciando Relatórios Agendados
| Ação | Como Fazer |
| -------------------------- | ---------------------------------------------------------------------------------- |
| **Pausar um agendamento** | Clique no botão de pausa na linha do agendamento |
| **Retomar um agendamento** | Clique no botão de retomar em um agendamento pausado |
| **Editar um agendamento** | Clique no botão de editar para modificar frequência, intervalo de datas ou entrega |
| **Excluir um agendamento** | Clique no botão de excluir para remover permanentemente o agendamento |
***
## 📤 Cenário Real: Fluxo de Relatórios Mensais
**Situação:** Você gerência um negócio na Amazon e precisa fornecer dados financeiros mensais ao seu contador.
| Relatório | Agendamento | Finalidade |
| --------------------------- | ------------------------------------------------ | -------------------------------------------------------------- |
| **Relatório de Pedidos** | Mensal, dia 1 de cada mês, dados do mês anterior | Registros completos de pedidos para reconciliação de receita |
| **Relatório de Transações** | Mensal, dia 1 de cada mês, dados do mês anterior | Detalhamento de taxas da Amazon para categorização de despesas |
| **Relatório de Despesas** | Mensal, dia 1 de cada mês, dados do mês anterior | Despesas empresariais manuais para rastreamento de deduções |
| **Relatório de P\&L** | Mensal, dia 1 de cada mês, dados do mês anterior | Demonstrativo combinado de lucros e perdas |
Configure esses quatro agendamentos uma vez, e seu contador receberá dados limpos todo mês sem nenhum esforco manual.
{% hint style="success" icon="rocket" %}
**Dica Pro:** Crie um relatório agendado "Desempenho Q4" que executa semanalmente durante outubro a dezembro. Durante sua temporada mais movimentada, dados semanais ajudam a tomar decisões mais rapidas sobre inventário, preços e publicidade.
{% endhint %}
***
## 📊 Cenário Real: Um Relatório de P\&L de Março, do Início ao Fim
**Situação:** É 2026-04-01 e seu contador precisa de um demonstrativo de Lucros e Perdas de março. Você vende na Amazon.de através da sua conexão "Minha Conta Amazon EU".
**Passos:**
1. Clique em **Gerar Relatório** e escolha **Relatório de Lucros e Perdas** como o Tipo de Relatório.
2. Defina a **Conexão** como *Minha Conta Amazon EU* e o(s) **Marketplace(s)** como *Amazon.de*.
3. Defina a **Data de Início** como `2026-03-01` e a **Data de Termino** como `2026-03-31`.
4. Escolha **XLSX** como o formato (seu contador o revisa manualmente) e clique em **Gerar**.
5. A linha aparece como **Pendente**, passa para **Processando** e chega a **Concluido** após cerca de dois minutos. Clique em **Download**.
**O que o arquivo contém:** O Relatório de P\&L combina seus dados de Pedidos, Transações e Despesas do período em um único demonstrativo. Para março, ele se resume em:
| Linha | Valor (EUR) |
| ---------------------------------- | ------------- |
| Receita bruta de produtos | 48.250,00 |
| Reembolsos | -2.180,00 |
| **Receita líquida** | **46.070,00** |
| Taxas Amazon (referral + FBA) | -11.540,00 |
| COGS (Custo dos Produtos Vendidos) | -18.900,00 |
| Gasto com PPC / publicidade | -3.420,00 |
| Despesas empresariais rastreadas | -1.150,00 |
| **Lucro líquido** | **11.060,00** |
O total de taxas Amazon corresponde ao que um **Relatório de Transações** independente para a mesma janela de março somaria, e o valor de COGS reflete os custos por unidade que você mantém em Produtos. O VAT é tratado separadamente pelo seu contador e não é abatido nesta linha de lucro.
{% hint style="info" %}
A coluna **Registros** conta o número de linhas de dados gravadas no arquivo, não um valor monetário. Para uma exportação por pedido, é o número de linhas de pedido; para um demonstrativo combinado como o P\&L, é o número de entradas de resumo e de linha que o arquivo contém. Um relatório **Concluido** mostrando **0** registros significa que a consulta funcionou bem mas seu marketplace e período não tinham dados - reveja os filtros em vez de tentar novamente.
{% endhint %}
{% hint style="warning" %}
**Tentar novamente vs. execução nova para um relatório agendado com falha:** Se uma instância agendada terminar em **Com Falha**, o agendamento em si não é afetado - ele ainda dispara no próximo intervalo e gera do zero para a nova janela relativa (por exemplo, os próximos "últimos 7 dias"). Clicar em **Tentar Novamente** na linha com falha, por outro lado, tenta novamente essa mesma instância para o seu período original. Use **Tentar Novamente** para recuperar o relatório específico que você perdeu; aguarde a próxima execução se você só precisa do período atual.
{% endhint %}
***
## 📤 Formatos de Arquivo de Relatórios
| Formato | Melhor Para | Vantagens | Limitações |
| -------- | -------------------------------------------------------- | ----------------------------------------------------- | --------------------------------------- |
| **CSV** | Importação em software contabil, análise de dados | Compatibilidade universal, tamanho de arquivo pequeno | Sem formatação, sem múltiplas planilhas |
| **XLSX** | Revisão manual, compartilhamento com partes interessadas | Tabelas formatadas, múltiplas planilhas possíveis | Tamanho de arquivo maior, requer Excel |
***
## 🔧 Solução de Problemas em Relatórios com Falha
Quando um relatório falha, verifique estas causas comuns:
| Causa | Sintoma | Solução |
| ------------------------------------ | --------------------------------- | ------------------------------------------------------------------------ |
| Período muito grande | Relatório expira | Reduza o período ou divida em períodos menores |
| Limite de taxa da API da Amazon | Falhas intermitentes | Aguarde 10 minutos e tente novamente |
| Sem dados para o período selecionado | Relatório conclui com 0 registros | Verifique se o marketplace e o período possuem dados reais |
| Conexao expirada | Erro de autenticação | Re-autentique sua conexão Amazon em Configurações |
| Erro de processamento do servidor | Falha inesperada | Clique em Tentar Novamente; se persistir, entre em contato com o suporte |
{% hint style="danger" %}
Se um relatório falhar repetidamente, não crie dezenas de tentativas de retry. Isso pode enfileirar trabalhos de processamento redundantes. Tente uma ou duas vezes, depois entre em contato com o suporte do SellerMagnet informando o ID do relatório.
{% endhint %}
***
⚠️ Erros Comuns a Evitar
| Erro | Impacto | Abordagem Melhor |
| -------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------- |
| Gerar relatórios duplicados | Desperdica recursos de processamento e polui a tabela | Verifique relatórios existentes antes de gerar um novo |
| Definir períodos muito amplos | Geração lenta, arquivos enormes | Use períodos mensais ou trimestrais em vez de ano inteiro |
| Não baixar relatórios concluidos | Relatórios podem ser removidos após um período de retenção | Baixe prontamente ou configure entrega por e-mail |
| Ignorar relatórios com falha | Dados faltantes para contabilidade ou análise | Investigue falhas e tente novamente |
| Sem relatórios agendados | Depender de geração manual todo mês | Automatize relatórios recorrentes com o recurso de agendamento |
| Seleção de marketplace errada | Dados do relatório não correspondem as expectativas | Verifique a seleção de marketplace antes de gerar |
\## ✅ Melhores Práticas
1. **Automatize relatórios mensais:** Configure agendamentos para seus quatro relatórios principais (Pedidos, Transações, Despesas, P\&L) no dia 1 de cada mês.
2. **Use CSV para processamento de dados:** Se você planeja importar dados em software contabil, sempre escolha o formato CSV.
3. **Use XLSX para revisão humana:** Se o relatório será lido por uma pessoa, XLSX oferece melhor formatação.
4. **Mantenha períodos gerenciáveis:** Relatórios mensais são ideais. Trimestrais são aceitaveis. Relatórios anuais devem ser divididos por trimestre.
5. **Monitore a fila de Pendentes:** Se você ver relatórios presos em Pendente por mais de 15 minutos, verifique o status da sua conexão.
6. **Arquive relatórios importantes:** Baixe e armazene relatórios críticos no seu armazenamento em nuvem para registro de longo prazo.
7. **Limpeza trimestral:** Exclua relatórios antigos e desnecessarios para manter sua página de Relatórios organizada.
***
## 📤 Comparação: Relatórios Pontuais vs. Agendados
| Recurso | Relatório Pontual | Relatório Agendado |
| ----------------- | ----------------------------------------- | ------------------------------------------------------------- |
| **Geração** | Acionamento manual | Automático conforme agendamento |
| **Período** | Qualquer intervalo personalizado | Relativo a data de execução (ex.: "últimos 7 dias") |
| **Entrega** | Apenas download | Download + e-mail opcional |
| **Frequência** | Unica vez | Diário, semanal ou mensal |
| **Caso de uso** | Análise ad hoc, investigações especificas | Relatórios recorrentes, atualizações para partes interessadas |
| **Gerenciamento** | Excluir quando não for mais necessário | Pausar, retomar ou modificar o agendamento |
***
## ❓ FAQ
Por quanto tempo os relatórios concluidos ficam disponíveis para download?
Relatórios concluidos são retidos por 90 dias. Após esse período, o registro do relatório pode ser removido. Baixe relatórios importantes prontamente ou configure entrega por e-mail para arquivamento automático.
Posso gerar relatórios para vários marketplaces em um único arquivo?
Sim. Ao criar um relatório, você pode selecionar vários marketplaces. O arquivo gerado contera dados de todos os marketplaces selecionados com uma coluna identificadora de marketplace.
Em qual fuso horário as datas dos relatórios se baseiam?
Os relatórios usam UTC como fuso horário base para cálculos de datas. A coluna "Solicitado Em" mostra o horário no seu fuso horário local. Os filtros de intervalo de datas (Data de Início/Data de Termino) são interpretados no fuso horário local do marketplace.
Posso personalizar quais colunas aparecem em um relatório?
Os formatos de relatório são padronizados para incluir todas as colunas relevantes para o tipo de relatório selecionado. A personalização de colunas não está disponível no momento. Você pode remover colunas indesejadas após baixar o arquivo.
Existe um limite de quantos relatórios posso gerar?
Não ha um limite rígido, mas gerar muitos relatórios grandes simultaneamente pode tornar o processamento mais lento. Recomendamos gerar um relatório grande por vez e aguardar sua conclusao antes de iniciar o próximo.
Relatórios agendados podem ser enviados para vários enderecos de e-mail?
Atualmente, relatórios agendados são entregues no e-mail principal da conta. Para entrega a vários destinatarios, encaminhe o e-mail ou use armazenamento em nuvem compartilhado para os arquivos baixados.
O que acontece se um relatório agendado falhar?
O agendamento continua a ser executado no próximo intervalo. A instância com falha aparece na Tabela de Relatórios com status "Com Falha". Você receberá uma notificação sobre a falha. A próxima execução agendada tentara a geração desde o início.
***
## ➡️ O que vem a seguir?
{% content-ref url="/pages/10fwKhew1tVPNE56KKOT" %}
[Visão Geral do Dashboard](/pt-or-guia-do-sellermagnet/dashboard-e-analises/dashboard-overview.md)
{% endcontent-ref %}
{% content-ref url="/pages/OFSJgeqIu2m00gIoj3H7" %}
[Despesas](/pt-or-guia-do-sellermagnet/dashboard-e-analises/dashboard-overview/expenses.md)
{% endcontent-ref %}