1.目的
本文主要针对使用end-to-end(端到端)服务的客户,从创建订单获取面单,到面单打印质量把控,再到最后tracking 节点信息获取,提供全链路的对接指导。
2.US T11 Service
对于使用US T11服务的客户,在正式上线前请确保以下资料信息已提供并由您的销售经理确认无误。如您对于下方表格中内容有任何疑问请联系您的销售经理进行咨询。
US T11要求详见附件:US_T11_Requirements
注意:对于PLT/PLG US的服务,客户需要在成功获取面单后10天内将货物送到DHL仓库,否则可能出现派送延迟的情况。
2.1IMG US T11 要求
1) IMG对于中国客户寄件人地址信息的州/省的填写有一定要求。下方附件第1列为符合要求的shipper state清单,如填写的shipper address中的state不在清单中,下单失败且返回报错信息:[DVT Rule:272626439195648] IMGT11 US shipper state invalid.
2) 对于HS Code,客户需要使用白名单中正确的HS code进行下单,US HS code whitelist请见下方附件a。如使用的HS code不在whitelist里或在下方附件b的IMG blacklist中,将创建订单失败。
附件a: US HS Code Whitelist
3.E2E标签获取
客户可以通过两种方式进行下单获取标签。1. 登录FCM Portal系统创建订单;2. 通过对接genericDataAndLabel API创建订单。系统校验完成后(字段规则校验+黑名单检查)返回标签。系统不允许用重复的shipmentId创建订单和获取面单。以下为两种下单方式的介绍:
3.1FCM Portal系统
客户登录FCM Portal系统创建订单。客户的FCM Portal登录账号及下单账号信息将通过邮件给到客户。FCM Portal访问地址:https://myfcm.dhl.com/
FCM操作文档详见FCM Portal页面。
3.2genericDataAndLabel API
客户通过对接genericDataAndLabel API进行下单获取标签。
对接详见E2E API对接页面。
4.标签要求
白面单标签样式示例:
4.1打印基本配置要求
- 打印机型号:ZEBRA GX420D
- 标签大小:100*150mm
- 标签纸类型:热敏标签
5.提货流程
中国大陆客户申请上门提货需要在FCM Portal平台进行操作,请参照DHL FCM客户门户网站使用手册3.3节内容进行操作。
注意:CN大陆客户16:00前创建提货申请,最早的提货日期为创建日期当日;16:00之后创建提货申请,最早的提货日期为创建日期+1日。
6.HK客户自送货流程
中国香港地区客户在完成下单,贴小包尾程面单,并更新大小包关系数据后,客户需要把按照DHL要求装好的大箱送到指定的HKG仓库。
邮件及实货最迟需当天15:00 送到仓库,二缺一都无法安排出货。
预报Email 标题: 客戶名 + 送货日期 + 箱数 / 袋数+ 件数
请将预报邮件发送至以下所有邮箱,并抄送您的销售:
hkg.ops@dhl.com & ka_ching.lam@dhl.com & zhuo_quan.li@dhl.com
7.包裹轨迹查询
7.1 DHL官网查询轨迹
客户在下单完成后,可以访问DHL官网查询后续包裹的轨迹节点更新。如果对现有节点仍有疑惑,中国客户可以咨询DGF eCommerce C/S team <cs-ecomteam.sz@dhl.com >.
DHL官网:https://www.dhl.com/
7.2 对接Tracking API查询轨迹
客户可以根据需求对接以下Tracking API获取轨迹节点。
Tracking Pull API
支持客户主动发送请求进行轨迹查询。
Tracking Pull API文档: https://dhl1.portal.swaggerhub.com/dconnectordhlcom/docs/tracking-pull-api
Tracking Push API
支持客户订阅轨迹节点,系统推送轨迹更新。
Tracking Push API文档: https://dhl1.portal.swaggerhub.com/dconnectordhlcom/docs/tracking-push-api
8.正式上线注意事项
1) E2E on-boarding 完成,发货过程中,客户需要持续监控和纠正标签打印质量问题,在日常操作中,需要注意:
- 字段符合要求
- 打印清晰、齐全,条码无断点
- 张贴平整、无划痕、无水渍、无褶皱、无胶带覆盖、无缺损
面单张贴样例:
2) 字段要求
客户进行下单时,当产品服务为PKW,PLG,PLT,PPW,PPD,PED,PPM,PKM,PDC,PLD目的国为EU 国家,以及当产品服务为PLG,PLT目的国为US时,请使用正确的HS code,确保使用的HS code在DHL提供的HS code whitelist中。
HS code whitelist详情见附件:
- 客户发送请求的面单格式需为PDF,我们不支持ZPL, PNG等格式。
- 请不要将特殊字符”|”包含在传给我们的数据中,否则可能导致订单数据无法正常处理。
- 请将IOSS号填在"fiscalId"字段中,不要填写在任何其他字段,比如收件人地址或remarks等字段中。
- 在发送给我们的数据中请使用ASCII码字符,若使用特殊字符,可能出现系统无法识别,包裹信息缺失的情况。
- shipperAddress中不能包含中文字符,若使用中文字符,可能出现系统无法识别,包裹信息缺失的情况。
- 客户下单产品为PLT/PLG及目的国为US时,请检查您的商品描述是否符合ACAS的要求。详细请参考:https://www.cbp.gov/trade/basic-import-export/e-commerce/examples-unacceptable-vs-acceptable-cargo-descriptions
- 客户下单产品为PLT/PLG及目的国为CA时,请注意收件人的名字只能接受英语或法语字符,使用其他语言字符可能会导致订单处理延迟或错误。
- shipmentId字段长度为5-30位字符,且不能包含空格。
- 货物从中国大陆出口清关的客户在下单时需要提供以下信息:
| FCM必填字段(中文/英文) | API必填字段(marketplaceURL字段填写示例) |
| 生产销售单位名称 / Manufacturing name | CN_MFName |
| 生产销售单位统一社会信用代码(18位)/ Unified Social Credit Code(18 digits) | CN_MFCode |
| 电商平台名称 / E-com platform name | CN_MPName |
| 电商平台代码 / E-com platform code | CN_MPCode |
- 对于产品服务PKW, PPW, PLG, PLT目的国为EU27(DDP),客户下单时需提供清关发票号(Customs Invoice Number)信息。
- 对于需要通过US CDZ 进口清关的订单,客户需要提供item weight商品重量(shipmentContents.grossWeight)信息。
- 对于目的国为德国的服务以及美国UniUni的服务,客户填写收件地址时需按照 "街道名+门牌号" 的格式,填至address1. 请勿将门牌号或其他地址信息填至address2.
9.客户支持AI平台
对于客户在对接过程中的常见报错或咨询,我们提供AI自动回复服务,链接如下(免登录),验证码为ecs.pi_999。
AI Chatbot URL:https://cnk2zb8zv2.coze.site/
温馨提示:
- 答案仅供参考:平台回复由 AI 自动生成,无法保证 100% 的准确性。若涉及关键决策或复杂问题,请以人工确认为准。
- 知识库持续更新:由于平台刚上线,目前的知识库内容可能有限,部分深层问题 AI 可能暂时无法回答。我们正在持续补充和优化知识库内容。
- 随时联系人工:如果您在平台没有找到满意的答案,或者需要更深入的技术支持,请随时联系您的专属客户经理或技术支持团队(cn.pi_support@dhl.com)。
10.FQA
1) 系统允许使用重复的shipmentId单号进行下单吗? 如果用同一个CCN请求,系统返回什么?
不允许,如果用重复的shipmentId请求,系统报错:
"[Generate Label] Generating label batch fail: PackageId have successfully called external
parcel API before. Same packageId cannot repeatedly call".
2) 客户创建订单遇到收件人或发件人的信息疑似黑名单报错应该如何处理?
报错信息: [NECST Group:220785572907008] Shipper/consignee information is suspected to be deny party.
解决方案:
- 可尝试1-2小时后使用相同的shipmentId及订单信息重新请求。
- 等待DHL 系统邮件告知您的寄件人/收件人信息是否通过黑名单校验。
a. 若校验通过,请使用相同的shipmentId及订单信息重新请求。
b. 若校验未通过,则需要您修改shipmentId及寄件人/收件人信息重新发送请求。
如您需要接收黑名单校验结果的通知邮件,请提供接收通知的邮箱地址,告知<cn.pi_support@dhl.com>为您配置。
3) 当客户下单的产品服务为PLT/PLG,目的国为GB时,地址格式有什么需要注意的地方?如未使用正确的地址格式可能会产生什么问题?
地址中需要注意house number应在street name之前,如:Flat 7, Arkwright Mansions Finchley Road. 如未按正确的地址格式填写可能导致面单显示的地址不完整,影响包裹的配送。
4) 对于目的国为德国的服务,客户是否可以使用Packstation作为收件地址?Packstation地址应该如何填写?
对于德国的服务,客户可以使用Packstation作为收件地址,如需使用该类型收件地址请联系您的销售经理协助申请配置。
地址填写规范如下:
| Field | Rule |
| Consignee Address 1 | 只填写street name (路名)+ house number (门牌号),门牌号与路名之间用空格间隔, 例如 Fürstenbergstr. 15 如果是Packstation, 填写 Packstation + keywordId, 例如 Packstation 255 |
| Consignee Address 2 | 如果是Packstation, 填写Postnumber, 否则为空 |