# 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:
| Cartao 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 **clicavel**, 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 varios 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: Concluido, Pendente, Processando, Com Falha |
| **Ação** | Botoes de download ou nova tentativa |
### Badges de Status
| Status | Aparencia | Significado |
| --------------- | ------------------------------------ | -------------------------------------- |
| **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 | Icone | Descrição |
| -------------------- | ------------------------- | ---------------------------------------------------- |
| **Download** | Icone de download (verde) | Baixar o arquivo do relatório concluido |
| **Tentar Novamente** | Icone de retry | Tentar novamente a geração de um relatório com falha |
| **Excluir** | Icone 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 sera 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 tendencias 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, decisoes 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** | Niveis de estoque, previsoes, dados de lotes | Planejamento de reposição, gestão de armazem |
| **Relatório de Lucros e Perdas** | P\&L abrangente combinando todas as fontes de dados | Revisão mensal/trimestral do negócio |
***
## 📤 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 (Diario, 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 sera 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 decisoes mais rapidas sobre inventário, preços e publicidade.
{% 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 apos 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 Praticas
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 sera lido por uma pessoa, XLSX oferece melhor formatação.
4. **Mantenha períodos gerenciaveis:** 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 | Diario, 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. Apos 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 varios marketplaces em um único arquivo?
Sim. Ao criar um relatório, você pode selecionar varios 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 apos baixar o arquivo.
Existe um limite de quantos relatórios posso gerar?
Não ha um limite rigido, 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 varios enderecos de e-mail?
Atualmente, relatórios agendados são entregues no e-mail principal da conta. Para entrega a varios 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 %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.sellermagnet.com/pt-or-guia-do-sellermagnet/dashboard-e-analises/dashboard-overview/reports.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.