Shopee: visão geral do aplicativo e por onde começar
O QUE ESTA FONTE RESPONDE
Sim, existe integração com a Shopee, e ela é um aplicativo à parte, aberto pela lista de Meus aplicativos. Esta fonte é a visão geral: o que o aplicativo faz, em que ordem as coisas precisam ser feitas e qual das outras fontes da Shopee responde cada assunto em detalhe. Se a pergunta for específica, vá direto para a fonte indicada aqui — esta não repete o detalhe delas.
A Shopee é um dos cinco canais de venda por plataforma externa do sistema, e os cinco seguem praticamente o mesmo desenho. Esse desenho comum — de-para de situações e de meios de pagamento, quem é dono do pedido, do preço e do estoque, e as travas de autorização — está na pasta Marketplaces e e-commerce. O índice das integrações, o vínculo por loja, o efeito de remover e o conceito de Gerar venda estão na fonte raiz de Integrações.
ONDE O APLICATIVO ABRE
O aplicativo abre dentro do próprio ERP. A tela inicial tem sete atalhos, e essa lista é fechada: Clientes, Produtos, Pedidos, Meios pagamentos, Situações, Autorização e Usuários.
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.
A ORDEM QUE FAZ A INTEGRAÇÃO FUNCIONAR
Primeiro autorizar. Depois vincular os meios de pagamento e as situações de pedido. Depois associar os produtos. Só então buscar pedidos e gerar a venda.
Cada passo depende do anterior, e é isso que explica a ordem. Sem autorização válida nenhuma tela do aplicativo abre: o sistema desvia para a tela de autorização, às vezes sem mensagem nenhuma. Sem o vínculo de de-para, o sistema não tem para onde converter o meio de pagamento e a situação que vêm do canal. Sem a associação por SKU, o item da Shopee não está ligado a nenhum produto do sistema.
QUAL FONTE RESPONDE O QUÊ
Autorizar, ser jogado de volta para a tela de autorização, as mensagens da volta da Shopee e o que remover faz: fonte de autorizar, perder a autorização e refazer.
Buscar pedidos, os filtros, a recusa do período, as colunas, os dois status, o Sincronizar em lote e o Gerar venda: fonte de buscar pedidos, o limite de período e gerar a venda.
SKU, associar o item da Shopee ao produto do sistema e sincronizar estoque e preço: fonte de produtos da Shopee.
As duas telas de de-para, Meios de pagamentos e Situações de pedidos: fonte de vincular meios de pagamento e situações de pedido.
O que dentro do aplicativo é do canal e o que é tela do ERP aberta ali dentro: fonte de dentro do app Shopee.
O QUE NÃO É DA INTEGRAÇÃO
Cadastro de cliente, cadastro de produto, forma de pagamento, conta bancária, lançamento financeiro, venda e nota fiscal são do ERP. O aplicativo aponta para eles, não os substitui. Editar um produto por dentro do aplicativo é editar o produto do ERP, com efeito em vendas, estoque e nota fiscal.
O PEDIDO NÃO VIRA VENDA SOZINHO
Ele fica na tela de Pedidos do aplicativo e só vira venda por ação sua: Gerar venda na linha, ou Sincronizar em lote. O Gerar venda abre o formulário de venda do próprio ERP, e a venda só passa a existir depois que esse formulário é salvo. O detalhe está na fonte de pedidos.
O QUE COSTUMA DAR ERRADO
Parou do nada, sem ninguém mexer. A autorização pode deixar de valer sem que ninguém tenha removido nada. 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. E não discuta o que o painel da Shopee mostra: o painel continuar exibindo o aplicativo não prova que a autorização do lado do ERP está de pé.
Refazer não é remover. Remover apaga a autorização e obriga a autorizar de novo pela mesma tela. Nunca ofereça remover como forma de reiniciar a integração.
Busquei um período grande e não veio nada. Quem recusa o período é o servidor, e a mensagem aparece na tela junto com a listagem zerada. Leia a mensagem, porque é ela que diz qual é o teto, e quebre a busca em partes menores. Não prometa um número de dias.
Não consigo associar o produto. Item que veio sem SKU não pode ser associado enquanto estiver assim.
O pedido entrou com pagamento ou situação errada. Ou o vínculo de de-para não existe para aquela referência, ou ele aponta para o registro errado.
A venda não está no aplicativo. Ela não mora ali: a venda vive no ERP, nas vendas normais, e o aplicativo só aponta para ela.
NUNCA peça, receba ou repita token, chave ou senha da Shopee. A autorização se refaz por botão na tela, nada é digitado manualmente. Se o cliente colar alguma credencial no atendimento, oriente a revogar e gerar outra no portal da Shopee.