Como Funciona a Importação de Dados
Visão Geral
Assim que você conecta sua TikTok Shop, o Dashboardly começa a importar seus dados automaticamente. Esse processo traz seus produtos, pedidos, extratos financeiros, reembolsos e muito mais, para que seus painéis, relatórios de lucros e perdas e todas as demais páginas de análise sejam preenchidos com números precisos.
Você não precisa fazer nada manualmente -- as importações acontecem em segundo plano. Você pode continuar usando o Dashboardly enquanto a importação está em andamento; as páginas vão sendo preenchidas progressivamente, à medida que cada tipo de dado fica disponível.
O Que É Importado
O Dashboardly importa os seguintes tipos de dados da TikTok Shop:
| Tipo de Dado | Descrição |
|---|---|
| Produtos | Seu catálogo de produtos completo, incluindo SKUs, preços e imagens |
| Estoque de Produtos | Níveis de estoque em todos os armazéns (FBS e FBT) |
| Pedidos | Histórico completo de pedidos com dados do cliente e status do pedido |
| Itens de Linha do Pedido | Itens individuais dentro de cada pedido |
| Extratos Financeiros | Extratos de pagamento com detalhamento de receita |
| Transações de Extrato | Detalhes financeiros no nível do pedido (taxas, impostos, descontos) |
| Reembolsos e Devoluções | Todos os pedidos reembolsados e devolvidos, com valores e motivos |
| Dados de Armazém | Informações de armazém FBT e remessas de entrada |
Etapas da Importação
A importação é executada por meio de um pipeline com várias etapas. Você verá o progresso de cada etapa em tempo real:
- Catálogo de Produtos -- busca todos os seus produtos e SKUs
- Detalhes e Imagens de Produtos -- baixa informações estendidas dos produtos
- Estoque de Produtos -- sincroniza os níveis de estoque atuais por armazém
- Pedidos -- baixa seu histórico completo de pedidos
- Extratos Financeiros -- busca os dados de liquidação de pagamentos
- Transações de Extrato -- importa os detalhamentos financeiros no nível do pedido
- Reembolsos e Devoluções -- importa todos os registros de devolução e reembolso
- Armazéns e FBT -- sincroniza dados de armazém e fulfillment (se aplicável)
- Análises e Métricas -- calcula as métricas de negócio a partir de todos os dados importados
Produtos Sintéticos para Pedidos de Leilão
Se você vende por meio do Countdown Bidding (leilões) do TikTok, o Dashboardly cria automaticamente registros de produto para esses anúncios temporários. Os produtos são agrupados por nome -- se você vende o mesmo item em várias sessões de Countdown Bidding, ele aparece como um único produto em suas análises. Nenhuma ação é necessária da sua parte.
Quanto Tempo Leva a Primeira Importação?
O tempo de importação depende do tamanho da sua loja:
| Tamanho da Loja | Tempo Estimado |
|---|---|
| Pequena (menos de 100 pedidos) | 5 -- 15 minutos |
| Média (100 -- 10 mil pedidos) | 30 minutos -- 2 horas |
| Grande (10 mil -- 250 mil pedidos) | 2 -- 8 horas |
| Muito grande (mais de 250 mil pedidos) | mais de 8 horas |
Durante a importação, você verá uma janela de progresso com:
- Uma barra de progresso geral
- O status de cada etapa de importação (pendente, em andamento, concluída)
- Tempo estimado restante
- Itens processados x total
Você pode fechar a janela e continuar usando o Dashboardly -- a importação é executada em segundo plano.
Confiabilidade da Importação
O Dashboardly foi desenvolvido para lidar com importações de qualquer tamanho de forma confiável:
- Importações de longa duração. Para lojas grandes, as importações podem levar várias horas. O Dashboardly mantém sua sessão da API ativa durante todo o período para que as importações sejam concluídas sem erros de autorização. Se um token realmente expirar, reconecte a loja em Configurações → Lojas e a importação será retomada.
- Novas tentativas automáticas para dados de marketing. Se ocorrer um erro temporário de rede ao importar seus dados do TikTok Ads, a importação tenta novamente de forma automática. Você não precisa fazer nada.
Sincronização Automática de Dados (Após a Importação Inicial)
Após a importação inicial, o Dashboardly mantém seus dados atualizados automaticamente:
- A sincronização agendada é executada duas vezes por dia, às 02:00 e 14:00 UTC
- Cada sincronização agendada analisa os últimos 3 dias de dados para capturar quaisquer atualizações que o TikTok tenha emitido desde a execução anterior
- Os webhooks do TikTok fornecem atualizações em tempo real para novos pedidos, alterações de produtos e devoluções
Você não precisa fazer nada -- seus dados se mantêm atualizados automaticamente.
Observações Importantes
Atraso nos Extratos Financeiros
Os extratos financeiros do TikTok levam pelo menos 48 horas para ficarem disponíveis após um pedido ser feito. Se você vir pedidos sem dados financeiros, isso é normal -- os extratos aparecem na próxima sincronização depois que o TikTok os gera.
Completude dos Dados
Os detalhamentos de taxas e impostos dos seus pedidos são recuperados automaticamente quando os dados do TikTok chegam atrasados ou estavam inicialmente incompletos. Isso significa que seus cálculos de Profit & Loss ficam completos mais cedo, sem que você precise acionar uma sincronização manual.
Precisão dos Dados
O Dashboardly importa os dados exatamente como fornecidos pela API do TikTok. Se você notar discrepâncias, consulte Meus Números Não Batem com o TikTok e Entendendo a Qualidade dos Seus Dados.
Acionando uma Importação Manual
Se você precisar atualizar seus dados imediatamente:
- Acesse Configurações → Histórico de Importação
- Clique em Executar Importação
- A importação processa todos os tipos de dados e mostra o progresso
Isso usa o mesmo pipeline da sincronização automática. Não exclui os dados existentes -- ela atualiza e adiciona a eles.
Dicas
- Não desconecte e reconecte sua loja para "corrigir" problemas de dados. Uma sincronização manual é a abordagem correta.
- Verifique Configurações → Histórico de Importação se seus números parecerem desatualizados. Você pode ver o status da última sincronização e acionar uma sincronização manual, se necessário.
- Lojas grandes podem ver dados parciais no Dashboard enquanto a importação ainda está em andamento. Aguarde a conclusão da importação antes de avaliar seus números.
Problemas Comuns
Importação travada em uma etapa
Ocasionalmente, uma importação pode travar devido a limites temporários de taxa da API do TikTok. O Dashboardly tenta novamente de forma automática, com atrasos crescentes. Se uma importação não mostrar progresso por mais de ~2 horas, entre em contato com o suporte.
A importação foi concluída, mas os dados parecem incompletos
Verifique se o TikTok Seller Center mostra dados para o mesmo intervalo de datas. Algumas métricas (como os extratos financeiros) só ficam disponíveis depois que o TikTok as finaliza, o que leva pelo menos 48 horas, mas pode ser mais para alguns pedidos.
Erro "Falha na importação"
Isso normalmente significa que a API do TikTok retornou um erro. Causas comuns:
- Seu token de autorização expirou (reconecte a loja em Configurações → Lojas)
- Os servidores do TikTok estavam temporariamente indisponíveis (a importação tentará novamente de forma automática)
- Sua loja foi suspensa ou restrita do lado do TikTok
Se o problema persistir após a reconexão, entre em contato com o suporte.