敦煌平台合作文档

该文档用于指引如何使用 ITS 国际物流系统（下称 ITS）与敦煌物流商系统实现对接合作，创建敦煌卖家可自主选择使用的公共物流渠道，以及完成在 ITS 系统中完成敦煌物流要求的物流业务操作全链路操作。

对接模式说明

当前 ITS 与敦煌支持DH-gate与DH-Link两种对接模式，区别在于：

- gate 模式：与敦煌卖家进行物流费用结算

- Link 模式：与敦煌平台进行物流费用结算

两种对接模式的对接操作方式一致，在敦煌平台上的卖家操作略有不同。

对接规约依据

ITS 系统与敦煌平台的对接规约，依照敦煌官方给出的：DHgate & 仓库接口规约 - 2025-01-06 - 对外版

- 链接：https://sjfx.feishu.cn/sheets/NW95s8msfhDHJotu1CEcP8Lgnmg?from=from_copylink&sheet=1MwRWs

![](/media/202601/2026-01-22_144228_181419.png)

一、双方对接准备工作

双方的对接准备按照以下顺序进行：

1. 敦煌开户

2. ITS 准备对接参数

3. 敦煌回填对接参数

4. 准备完成

敦煌方面准备

物流公司提供敦煌 TMS 开户信息，敦煌先为物流公司开 TMS 账号，先准备一条测试线路。

开户所需信息如下：

- 公司中文名

- 公司英文名

- 联系人

- 联系电话

- 邮箱

敦煌开户完成后，需要提供：

- clientId（客户号）

- secretKey（密钥）

ITS 方面准备

准备好敦煌系统需要的对接参数，联调的时候需要用：

- 互联通账号

- 秘钥

- 下单地址

- 标签地址

- 取消地址

- 轨迹地址

具体操作步骤：

1. 建立敦煌平台信息

- 在系统中【系统设置】-【api 平台信息】菜单中新增建立敦煌平台

- 生成的平台 APIKEY 对应敦煌的 api_key 字段，作为【秘钥】提供给敦煌

![](/media/202601/2026-01-22_144436_847821.png)
2. 设置接收敦煌订单的 API 信息

- 设置敦煌提供的 clientId 与 secretKey

![](/media/202601/2026-01-22_144524_626333.png)
3. 建立系统客户信息

- 在【客户管理】-【客户】进行新增建立系统客户信息

- 生成的 usertoken 使用敦煌提供的 secretKey 作为密钥进行 AES 加密后，对应敦煌的 api_username 字段，作为【互联通账号】提供给敦煌

![](/media/202601/2026-01-22_144603_614454.png)
4. 设置回推设置

- 需要回推敦煌的客户，需要设置回推设置，填写对接敦煌的 API 信息

对接地址设置

因为下单时返回标签，轨迹由 ITS 推送，所以只需要下单地址与取消地址：

- 下单地址：http://IP 或者域名 /its-api/cs/api/createOrderByDh

- 取消订单地址：http://IP 或者域名 /its-api/cs/api/cancelOrderByDh

- 其他地址填无即可

资料回传给敦煌后按照要求填写相关信息。
完整的填写截图如下

![](/media/202601/2026-01-22_143710_271716.jpeg)
对接准备工作完成后即可开始对接测试

敦煌平台在测试线路推送对接测试订单到ITS
成功接收订单后，在ITS系统中操作入库，出库，更新单号等操作，同时同步订单状态与轨迹给敦煌平台

敦煌平台的对接测试准则如下

1.确认面单信息是否与系统接收信息一致？
2.回传入库接口+回传重量（尺寸按照10*20*30回传），等10min自动扣费成功后，回传出库接口
①不设置体积系数，不接受后期体积重和尺寸申诉；
②德国门牌号和楼栋号请务必确认是否接收完整，后期因未接收该信息导致投递失败，将按照丢件赔付处理；
③偏远限发和不可达邮编请务必提前设置，未设置导致无法发件所产生的国内寄件费用由贵司承担；不接受任何卖家和平台承担费用，知悉。
3.请根据上图事件编号推轨迹，标红部分必推，事件顺序必须保持一致且不能遗漏；注意：首条必须是入库WH001，预报信息要屏蔽；
要求：
首条必须是入库，预报信息屏蔽；
按照顺序推轨迹，标红必推

![](/media/202601/20260119-144702_1768805237.jpg)
4、回传尾程单号（必须回传，不回传无法上线）

在ITS系统则要做以下的对应操作
敦煌订单在物流系统系统操作后，需手动操作以下节点
1、客服管理-外部单据交互-入仓推送客户（回传入库状态）
2、客服管理-外部单据交互-出仓推送客户（回传出库状态）
3、客服管理-外部单据交互-同步订单到客户(用于做了换单的单)

![](/media/202601/2026-01-19_145218_627944.png)
轨迹问题，敦煌的单会按照客户维度回推轨迹给敦煌，但要处理轨迹映射

![](/media/202601/2026-01-19_145250_877152.png)
全部流程测试完毕无误后即可上线正式链路