Conectar a AliExpress: receber pedidos e enviar fulfillment

Copie a URL da pasarela, o App Key e o App Secret do console do seu App da AliExpress, obtenha a Session OAuth da sua conta de vendedor, cole no Integration, teste, mapeie e ative.

O conector da AliExpress traz pedidos da sua loja de vendedor da AliExpress para o OMS e devolve o fulfillment à AliExpress. Também pode enviar produtos e estoque, para que anúncios, estoque e envios fiquem sincronizados nos dois lados. Uma conexão é para uma loja de vendedor.

Pré-requisitos#

• Uma conta de vendedor da AliExpress com uma loja em que você possa vender e enviar.
• Um App no console de Apps da AliExpress, com acesso para abrir esse App e copiar seus valores.
• O titular da conta de vendedor pode concluir o fluxo de autorização OAuth da AliExpress para obter a Session (token de acesso).

Obter credenciais#

1. Abra o console do seu App da AliExpress → seu App, e copie a URL da pasarela TOP exibida ali, exatamente como aparece. Não digite uma pasarela de memória: o endereço não é fixo, copie exatamente como aparece no console.
2. No mesmo App, copie o App Key.
3. Na mesma página, copie o App Secret. Ele é usado para assinar as solicitações: guarde-o em local seguro.
4. Conclua o fluxo de autorização OAuth da AliExpress para sua conta de vendedor e obtenha a Session (token de acesso) dessa conta.

Preencher no Integration#

1. Abra Integration → Marketplace → AliExpress → Nova conexão.
2. URL da pasarela API, obrigatório: cole a URL da pasarela TOP que você copiou do console do seu App da AliExpress, exatamente como aparece ali (exemplo: https://…).
3. App Key, obrigatório: cole o App Key de Console do seu App da AliExpress → seu App.
4. App Secret, obrigatório: cole o App Secret da mesma página. Ele é usado para assinar as solicitações, nunca é registrado nem devolvido ao frontend.
5. Session (token de acesso), obrigatório: cole o session / access token de OAuth da sua conta de vendedor, obtido no fluxo de autorização OAuth da AliExpress.

Testar a conexão#

Clique em Testar a conexão. O teste verifica a URL da pasarela, assina uma solicitação com seu App Key e App Secret, e confirma que a Session é aceita para sua conta de vendedor. Se passar, os quatro valores pertencem juntos. Se falhar, anote o erro e veja a FAQ antes de mudar qualquer outra coisa.

Mapping / escolher modelo#

Escolha o modelo padrão da AliExpress. Mapeia número do pedido, SKUs de linha, quantidades, endereço de entrega e status de fulfillment. Revise a prévia com um pedido real antes de ativar, principalmente se cada SKU da AliExpress está vinculado a um produto do OMS, para que produtos e estoque coincidam nos dois lados.

Ativar#

Após ativar, o Integration traz pedidos novos na frequência definida, devolve o fulfillment com códigos de rastreio à AliExpress e envia mudanças de produtos e estoque. Acompanhe os primeiros pedidos em Runs / Logs antes de deixar sem supervisão.

Perguntas frequentes#

O teste falha: o App Key ou o App Secret está incorreto

Em palavras simples, a AliExpress não consegue verificar quem está chamando: o App Key e o App Secret que você colou não coincidem com o App do console — o mais comum é um deles copiado incompleto, com espaço extra, ou os dois valores trocados — e a solicitação assinada é rejeitada.

Volte a Console do seu App da AliExpress → seu App, copie o App Key em App Key e o App Secret em App Secret exatamente como aparecem nessa mesma página, confirme que a URL da pasarela também foi copiada exatamente do console, e teste novamente.

Autorização expirada: a Session não funciona mais

Em palavras simples, a Session é apenas o passe da última autorização OAuth, e esse passe expirou. O App Key e o App Secret podem continuar corretos: sem uma Session válida, a AliExpress não deixa a conexão agir pela sua conta de vendedor, e testes e extrações falham.

Autorize novamente: conclua mais uma vez o fluxo de autorização OAuth da AliExpress para sua conta de vendedor, obtenha uma Session (token de acesso) nova, cole o valor novo em Session (token de acesso) na conexão, salve e teste novamente.

Conectado mas nenhum pedido é importado

Em palavras simples, a conexão está bem: sua loja simplesmente não tem pedidos novos no intervalo de extração, então não há nada para importar. É diferente de uma falha de autenticação: o teste passa, só a lista de pedidos volta vazia.

Faça um pedido de teste na sua loja de vendedor da AliExpress, 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.