Shopee: autorizar, perder a autorização e refazer
O QUE ESTA FONTE RESPONDE
Como a loja passa a falar com a Shopee, por que o sistema expulsa o usuário para a tela de autorização, o que significa cada mensagem que aparece nessa volta e o que acontece quando a integração é removida. O desenho geral dos canais de venda, o de-para de situações e meios de pagamento e as travas de autorização comuns estão na pasta Marketplaces e e-commerce. O índice de Integrações, o vínculo por loja e o efeito de remover estão na fonte raiz de Integrações.
ONDE A AUTORIZAÇÃO ACONTECE
Dentro do aplicativo da Shopee existe uma tela de autorização: é nela que se conecta, se vê a situação atual e se desconecta. Outros caminhos do aplicativo que falam em autenticação levam para essa mesma tela.
No ERP a Shopee é tratada por loja. Com mais de uma loja cadastrada, a situação pode ser diferente em cada uma — trocou de loja, confira de novo.
POR QUE O SISTEMA JOGA DE VOLTA PARA ESSA TELA
Antes de abrir qualquer tela dentro do aplicativo Shopee, o sistema pergunta ao servidor se a loja está autorizada. Se a resposta vier com erro e ordem de redirecionamento, ele leva para a tela de autorização e mostra o aviso "Esta loja não está integrada com a Shopee.".
Essa checagem vale para tudo dentro do aplicativo, e não só para as telas do canal: telas do próprio ERP abertas por dentro do aplicativo Shopee (cadastro de produtos, lojas, usuários, ajuda) também são barradas. Escapam da checagem apenas a própria tela de autorização, o login e o acessar ERP, e as telas de planos.
Além dessa checagem geral, seis telas verificam a autorização por conta própria ao abrir: Início, Pedidos, Produtos, Clientes, Meios de pagamento e Situações. Quando o desvio parte delas, o cliente cai na tela de autorização sem nenhuma mensagem — parece que a tela "não abriu" ou que o sistema travou, quando na verdade o desvio foi proposital. Nenhuma dessas telas abre sem autorização válida; não é problema daquela tela específica, é a autorização.
Atenção: Produtos, Clientes e as demais telas com nome igual ao do ERP, dentro do aplicativo Shopee, mostram os dados do canal. Cadastro de produto, cliente, forma de pagamento e nota fiscal continuam sendo assunto do ERP e se respondem pelas fontes do ERP.
O QUE A TELA MOSTRA
Sem autorização, o sistema espera receber do servidor o link de autenticação da Shopee. Se ele vem, aparece o botão "Adicionar integração", que leva para a Shopee autorizar. Se ele não vem, o botão não aparece: no lugar surge um alerta vermelho com a mensagem que o próprio servidor mandou. Essa mensagem varia conforme o motivo, então leia o que está escrito na tela do cliente em vez de supor. Botão de adicionar que não aparece nunca é falha de clique nem de navegador: o servidor não liberou o link.
Com autorização ativa, o único botão da tela é "Remover integração". Ele abre uma confirmação com o título "Deseja remover a integração?" e os botões Cancelar e Confirmar. Só depois de confirmar o sistema desvincula.
Não existe na tela botão de renovar, reconectar ou campo para digitar token. Refazer a autorização é sempre pelo "Adicionar integração".
A VOLTA DA SHOPEE
Depois de autorizar na Shopee, o cliente volta para a tela de autorização do ERP trazendo um código de autorização. Para concluir, o sistema precisa desse código e mais um identificador da loja — ele aceita dois formatos de identificador, sendo um deles o usado por conta principal com subcontas.
Se faltar o código ou o identificador, a autorização não conclui, aparece "Não foi possível concluir a autorização com a Shopee. Tente novamente." e o cliente volta para a tela de autorização. Esse é o caso mais comum de "autorizei e voltou dizendo que não deu". Quando o retorno vem completo, o sistema confirma com a Shopee e mostra na tela a mensagem devolvida pelo servidor, de sucesso ou de erro.
Se o cliente tem conta principal e subcontas, registre no atendimento por qual conta ele autorizou e qual loja do ERP estava aberta. Autorizar pela conta errada é autorizar outra loja.
PERDER A AUTORIZAÇÃO SEM MEXER EM NADA
A autorização pode deixar de valer sem que ninguém tenha removido nada. É o clássico "parou do nada": ninguém desconectou, ninguém mudou senha, e mesmo assim o canal parou.
Acontece de o cliente olhar o painel da Shopee, achar que está tudo certo e não acreditar no aviso do ERP. Nesses casos, a referência de atendimento é o que o ERP mostra na tela de autorização: se ele oferece "Adicionar integração", não há autorização válida para essa loja. Não afirme prazo, validade ou motivo da perda — se o cliente insistir em saber por quê, ofereça verificar com o time responsável.
A solução prática é sempre a mesma: entrar na tela de autorização e refazer, clicando em "Adicionar integração".
O QUE REMOVER FAZ
Remover apaga a autorização. Não é reiniciar, não é limpar cache, não é reconectar sozinho. Depois de remover, a loja fica sem integração e as telas do canal voltam a barrar o acesso até autorizar de novo. Refazer é possível a qualquer momento, pela mesma tela.
O QUE COSTUMA DAR ERRADO
Integrei e não funciona: confira primeiro se a tela de autorização mostra o botão "Remover integração". Se mostra, existe autorização e o problema é outro. Se mostra "Adicionar integração", não existe autorização — a autorização não concluiu.
Toda hora volta para a tela de autorização: é a checagem automática agindo, com ou sem mensagem na tela. Não adianta insistir na tela de Pedidos ou Produtos; resolva a autorização.
Diz que a loja não está integrada mas na Shopee está ativo: pelo ERP não há autorização válida para essa loja. Refazer a autorização resolve; não discuta o que o painel da Shopee mostra.
Voltou dizendo que não foi possível concluir: o retorno da Shopee chegou incompleto. Refaça começando pela tela de autorização do ERP, sem colar endereço antigo na barra do navegador nem reaproveitar link de autorização já usado.
Não aparece o botão de adicionar integração: o servidor não devolveu o link e mostrou um alerta vermelho no lugar. Peça o print do alerta — a mensagem é o diagnóstico.
Autorizei na loja errada: a Shopee é tratada por loja. Verifique qual loja estava selecionada no ERP.
Pedido não entrou: primeiro confirme a autorização; sem ela nem a tela de Pedidos abre. Com autorização válida, a busca por período pode ser recusada pelo servidor, e a mensagem que aparece na tela vem dele — peça o print e não afirme limite de dias.
NUNCA peça, receba ou repita token, chave ou senha da Shopee. A autorização se refaz pelo botão da tela, nada é digitado manualmente. Se o cliente colar alguma credencial no atendimento, oriente a revogar e gerar outra no portal da Shopee.