Conectar a DHgate: receber pedidos e enviar fulfillment
Copie a URL do gateway API e o App Key no console de desenvolvedor da DHgate, obtenha o token de acesso pelo fluxo OAuth da DHgate, cole no Integration, teste, mapeie e ative.
O conector da DHgate traz pedidos da sua conta de vendedor da DHgate para o OMS e devolve fulfillment à DHgate. Também pode enviar produtos e estoque, para que pedidos, anúncios, estoque e envios fiquem sincronizados dos dois lados.
Pré-requisitos#
- Uma conta de vendedor da DHgate: o token de acesso é emitido para essa conta de vendedor.
- Acesso ao console de desenvolvedor da DHgate, onde são exibidos seu aplicativo, seu App Key e a URL do gateway API.
- Possibilidade de concluir o fluxo de autorização OAuth da DHgate para essa conta de vendedor: o token de acesso vem desse fluxo.
Obter credenciais#
- Copie a URL do gateway API: no console de desenvolvedor da DHgate, copie a URL do gateway API exatamente como exibida lá. Não digite de memória: ela não é fixa, e um caractere errado quebra todas as chamadas.
- Copie o App Key: no console de desenvolvedor da DHgate, abra seu aplicativo e copie o App Key.
- Obtenha o token de acesso: conclua o fluxo de autorização OAuth da DHgate para sua conta de vendedor e copie o token de acesso desse fluxo. Guarde-o em local seguro: você o colará no campo Access token do Integration.
- Anote os caminhos de endpoint que usará: os caminhos de pedidos, produtos, estoque, fulfillment e teste estão na documentação da DHgate Open Platform, relativos à URL do gateway. Você só precisa deles se alterar os campos avançados de endpoint na próxima etapa.
Preencher no Integration#
- Abra Integration → Marketplace → DHgate → Nova conexão.
- URL do gateway API (base_url), obrigatório: cole a URL do gateway que você copiou do console de desenvolvedor da DHgate, exatamente como exibida lá, por exemplo https://… . Não adicione um caminho de endpoint no final: os campos de endpoint abaixo são relativos a essa URL.
- App Key (app_key), obrigatório: cole o App Key do console de desenvolvedor da DHgate → seu aplicativo.
- Token de acesso (token), obrigatório: cole o token de acesso da sua conta de vendedor da DHgate obtido no fluxo de autorização OAuth. É guardado como segredo e nunca exibido após salvar.
- Ruta de pedidos (ep_orders), opcional, avançado: o caminho da API de “listar pedidos não enviados”, relativo à URL do gateway, por exemplo /order/list, conforme a documentação da DHgate Open Platform. Deixe como veio, salvo se a documentação do seu aplicativo disser o contrário: um caminho errado significa que nenhum pedido pode ser importado.
- Ruta de produtos (ep_products), opcional, avançado: o caminho da API de lista de produtos, relativo à URL do gateway, conforme a documentação da DHgate Open Platform. É usado ao enviar ou ler produtos.
- Ruta de estoque (ep_inventory), opcional, avançado: o caminho da API de atualização de estoque, relativo à URL do gateway, conforme a documentação da DHgate Open Platform. É usado ao enviar estoque à DHgate.
- Ruta de fulfillment (ep_fulfillment), opcional, avançado: o caminho da API de envio / rastreio, relativo à URL do gateway, conforme a documentação da DHgate Open Platform. É usado ao devolver fulfillment à DHgate.
- Ruta de teste (ep_me), opcional, avançado: o caminho de uma API leve de leitura usada para o teste de “testar a conexão”, relativo à URL do gateway, conforme a documentação da DHgate Open Platform. Se esse caminho estiver errado, o teste pode falhar mesmo com credenciais corretas.
Testar a conexão#
Clique em Testar a conexão. O teste usa o caminho de teste para verificar juntos a URL do gateway, o App Key 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 ainda não houver pedidos não enviados, faça primeiro um pedido de teste: 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 DHgate. 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 DHgate 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 não enviados na frequência definida, devolve fulfillment com números de rastreio à DHgate e envia mudanças de produtos e estoque à DHgate. Acompanhe os primeiros pedidos em Runs / Logs antes de deixar sem supervisão.
Perguntas frequentes#
O teste falha com erro de autenticação
O App Key ou o token de acesso está incorreto ou não é mais válido. O App Key pode ter sido copiado de outro aplicativo, ou o token de acesso do fluxo OAuth expirou, então a DHgate rejeita a chamada.
No console de desenvolvedor da DHgate, abra seu aplicativo e copie novamente o App Key. Depois conclua novamente o fluxo de autorização OAuth da DHgate, cole o novo token de acesso no campo Access token e teste novamente.
Conectado mas nenhum pedido é importado
A conexão está bem. A conta de vendedor simplesmente não tem pedidos novos não enviados no intervalo de extração, então ainda não há nada para importar.
Faça um pedido de teste que apareça como não enviado, 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.
O teste falha ou nenhum dado volta após alterar um caminho de endpoint
Um caminho avançado de endpoint não corresponde mais à documentação da DHgate Open Platform. A URL do gateway e as credenciais podem estar corretas, mas se o caminho de teste estiver errado o teste falha, e se o caminho de pedidos estiver errado nenhum pedido pode ser importado.
Restaure cada campo de endpoint alterado para o caminho da documentação da DHgate Open Platform para seu aplicativo (pedidos, produtos, estoque, fulfillment e teste são relativos à URL do gateway), salve e teste novamente. Altere apenas um caminho por vez para ver qual estava errado.
Pedidos entram, mas fulfillment, produtos ou estoque não voltam
Importar e devolver usam caminhos de endpoint distintos. Pedidos podem funcionar enquanto o caminho de fulfillment, produtos ou estoque está errado, então essa direção falha sozinha.
Verifique a direção que falha na conexão: compare os campos Ruta de fulfillment, Ruta de produtos e Ruta de estoque com a documentação da DHgate Open Platform, corrija o errado e verifique Runs / Logs no próximo envio.