1.介绍
本文主要针对使用E2E服务的API客户,从创建订单获取面单,到轨迹节点信息获取,提供对接指导。
2.API文档下载
客户API文档介绍详见API在线文档指导页面第3章节部分。
3.API对接
3.1 genericDataAndLabel API
1) 介绍
客户通过对接genericDataAndLabel API可以进行下单及获取面单。系统校验完成后(字段规则校验+黑名单检查)返回标签。系统不允许用重复的shipmentId创建订单和获取面单。
2) 对接流程
客户首先在测试环境进行测试对接,如测试完成,成功获取面单后,请告知CN.PI <cn.pi_support@dhl.com>为您申请正式环境的API credentials. 正式账号的申请流程为1-2个工作日左右,请于需正式下单前提前告知。正式API credentials查看请见API在线文档指导2.D-connector内容。
3) 测试账号
"pickupAccountId":"HKCYL001",
"soldToAccountId":"HKCYL001"
4) genericDataAndLabel API 速率限制
下面是主要的请求限制:
服务等级 | 每秒请求频率 | 每天请求频率 |
标准 | 20 req/S | 无限制 |
一秒最多请求20次。
3.2 Tracking API
客户在call genericDataAndLabel API 成功后,如客户获取尾程面单,系统会返回DSP tracking number. 如客户想要主动获取尾程节点信息可以对接Tracking API.
以下主要针对使用Shipment Tracking API的用户进行说明。
使用Shipment Tracking API的用户可以实现以下需求:
a. 检索装运的跟踪信息。
b. 确定参与装运的Deutsche Post DHL(DPDHL)服务提供商。
c. 验证DPDHL是否使用正确的送货地址。这可以减少误发货的数量
Tracking API 对接操作详见Tracking API页面。