For the complete documentation index, see llms.txt. This page is also available as Markdown.

Relatórios

Gere, agende e baixe relatórios personalizados para o seu negócio na Amazon. Escolha entre vários tipos de relatórios, filtre por marketplace e período, e configure relatórios recorrentes automatizado

Dificuldade: 🟢 Iniciante · Tempo de leitura: ~15 min

rocket

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 módulo de Relatórios cuida de tudo com tipos de relatórios flexíveis, agendamento e opções de entrega.

Os relatórios extraem dados de todos os outros módulos 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.


🎥 Vídeo Explicativo

Tutorial em vídeo em breve. Um guia completo desta funcionalidade estará disponível aqui em breve.


🗂️ Estrutura da Página

Seção
Finalidade

Resumo de Estatísticas

Quatro cartões de estatísticas mostrando contagens de relatórios totais, concluídos, pendentes e com falha

Barra de Ações Rápidas

Botões para gerar, agendar e atualizar relatórios

Abas de Filtro por Status

Filtre a tabela de relatórios por status (Todos, Concluídos, 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 Estatísticas

Quatro cartões de estatísticas no topo fornecem um resumo rápido da sua atividade de relatórios:

Cartão de Estatística
Descrição
Indicador de Cor

Total Reports

Número total de relatórios já gerados

Azul

Completed

Relatórios finalizados com sucesso e prontos para download

Verde

Pending

Relatórios sendo gerados ou na fila

Amarelo/Âmbar

Failed

Relatórios que encontraram um erro durante a geração

Vermelho

Cada cartão é clicável, clicar em um cartão de estatística filtra a tabela para mostrar apenas relatórios com aquele status.

Relatórios pendentes normalmente são concluídos em 1-5 minutos dependendo do volume de dados e do período. Relatórios muito grandes (12+ meses em vários marketplaces) podem levar até 15 minutos.


Barra de Ações Rápidas

A barra de ações fornece os controles principais:

Botão
Ação
Descrição

Generate Report (azul, principal)

Abre o modal de geração de relatório

Crie um novo relatório pontual

Schedule Report

Abre o modal de agendamento

Configure um relatório recorrente automatizado

Refresh

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

All

Todos os relatórios independente do status

Contagem total

Completed

Apenas relatórios gerados com sucesso

Contagem de concluídos

Pending

Relatórios em processamento

Contagem de pendentes

Failed

Relatórios que encontraram erros

Contagem de falhas


📤 Tabela de Relatórios

Relatórios SellerMagnet

A tabela principal exibe todos os seus relatórios gerados.

Colunas da Tabela

Coluna
Descrição

Report Type

Tipo do relatório (ex.: Orders, Product COGS, General Fees, Listing Performance)

Connection

Conta/conexão do Amazon Seller a partir da qual o relatório foi gerado

Marketplaces

Qual(is) marketplace(s) o relatório abrange

Time Range

Intervalo de datas coberto pelo relatório

Requested At

Data e hora em que o relatório foi solicitado

Format

Formato do arquivo (CSV, XLSX, JSON)

Records

Número de linhas de dados no relatório

Status

Status atual: Initial, Pending, Processing, Completed, Failed

Action

Botões de download ou nova tentativa

Badges de Status

Status
Aparência
Significado

Initial

Amarelo/âmbar (contado em Pending)

O relatório acabou de ser enviado e está aguardando o worker pegá-lo

Completed

Badge verde com marca de verificação

Relatório pronto para download

Pending

Badge amarelo/âmbar com relógio

Relatório na fila ou em processamento

Processing

Badge azul com spinner

Relatório sendo gerado ativamente

Failed

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 concluído

Retry

Ícone de retry

Tentar novamente a geração de um relatório com falha

Delete

Ícone de lixeira

Remover o registro do relatório


📤 Passo a Passo: Gerando um Relatório Pontual

  1. Clique no botão "Generate Report" na Barra de Ações Rápidas.

  2. O modal de geração de relatório é aberto.

  3. Escolha um modo de Delivery com o controle segmentado no topo do modal. Isto decide como o relatório é produzido e qual lista de tipos de relatório o menu suspenso mostra:

Modo de entrega
O que faz
Opções de formato

Instant export

Baixa imediatamente a partir de dados que o SellerMagnet já possui. Sem fila, sem espera.

CSV, Excel

Amazon report

Solicitado da Amazon e construído por um worker em segundo plano. Ele aparece na lista de relatórios abaixo e você o baixa quando estiver Completed.

CSV, Excel, JSON

  1. Preencha os parâmetros do relatório:

Campo
Descrição
Exemplo

Report Type

Selecione o tipo de dados desejado (a lista depende do modo de Delivery)

Orders

Report Options

Para alguns tipos de Amazon report, marque as caixas opcionais para incluir dados extras

(varia por tipo)

Connection

Escolha de qual conta Amazon extrair

My Amazon EU Account

Marketplace(s)

Selecione um ou mais marketplaces, ou deixe em "All Marketplaces"

Amazon.de, Amazon.fr

Start Date

Início do período do relatório

2026-01-01

End Date

Fim do período do relatório

2026-03-31

Format

Escolha o formato do arquivo de saída

CSV

Predefinições rápidas de data: Em vez de escolher datas manualmente, use os botões acima dos campos de data, Last 7 Days, Last 30 Days, Last 90 Days, This Month e This Year, para preencher a Start Date e a End Date em um clique.

  1. Clique em "Generate Report" para enviar.

  2. Para um Instant export, o arquivo é baixado imediatamente no seu navegador e o modal fecha. Para um Amazon report, o relatório aparece na tabela com status "Pending".

  3. Para Amazon reports, aguarde o status mudar para "Completed" (normalmente 1-5 minutos), depois clique no botão Download para salvar o arquivo.

rocket

⚡ Delivery: Instant Export vs. Amazon Report

O menu suspenso de tipo de relatório não mistura todos os tipos em uma longa lista. Um controle segmentado de Delivery no topo do modal Generate alterna o menu suspenso entre dois tipos de relatório:

Modo de entrega
Ícone
Comportamento

Instant export

Raio

Gerado de forma síncrona a partir dos dados que o SellerMagnet já armazena. O arquivo é baixado imediatamente, não há linha "Pending" para aguardar. Apenas CSV ou Excel.

Amazon report

Logo da Amazon

Solicitado da Amazon e construído por um worker em segundo plano. Ele é enfileirado e aparece na lista de relatórios com um status que você atualiza até "Completed". CSV, Excel ou JSON.

Antes havia um único menu suspenso onde as instant exports eram sinalizadas apenas com um emoji de raio. Isso acabou, o controle Delivery agora torna a escolha explícita e mantém cada lista curta.

Fontes de instant export

Selecionar Instant export alterna o menu suspenso para estas fontes baseadas em registry (CSV/XLSX):

Orders, Refunded Orders, Products & COGS, Expenses, Listing Performance, Transactions / Payouts, Review Requests Sent, Financial Summary, Sourcer Lookup History, PPC Campaigns e PPC Keywords.

Snapshots (sem período)

Algumas fontes de instant export 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 Start Date e End Date desaparecem.

Fonte de snapshot
O que captura

Products & COGS

Estado atual do catálogo e dos custos

Expenses

Ledger completo de despesas

Sourcer Lookup History

Tudo o que você consultou

PPC Campaigns

Lista atual de campanhas

PPC Keywords

Lista atual de palavras-chave

As demais fontes de instant export (Orders, Refunded Orders, Transactions / Payouts, Listing Performance, Review Requests Sent, Financial Summary) ainda exigem uma Start e uma End date.

Pré-visualize antes de gerar

Apenas para fontes de Instant export, um botão Preview 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.

rocket

📤 Tipos de Relatório Disponíveis (Amazon Reports)

A lista de Amazon report é orientada pelos seus dados e pode mudar ao longo do tempo, então trate o seguinte como indicativo em vez de um menu fixo. Tipos típicos incluem:

Tipo de Relatório
Dados Incluídos
Melhor Para

Orders

Registros de pedidos com produtos e financeiros

Contabilidade, reconciliação de receita

Sales Summary

Números de vendas agregados do período

Instantâneos rápidos de desempenho

Inventory / Inventory Snapshot / Inventory Report / Inventory Forecast

Níveis de estoque, instantâneos do estado atual e estimativas de demanda futura

Planejamento de reposição, gestão de armazém

FBA Returns

Devoluções para pedidos FBA (Fulfilled by Amazon)

Análise de taxa de devolução e qualidade

FBM Returns

Devoluções para pedidos FBM (Fulfilled by Merchant)

Análise de taxa de devolução e qualidade

Expenses

Despesas empresariais rastreadas manualmente

Deduções fiscais, revisão de orçamento

Product COGS

Catálogo de produtos com custo dos produtos por unidade

Revisão de margem e lucratividade

General Fees

Taxas e ajustes da Amazon

Análise de taxas, otimização de custos

Listing Performance

Sessões, visualizações de página, conversão, % Buy Box

Análise de marketing, otimização de listagens

Repricing Log

Histórico de mudanças de preço automatizadas

Auditoria do Repricer

Review Request Log

Solicitações de avaliação que foram enviadas

Rastreamento de outreach de avaliações

Reimbursement Claims

Registros de reclamações de reembolso Lost & Found

Rastreamento de recuperação

Alerts History

Eventos de alerta passados

Revisão operacional

Seller Performance

Métricas de saúde e desempenho da conta

Monitoramento de conformidade

Alguns tipos de Amazon report, como Inventory Snapshot, Inventory Forecast e Seller Performance, são instantâneos do estado atual e ocultam o período quando selecionados. Outros expõem caixas de Report Options extras abaixo do menu suspenso de tipo, marque-as para incluir dados adicionais no arquivo.


📤 Relatórios Agendados

A seção de Relatórios Agendados permite automatizar a geração recorrente de relatórios.

O agendamento cobre os tipos Amazon report (enfileirados). As instant exports rodam sob demanda, então não são agendadas.

Colunas da Tabela de Relatórios Agendados

Coluna
Descrição

Report Type

Tipo de relatório sendo gerado

Frequency

Com que frequência o relatório é executado (Daily, Weekly, Every 2 Weeks, Monthly), com o dia escolhido mostrado entre colchetes

Delivery

Como o relatório é entregue (Email, Webhook ou Email + Webhook)

Format

Formato do arquivo (CSV, XLSX, JSON)

Next Run

Data e hora da próxima geração agendada

Last Run

Data e hora da geração mais recente

Status

Active ou Paused

Action

Alternar pausar/retomar, ou excluir o agendamento

Passo a Passo: Criando um Relatório Agendado

  1. Clique no botão "Schedule Report" na Barra de Ações Rápidas.

  2. O modal de agendamento é aberto.

  3. Configure o agendamento:

Campo
Descrição
Exemplo

Connection

Conta Amazon

My Amazon EU Account

Report Type

Tipo de relatório

Orders

Marketplace(s)

Marketplaces alvo, ou "All Marketplaces"

All Marketplaces

Frequency

Com que frequência gerar: Daily, Weekly, Every 2 Weeks ou Monthly

Weekly

Day of Week

Mostrado para Weekly e Every 2 Weeks, em qual dia o relatório é executado

Monday

Day of Month

Mostrado para Monthly, um dia de 1 a 28

1

Send via

Método de entrega: Email, Webhook ou Email + Webhook

Email + Webhook

Webhook URL

Mostrado quando Webhook ou Email + Webhook é selecionado, a URL que recebe o relatório finalizado

https://your-server.com/webhook

Format

Formato de saída: CSV, Excel ou JSON

CSV

  1. Clique em "Create Schedule" para ativar.

  2. O agendamento aparece na tabela de Relatórios Agendados com status "Active".

O seletor de Day of Month para em 28 de propósito, para que um agendamento mensal sempre tenha um dia válido em todos os meses, incluindo fevereiro.

Gerenciando Relatórios Agendados

Ação
Como Fazer

Pausar um agendamento

Desligue o interruptor na linha do agendamento

Retomar um agendamento

Ligue o interruptor novamente

Excluir um agendamento

Clique no ícone de lixeira para remover permanentemente o agendamento


📤 Cenário Real: Fluxo de Relatórios Mensais

Situação: Você gerencia um negócio na Amazon e precisa fornecer dados financeiros mensais ao seu contador.

Relatório
Agendamento
Finalidade

Orders

Mensal, dia 1 de cada mês, dados do mês anterior

Registros completos de pedidos para reconciliação de receita

General Fees

Mensal, dia 1 de cada mês, dados do mês anterior

Detalhamento de taxas da Amazon para categorização de despesas

Expenses

Mensal, dia 1 de cada mês, dados do mês anterior

Despesas empresariais manuais para rastreamento de deduções

Configure esses três agendamentos uma vez, e seu contador recebe dados limpos todo mês sem nenhum esforço manual.

rocket

📊 Lendo Seus Resultados

A coluna Records 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. Um relatório Completed mostrando 0 registros significa que a consulta rodou bem mas seu marketplace e período não tinham dados - reveja os filtros em vez de tentar novamente.


📤 Formatos de Arquivo de Relatórios

Formato
Melhor Para
Vantagens
Limitações

CSV

Importação em software contábil, 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

JSON

Alimentar dados em scripts ou integrações

Legível por máquina, preserva estrutura aninhada

Não é destinado a planilhas; apenas Amazon reports

JSON está disponível apenas para tipos de Amazon (enfileirados) report. As instant exports produzem CSV ou Excel, se você escolher JSON para uma instant export, o SellerMagnet mostra um erro informando que o tipo suporta apenas CSV e 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

Conexão expirada

Erro de autenticação

Re-autentique sua conexão Amazon em Settings

Erro de processamento do servidor

Falha inesperada

Clique em Retry; se persistir, entre em contato com o suporte


⚠️ Erros Comuns a Evitar
Erro
Impacto
Abordagem Melhor

Gerar relatórios duplicados

Desperdiça 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 concluídos

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 às expectativas

Verifique a seleção de marketplace antes de gerar

## ✅ Melhores Práticas

  1. Automatize relatórios mensais: Configure agendamentos para seus relatórios principais (Orders, General Fees, Expenses) no dia 1 de cada mês.

  2. Use CSV para processamento de dados: Se você planeja importar dados em software contábil, 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 aceitáveis. Relatórios anuais devem ser divididos por trimestre.

  5. Monitore a fila de Pending: Se você ver relatórios presos em Pending 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 desnecessários 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 à data de execução (ex.: "previous 7 days")

Entrega

Instant exports baixam imediatamente; Amazon reports aparecem na lista para baixar

Email, Webhook ou Email + Webhook

Frequência

Única vez

Diário, semanal, a cada 2 semanas ou mensal

Caso de uso

Análise ad hoc, investigações específicas

Relatórios recorrentes, atualizações para partes interessadas

Gerenciamento

Excluir quando não for mais necessário

Pausar, retomar ou excluir o agendamento


❓ FAQ

Por quanto tempo os relatórios concluídos ficam disponíveis para download?

Relatórios concluídos 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 conterá 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 "Requested At" mostra o horário no seu fuso horário local. Os filtros de intervalo de datas (Start Date/End Date) 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 há 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 conclusão antes de iniciar o próximo.

Relatórios agendados podem ser enviados para vários endereços de e-mail?

Atualmente, relatórios agendados são entregues no e-mail principal da conta. Para entrega a vários destinatários, 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 "Failed". Você receberá uma notificação sobre a falha. A próxima execução agendada tentará a geração do zero.


➡️ O que vem a seguir?

Visão Geral do DashboardDespesas

Last updated