Conectar DHgate: recibir pedidos y enviar fulfillment

Copie la URL de la pasarela API y el App Key desde la consola de desarrollador de DHgate, obtenga el token de acceso mediante el flujo OAuth de DHgate, péguelos en Integration, pruebe, mapee y active.

El conector de DHgate trae pedidos de su cuenta de vendedor de DHgate a OMS y devuelve fulfillment a DHgate. También puede enviar productos e inventario, para que pedidos, anuncios, stock y envíos se mantengan sincronizados en ambos lados.

Requisitos previos#

• Una cuenta de vendedor de DHgate: el token de acceso se emite para esa cuenta de vendedor.
• Acceso a la consola de desarrollador de DHgate, donde se muestran su aplicación, su App Key y la URL de la pasarela API.
• Posibilidad de completar el flujo de autorización OAuth de DHgate para esa cuenta de vendedor: el token de acceso viene de ese flujo.

Obtener credenciales#

1. Copie la URL de la pasarela API: en la consola de desarrollador de DHgate, copie la URL de la pasarela API tal cual se muestra allí. No la escriba de memoria: no está codificada, y un carácter erróneo rompe todas las llamadas.
2. Copie el App Key: en la consola de desarrollador de DHgate, abra su aplicación y copie el App Key.
3. Obtenga el token de acceso: complete el flujo de autorización OAuth de DHgate para su cuenta de vendedor y copie el token de acceso de ese flujo. Guárdelo en un lugar seguro: lo pegará en el campo Access token de Integration.
4. Anote las rutas de endpoints que usará: las rutas de pedidos, productos, inventario, fulfillment y prueba están en la documentación de DHgate Open Platform, relativas a la URL de la pasarela. Solo las necesita si cambia los campos avanzados de endpoint en el siguiente paso.

Completar en Integration#

1. Abra Integration → Marketplace → DHgate → Nueva conexión.
2. URL de la pasarela API (base_url), obligatorio: pegue la URL de la pasarela que copió de la consola de desarrollador de DHgate, tal cual se muestra allí, por ejemplo https://… . No añada una ruta de endpoint al final: los campos de endpoint siguientes son relativos a esta URL.
3. App Key (app_key), obligatorio: pegue el App Key de la consola de desarrollador de DHgate → su aplicación.
4. Token de acceso (token), obligatorio: pegue el token de acceso de su cuenta de vendedor de DHgate obtenido en el flujo de autorización OAuth. Se guarda como secreto y nunca se vuelve a mostrar tras guardar.
5. Ruta de pedidos (ep_orders), opcional, avanzado: la ruta de la API de “listar pedidos no enviados”, relativa a la URL de la pasarela, por ejemplo /order/list, según la documentación de DHgate Open Platform. Déjela como viene salvo que la documentación de su aplicación diga lo contrario: una ruta errónea significa que no se puede traer ningún pedido.
6. Ruta de productos (ep_products), opcional, avanzado: la ruta de la API de lista de productos, relativa a la URL de la pasarela, según la documentación de DHgate Open Platform. Se usa al enviar o leer productos.
7. Ruta de inventario (ep_inventory), opcional, avanzado: la ruta de la API de actualización de inventario, relativa a la URL de la pasarela, según la documentación de DHgate Open Platform. Se usa al enviar inventario a DHgate.
8. Ruta de fulfillment (ep_fulfillment), opcional, avanzado: la ruta de la API de envío / tracking, relativa a la URL de la pasarela, según la documentación de DHgate Open Platform. Se usa al devolver fulfillment a DHgate.
9. Ruta de prueba (ep_me), opcional, avanzado: la ruta de una API ligera de lectura usada para la prueba de “probar la conexión”, relativa a la URL de la pasarela, según la documentación de DHgate Open Platform. Si esta ruta es errónea, la prueba puede fallar aunque sus credenciales sean correctas.

Probar la conexión#

Haga clic en Probar la conexión. La prueba usa la ruta de prueba para verificar juntos la URL de la pasarela, el App Key y el token de acceso, y luego muestra una vista previa a nivel de documento con un pedido real, con los campos de la plataforma junto al pedido estándar. Si aún no hay pedidos no enviados, haga primero un pedido de prueba: la vista previa necesita un documento real. Si la prueba falla, anote el error y revise la FAQ antes de cambiar otra cosa.

Mapping / elegir plantilla#

Elija la plantilla estándar de DHgate. Mapea número de pedido, SKU de línea, cantidades, dirección de envío y estado de fulfillment. Revise la vista previa de mapping con un pedido real antes de activar, sobre todo que cada SKU de DHgate esté vinculado a un producto de OMS, para que pedidos, productos e inventario coincidan en ambos lados.

Activar#

Tras activar, Integration trae pedidos nuevos no enviados según la frecuencia definida, devuelve fulfillment con números de rastreo a DHgate y envía cambios de productos e inventario a DHgate. Vigile los primeros pedidos en Runs / Logs antes de dejarlo sin supervisión.

Preguntas frecuentes#

La prueba falla con un error de autenticación

El App Key o el token de acceso es incorrecto o ya no es válido. El App Key puede haberse copiado de otra aplicación, o el token de acceso del flujo OAuth ha caducado, así que DHgate rechaza la llamada.

En la consola de desarrollador de DHgate, abra su aplicación y copie de nuevo el App Key. Luego complete de nuevo el flujo de autorización OAuth de DHgate, pegue el nuevo token de acceso en el campo Access token y pruebe de nuevo.

Conectado pero no llegan pedidos

La conexión está bien. La cuenta de vendedor simplemente no tiene pedidos nuevos no enviados en el rango de extracción, así que aún no hay nada que importar.

Haga un pedido de prueba que aparezca como no enviado, verifique que su hora esté dentro del rango de extracción, ejecute una extracción manual y confirme que el pedido aparece en la vista previa o en Runs / Logs.

La prueba falla o no vuelve ningún dato tras cambiar una ruta de endpoint

Una ruta avanzada de endpoint ya no coincide con la documentación de DHgate Open Platform. La URL de la pasarela y las credenciales pueden ser correctas, pero si la ruta de prueba es errónea la prueba falla, y si la ruta de pedidos es errónea no se puede traer ningún pedido.

Restaure cada campo de endpoint cambiado a la ruta de la documentación de DHgate Open Platform para su aplicación (pedidos, productos, inventario, fulfillment y prueba son relativos a la URL de la pasarela), guarde y pruebe de nuevo. Cambie solo una ruta a la vez para ver cuál era la errónea.

Los pedidos entran pero fulfillment, productos o inventario no se devuelven

Traer y devolver usan rutas de endpoint distintas. Los pedidos pueden funcionar mientras la ruta de fulfillment, productos o inventario es errónea, así que esa dirección falla por sí sola.

Revise la dirección que falla en la conexión: compare los campos Ruta de fulfillment, Ruta de productos y Ruta de inventario con la documentación de DHgate Open Platform, corrija el erróneo y revise Runs / Logs en el siguiente envío.