Conectar a Wish: receber pedidos e enviar fulfillment
Obtenha um token de acesso OAuth2 de comerciante da Wish, cole-o junto com a URL base da API no Integration, teste, mapeie e ative.
O conector da Wish traz pedidos da sua loja Wish para o OMS e devolve fulfillment à Wish. Também pode enviar produtos e estoque, para que anúncios, estoque e envios fiquem sincronizados dos dois lados.
Pré-requisitos#
- Uma loja de comerciante da Wish, com acesso de login à conta de comerciante da Wish dessa loja.
- Possibilidade de concluir a autorização OAuth2 de comerciante da Wish para essa loja: o token de acesso é obtido por meio dessa autorização.
- Saiba qual URL base da API se aplica à sua loja antes de começar: o endereço padrão, o endereço da China ou o endereço sandbox para testes. Os endereços exatos estão na etapa Preencher no Integration.
Obter credenciais#
- Faça login na conta de comerciante da Wish da loja que você quer conectar e conclua a autorização OAuth2 para essa loja. Certifique-se de estar logado na loja certa antes de autorizar: um token autorizado para outra loja não corresponderá a esta conexão.
- Copie o token de acesso obtido após a autorização. É o token de acesso OAuth2 de comerciante da Wish: você o colará no campo Access token do Integration.
- Anote a data em que obteve o token: ele é válido por 30 dias. Quando expirar, conclua novamente a autorização OAuth2 para obter um novo token e atualize a conexão.
Preencher no Integration#
- Abra Integration → Marketplace → Wish → Nova conexão.
- URL base da API: preencha o endereço da sua loja. Padrão: https://merchant.wish.com/api/v2 . China: https://china-merchant.wish.com/api/v2 . Sandbox: https://sandbox.merchant.wish.com/api/v2 . Use o endereço sandbox apenas para testes e troque para o padrão ou o da China antes de entrar em produção.
- Token de acesso, obrigatório: cole o token de acesso OAuth2 de comerciante da Wish que você obteve na etapa anterior. É válido por 30 dias, é criptografado em repouso e nunca exibido.
Testar a conexão#
Clique em Testar a conexão. O teste verifica juntos a URL base da API e o token de acesso, e depois mostra uma prévia em nível de documento com um pedido real, com os campos da plataforma ao lado do pedido padrão. Se a loja ainda não tiver pedidos, faça primeiro um pedido de teste na Wish: a prévia precisa de um documento real. Se o teste falhar, anote o erro e veja a FAQ antes de mudar qualquer outra coisa.
Mapping / escolher modelo#
Escolha o modelo padrão da Wish. Mapeia número do pedido, SKU da linha, quantidades, endereço de entrega e status de fulfillment. Revise a prévia de mapping com um pedido real antes de ativar, principalmente se cada SKU da Wish está vinculado a um produto do OMS, para que pedidos, produtos e estoque coincidam dos dois lados.
Ativar#
Após ativar, o Integration traz pedidos novos na frequência definida, devolve fulfillment com números de rastreio à Wish e envia mudanças de produtos e estoque à Wish. Fique atento à data de expiração do token de acesso: ele é válido por 30 dias, então renove-o antes que expire para manter os pedidos chegando. Acompanhe os primeiros pedidos em Runs / Logs antes de deixar sem supervisão.
Perguntas frequentes#
O teste falha: o token de acesso está incorreto ou expirou
O token de acesso da conexão não funciona. Foi copiado incompleto ou com um espaço extra, pertence a uma autorização anterior, ou seus 30 dias já acabaram, então a Wish recusa a chamada.
Conclua novamente a autorização OAuth2 de comerciante da Wish para a mesma loja, copie o novo token de acesso exatamente como obtido, substitua o campo Access token sem espaços extras, verifique se a URL base da API corresponde à sua loja e teste novamente.
Você autorizou uma loja diferente
O token funciona, mas foi autorizado com login em outra loja Wish. A conexão, portanto, fala com essa outra loja, então os pedidos desta loja não aparecem — ou aparecem os da outra loja.
Faça login na conta de comerciante da Wish da loja à qual esta conexão corresponde, conclua novamente a autorização OAuth2, substitua o Access token pelo novo token dessa loja e teste novamente. Use uma conexão por loja: não compartilhe o mesmo token entre lojas.
Conectado mas nenhum pedido é importado
A conexão está bem. A loja simplesmente não tem pedidos novos no intervalo de extração, então ainda não há nada para importar.
Faça um pedido de teste na sua loja Wish, verifique se o horário está dentro do intervalo de extração, execute uma extração manual e confirme que o pedido aparece na prévia ou em Runs / Logs.