接 DHgate：拉订单进来，推履约出去
在 DHgate 开发者控制台复制 API 网关地址与 App Key，走 DHgate OAuth 流程拿到访问令牌，填进 Integration，测试、配 Mapping、激活——订单流进来，履约流回去。
DHgate 连接器把您 DHgate 卖家账号的订单拉进 OMS，再把履约推回 DHgate。它还能推产品与库存，让两边的订单、商品、库存与发货保持同步。
前置条件#
- 一个 DHgate 卖家账号——访问令牌是发给该卖家账号的。
- 能进 DHgate 开发者控制台，那里显示您的应用、App Key 与 API 网关地址。
- 能为该卖家账号完成 DHgate OAuth 授权流程——访问令牌从该流程获取。
拿凭证#
- 复制 API 网关地址：在 DHgate 开发者控制台里，把 API 网关地址按显示的原样复制。不要凭记忆手打——它不硬编码，错一个字符所有调用都会断。
- 复制 App Key：在 DHgate 开发者控制台打开您的应用，复制 App Key。
- 拿访问令牌：为您的卖家账号完成 DHgate OAuth 授权流程，然后复制该流程给出的访问令牌。妥善保存——之后要填进 Integration 的 Access token 字段。
- 记下您会用到的接口路径：订单、产品、库存、履约与探针路径都在 DHgate 开放平台文档里，是相对于网关地址的路径。只有在下一步改高级接口字段时才需要它们。
填进 Integration#
- 打开 Integration → 连接器市场 → DHgate → 新建连接。
- API 网关地址（base_url）——必填：粘贴从 DHgate 开发者控制台复制的网关地址，按显示的原样填写，例如 https://… 。末尾不要再加接口路径——下面的接口字段都是相对于这个地址的。
- App Key（app_key）——必填：粘贴 DHgate 开发者控制台 → 您的应用里的 App Key。
- Access token（token）——必填：粘贴走 DHgate OAuth 授权流程获取的、您卖家账号的访问令牌。它按密钥保存，保存后永不回显。
- 订单接口路径（ep_orders）——可选，高级： “查询未发货订单”接口的路径，相对于网关地址，例如 /order/list，按 DHgate 开放平台文档填写。除非您应用的文档另有说明，否则保持预填值——路径写错就拉不到订单。
- 产品接口路径（ep_products）——可选，高级：产品列表接口的路径，相对于网关地址，按 DHgate 开放平台文档填写。推产品或读产品时用它。
- 库存接口路径（ep_inventory）——可选，高级：库存更新接口的路径，相对于网关地址，按 DHgate 开放平台文档填写。往 DHgate 推库存时用它。
- 履约接口路径（ep_fulfillment）——可选，高级：发货 / tracking 提交接口的路径，相对于网关地址，按 DHgate 开放平台文档填写。往 DHgate 推履约时用它。
- 连通性探针路径（ep_me）——可选，高级：“测试连接”探针用的轻量只读接口路径，相对于网关地址，按 DHgate 开放平台文档填写。这个路径写错，凭证都对测试也会失败。
测试连接#
点测试连接。测试会用探针路径一起校验网关地址、App Key 与访问令牌，再拉一个真实订单做单据级预览，展示“平台字段 → 标准订单”对照。还没有未发货订单时，先下一个测试订单——预览需要一条真实单据。测试失败时先记下报错，对照下方常见问题排查，不要先改其他设置。
配 Mapping / 选模板#
选 DHgate 标准模板。它映射订单号、行 SKU、数量、收货地址、履约状态。激活前先用一个真实订单看映射预览——重点确认每个 DHgate SKU 都配到了 OMS 产品，让订单、产品与库存两边对齐。
激活#
激活后，Integration 按您设的频率拉新的未发货订单，把带追踪号的履约推回 DHgate，并把产品与库存变化推到 DHgate。先在 运行监控 / 日志里盯几单，确认无误再放手跑。
常见问题#
测试报认证错误
App Key 或访问令牌错了或已失效。App Key 可能复制的是另一个应用的，或 OAuth 流程给出的访问令牌已过期，DHgate 拒绝了调用。
在 DHgate 开发者控制台打开您的应用，重新复制 App Key。再重新完成 DHgate OAuth 授权流程，把新访问令牌粘贴到 Access token 字段，再重新测试。
连接成功但拉不到订单
连接本身没问题。只是卖家账号在拉单范围内没有新的未发货订单，暂时没有可拉的单据。
下一个会显示为未发货的测试订单，确认下单时间落在拉单范围内，再手动拉一次，在预览或 运行监控 / 日志里确认订单出现。
改了接口路径后测试失败或拉不到数据
某个高级接口路径与 DHgate 开放平台文档对不上了。网关地址与凭证都对，但探针路径错了测试会失败，订单路径错了就拉不到订单。
把改过的每个接口字段按您应用的 DHgate 开放平台文档恢复——订单、产品、库存、履约与探针路径都是相对于网关地址的——保存后重新测试。一次只改一个路径，才能看出是哪一个错了。
订单能拉进来，但履约、产品或库存推不回去
拉单与推回用的是不同的接口路径。订单能通时，履约、产品或库存路径写错，那个方向会单独失败。
在连接里查失败的方向：把履约接口路径、产品接口路径与库存接口路径字段逐个与 DHgate 开放平台文档对照，改对写错的那个，再在 运行监控 / 日志里看下一次推送。