如何将 DHL Express 与 easySales 连接:完整设置指南
将 DHL Express 连接到 easySales:MyDHL API 凭据、账户号码、发件人信息、默认产品、创建标签以及 DHL 返回的拒绝原因。
连接 DHL Express 能为你带来什么
连接 DHL Express 后,easySales 会为你的订单创建 DHL Express 货件:把发件人和收件人信息发送给 DHL,接收 PDF 格式的标签,把运单写入订单,并跟踪包裹的配送状态。
开始之前,有三点需要了解:
- 你需要 MyDHL API 访问权限,而不只是 MyDHL+ 登录账号。 easySales 中的 用户名 和 密码 是 DHL Express 为你的账户发放的 API 凭据。你登录 MyDHL+ 所用的用户名和密码在这里无效。
- 账户号码要到创建第一张标签时才会被检查。 取得详细资料 只检查用户名和密码。两个账户字段由 DHL 在创建第一张标签时检查,所以连接后请立即创建一张测试标签。
- 选对 DHL 卡片。 本指南针对名为 DHL 的卡片——即 DHL Express。DHL24 是波兰的 DHL Parcel,有单独的指南;德国的 DHL 包裹服务也有自己独立的卡片。
开始之前
DHL Express 企业账户
以及它的九位数账户号码。
MyDHL API 凭据
DHL Express 提供的 API 用户名和密码。
你的取件地址
包括县、电话号码和邮箱地址。
第 1 步 — 获取 MyDHL API 凭据
DHL Express 向其企业客户提供 API 访问权限。你可以在 DHL Developer Portal(developer.dhl.com)上申请 MyDHL API,或联系你的 DHL Express 客户经理。你会收到一个 API 用户名和密码。你还需要你的 DHL Express 账户号码——共九位数字,印在你的 DHL 发票和合同上。
第 2 步 — 在 easySales 中打开 DHL 卡片
进入 整合方式 → 快递员,搜索 dhl,在 DHL 卡片上点击 连接——如果之前已经连接过,则点击 编辑。
第 3 步 — 凭据和账户号码
填写 别名、用户名 和 密码,然后点击 取得详细资料。DHL 接受凭据后,表单的其余部分就会展开。
| 字段 | 填写内容 |
|---|---|
| 别名 | 此连接的名称,仅在 easySales 内部使用。 |
| 用户名 | 你的 MyDHL API 用户名。 |
| 密码 | 你的 MyDHL API 密码。 |
| 进口快递账户 | 你的 DHL Express 账户号码,九位数字。 |
| 出口快递账户 | 你的 DHL Express 账户号码。如果 DHL 只给了你一个账户号码,两个字段都填同一个。 |
再次打开已保存的连接时,请再点击一次 取得详细资料,以显示所有字段。
第 4 步 — 发件人信息
| 字段 | 填写内容 |
|---|---|
| 国家、县、城市 | 包裹的取件地点。 |
| 发件人地址 | 取件地址的街道和门牌号。 |
| 发件人电话、邮箱 | DHL 就货件联系你的方式。 |
| 公司、发件人联系人姓名 | 你的公司以及 DHL 要找的联系人。 |
| 默认配送服务 | 快速创建所使用的 DHL 产品——例如 Express Worldwide 或 Domestic Express。 |
请填写所有发件人字段,包括 县:如果发件人的县为空,DHL 会拒绝该货件。
第 5 步 — 打印和高级选项
- 显示打印设置:通过 easySales Printer 连接打印时,标签的纸张大小和缩放方式。
- 后备电子邮件:对于没有客户邮箱的订单,发送给 DHL 的邮箱地址。DHL 要求每个货件都有一个邮箱。
- 根据产品包裹数量生成包裹:为每个产品的每个包装各生成一个包裹,适用于分装在多个箱子里的产品。
点击 保存。
如需第二个 DHL Express 账户或另一个取件地址,请在卡片的 ⋮ 菜单中选择 连接另一个快递帐户,或打开连接并点击 克隆。
创建标签
- 快速创建:在订单列表的 AWB 列中选择 快速创建 → DHL。标签会使用你的 默认配送服务 和订单重量创建。
- 从订单创建:在订单的 AWB 部分点击 创建 AWB 并选择 DHL。你可以修改收件人地址,设置多个包裹或信封,并从 DHL 为该线路提供的列表中为本次货件选择 DHL 产品。
标签会以 PDF 形式添加到订单中,easySales 会根据 DHL 的追踪信息更新订单的配送状态。
DHL 拒绝标签时
原因会显示在订单上,使用 DHL 的原文:
| 消息 | 处理方法 |
|---|---|
| 803: Account not allowed for this service. Please contact your DHL Express representative | 账户号码有误,或该产品未在账户上开通。请向 DHL 核实这两点。 |
| Credentials provided where invalid! | 用户名或密码有误——或者填的是你的 MyDHL+ 登录信息。请使用 MyDHL API 凭据。 |
| #/customerDetails/receiverDetails/postalAddress/addressLine1: expected maxLength: 45 | DHL 规定收件人街道最多 45 个字符。请在订单中缩短地址。 |
| #/customerDetails/receiverDetails/contactInformation/mobilePhone: expected type: String, found: Null | 订单中没有收件人电话号码。请在订单中添加。 |
| #/customerDetails/shipperDetails/postalAddress/countyName: expected type: String, found: Null | 连接中没有填写发件人的 县。请填写并保存。 |
| Adresa de email este invalidă | 订单中没有有效的客户邮箱。请在订单中添加一个,或在连接中填写 后备电子邮件。 |