Configuração Shopee SH04¶
Tela central para gerenciar a conexão, lojas e sincronização da integração com a Shopee. Reúne em um lugar só o status do serviço, a lista de lojas conectadas, contadores de sincronização e instruções para configurar a integração.
Pré-requisitos¶
- Estar logado como Master (gestão de chaves API exige esse nível)
shopee-servicerodando- Credenciais Partner ID e Partner Key obtidas no Shopee Partner Dashboard
Passo a passo¶
1. Acessar a tela¶
No menu lateral, clique em Shopee → Configuração (ou no atalho da página principal Shopee).
2. Conferir o status do serviço¶
O primeiro bloco mostra se o shopee-service está Online ou Offline, com a URL local que o painel consulta. Quando offline, um aviso indica como reativar em Configurações → Serviços.
3. Lojas conectadas¶
Lista todas as lojas vinculadas, com:
| Campo | Conteúdo |
|---|---|
| Nome da loja | Shop name retornado pela API |
| Shop ID | Identificador único da loja |
| Status do token | Ativo / Expirado |
| Expira em | Data/hora da expiração do token atual |
Conectar loja nova¶
Clique em Conectar Loja (laranja). Você é redirecionado para o OAuth da Shopee — entre com o login do Seller Center, autorize o Sistemax e volte automaticamente.
Desconectar loja¶
Clique em Desconectar ao lado da loja. Confirme. O token é removido — a sincronização para até a próxima reconexão.
4. Painel de sincronização¶
Dois cartões mostram os contadores em destaque (laranja):
- Pedidos — total sincronizado + última data/hora de sync
- Produtos — idem para o catálogo
Abaixo, dois botões manuais:
| Botão | Função |
|---|---|
| Sync Pedidos | Força sincronização imediata de pedidos |
| Sync Produtos | Força sincronização imediata do catálogo |
Após clicar, o botão mostra um spinner e a página recarrega com mensagem de sucesso ou erro.
5. Configurar Partner ID e Partner Key¶
Antes do primeiro Conectar Loja, é necessário cadastrar as credenciais de integração:
| Credencial | Onde fica |
|---|---|
| Partner ID | Cadastrado pelo administrador do sistema na tabela de configuração interna |
| Partner Key | Cadastrado pelo administrador, criptografado |
Essas credenciais vêm do Shopee Partner Dashboard quando você cria sua aplicação na Open Platform. Cada cliente do Sistemax precisa cadastrar as próprias chaves — não há credencial compartilhada.
Onde cadastrar Partner ID / Partner Key
O cadastro acontece em Configurações (tela geral) usando as chaves shopee_partner_id e shopee_partner_key. Os valores ficam criptografados no banco — só o shopee-service consegue decifrá-los em runtime.
6. URL de Redirect¶
No Shopee Partner Dashboard, configure a URL de callback apontando para o endpoint público deste Sistemax. Sem isso, o OAuth volta para o lugar errado e a conexão falha.
Renovação automática¶
Os tokens de acesso da Shopee têm validade curta (poucas horas). O shopee-service renova automaticamente em segundo plano usando o refresh token. Se mesmo assim aparecer Token expirado:
- Confira se o serviço está online
- Verifique se Partner Key continua válido (caso tenha mudado no Shopee Partner Dashboard)
- Desconecte e reconecte a loja manualmente
Erros comuns¶
Conectar Loja redireciona para erro
Partner ID / Partner Key não cadastrados, ou URL de Redirect divergente do que está no Shopee Partner Dashboard. Confira ambos.
Token expirado mesmo com serviço online
O refresh falhou — provavelmente Partner Key foi alterado ou a loja revogou o consentimento. Reconecte.
Sync manual retorna erro
Lojas sem token válido não conseguem sincronizar. Reconecte primeiro, depois clique em sync.