Dashboard Shopee SH00¶
Visão geral da integração com a Shopee: status do serviço, lojas conectadas, totais de pedidos e produtos sincronizados, e atalhos para forçar sincronização manual.
Pré-requisitos¶
- Estar logado no sistema (veja Acessando o sistema)
shopee-servicerodando (status visível no primeiro cartão)- Para acessar dados reais: pelo menos uma loja Shopee conectada
Passo a passo¶
1. Acessar a tela¶
No menu lateral, clique em Shopee → Dashboard (ou diretamente em Shopee).
2. Conferir o status do serviço¶
O cartão Status do Serviço mostra:
- Online (verde) —
shopee-servicerodando, integração ativa - Offline (vermelho) — serviço parado, ações ficam indisponíveis
Quando offline, um aviso na parte inferior indica como reativar o serviço em Configurações → Serviços.
3. Cartões de KPIs¶
| Cartão | O que mede |
|---|---|
| Total Pedidos | Pedidos já sincronizados da Shopee |
| Total Produtos | Produtos cadastrados na loja Shopee e sincronizados |
4. Painel de Sincronização¶
Mostra a última sincronização de pedidos e produtos com data/hora. Dois botões disponíveis:
| Botão | Função |
|---|---|
| Sync Pedidos (laranja) | Força sincronização de pedidos agora |
| Sync Produtos (contorno) | Força sincronização do catálogo de produtos agora |
Após clicar, o botão mostra um spinner e a tela recarrega com mensagem de sucesso ou erro.
5. Conectar uma loja nova¶
No cartão Lojas Conectadas, clique em Conectar Loja (laranja). Você é redirecionado para o login da Shopee — entre com a conta do Seller Center e autorize o Sistemax a acessar pedidos, produtos e devoluções.
Ao voltar, a loja aparece com:
- Nome da loja
- Shop ID
- Status: Conectado (verde) ou Token expirado (vermelho)
- Data de expiração do token
6. Desconectar uma loja¶
Clique em Desconectar ao lado da loja. Confirme. A loja é removida e a sincronização para até reconexão.
Renovação automática do token¶
A Shopee usa tokens com validade de poucas horas, renovados automaticamente pelo shopee-service. Se o status aparecer como Token expirado:
- Verifique se o
shopee-serviceestá rodando - Se sim, desconecte e reconecte manualmente — força um novo OAuth
Erros comuns¶
Serviço Offline
O shopee-service está parado. Vá em Configurações → Serviços e inicie-o.
Token expirado
O refresh automático falhou. Desconecte e reconecte a loja.
Sincronização não traz nada
Confira o painel de Sincronização: se mostra "Nunca sincronizado", clique em Sync Pedidos e Sync Produtos. A primeira sincronização pode demorar dependendo do volume.