如何将 DHL24 与 easySales 连接:完整设置指南
将 DHL24(DHL eCommerce 波兰)连接到 easySales:WebAPI 密钥和客户编号、服务、带保险的货到付款、DHL 网点以及 DHL 返回的消息。
连接 DHL24 能为你带来什么
DHL24 是 DHL eCommerce 在波兰的包裹服务,用于波兰境内以及发往其他欧洲国家的货件。连接 easySales 后,它可以从订单列表或订单页面为订单创建标签,把 DHL 的货件编号写入订单,并发送到订单来源的 marketplace 或网店。
DHL24 不是 DHL Express:DHL Express 是 easySales 中另一项独立的集成,有自己的卡片。
开始之前,有两点需要了解:
- easySales 通过 DHL24 WebAPI 密钥连接,而不是用你的 dhl24.com.pl 登录信息。 WebAPI 密钥及其密码由 DHL 应申请发放。你还需要你的 DHL 客户编号(SAP),共 7 位数字。
- 一个连接只使用一项 DHL 服务发货。 每个连接只有一个 运输服务 值,而且它必须与订单相符——境内服务(波兰境内)不能配送到国外,寄往 DHL 网点的包裹需要网点服务。你使用的每项服务都要单独创建一个连接。
开始之前
与 DHL eCommerce 波兰签订的合同
附带你的 7 位数 DHL 客户编号(SAP)。
DHL24 WebAPI 访问权限
WebAPI 密钥和密码,由 DHL 应申请发放。
位于波兰的取件地址
DHL 上门取件的地址。
第 1 步 — 向 DHL 申请 WebAPI 访问权限
- 通过 DHL 的联系表单向 DHL eCommerce 申请 DHL24 WebAPI 访问权限,类别选择 WebAPI - uzyskanie dostępu(WebAPI - 获取访问权限)。
- DHL 会发给你 WebAPI 密钥及其密码。你的 dhl24.com.pl 账户的登录名和密码在这里无效。
- 准备好你的 DHL 客户编号(SAP):你与 DHL 所签合同的 7 位数编号。
第 2 步 — 在 easySales 中连接 DHL24
进入 整合方式 → 快递员,搜索 dhl24,在 DHL24 卡片上点击 连接——如果之前已经连接过,则点击 编辑。
填写连接信息:
| 字段 | 填写内容 |
|---|---|
| 别名 |
一个在多个连接之间选择时容易认出的名称,例如 DHL24 Warsaw。
|
| API 密钥 | DHL 提供的 WebAPI 密钥。 |
| API 密码 | DHL 提供的 WebAPI 密码。 |
| DHL 客户账户编号 | 你的 7 位数 DHL 客户编号(SAP)。它是此连接每张标签的付款方。 |
第 3 步 — 包裹、服务和发件人
| 字段 | 作用 |
|---|---|
| 包裹尺寸 | 你通常寄送的类型:信封、包裹或托盘。大多数卖家选择 Parcel。 |
| 附加服务 | 添加到此连接的每张标签上:Evening Delivery、Saturday Delivery、Saturday Shipment(周六取件)和 Insurance。只选择你与 DHL 的合同中包含的服务。 |
| 运输服务 | 此连接每张标签使用的 DHL 服务——见下方列表。 |
| AWB格式 | A4 适用于办公打印机,A6 适用于标签打印机。 |
| 保险货币 | 保价金额的货币,默认为 PLN。保价金额为订单总额。 |
运输服务 中可以选择的服务:
| 服务 | 适用于 |
|---|---|
| Domestic shipment | 波兰境内标准配送。 |
| Premium shipment | DHL 在波兰境内的高级配送。 |
| Domestic 09 / Domestic 12 | 波兰境内 9:00 前 / 12:00 前送达。 |
| Evening delivery shipment | 波兰境内晚间配送。 |
| Shipment delivered to point | 配送到 DHL POP 或 DHL BOX 24/7 网点。 |
| Connect shipment | 通过公路配送到其他欧洲国家。 |
| Connect Plus shipment / Connect Plus Pallet shipment | DHL 的 Connect Plus 服务,用于包裹 / 托盘。 |
| International shipment | DHL 的国际包裹服务。 |
发件人是 DHL 上门取件的地址:
| 字段 | 填写内容 |
|---|---|
| 联系人姓名 | DHL 在取件地址联系的人。 |
| 联系电话 | 此人的电话号码。 |
| 地址、城市、邮编 | 位于波兰的取件地址。 |
点击 保存。WebAPI 密钥或密码错误,要到创建第一张标签时才会发现:DHL 会以 Nieprawidlowe dane autoryzacyjne 拒绝。
如果要使用其他服务或其他取件地址,打开连接并点击 克隆,然后为副本另起一个名称,并修改不同的内容。
创建标签
- 快速创建:从订单列表创建,使用连接中保存的全部设置。重量为订单中产品的重量,分摊到各个包裹。
- 从订单页面创建:在创建标签之前,你可以修改重量、包裹和信封的数量、它们的尺寸、货到付款金额、保价金额和附加服务。
订单为货到付款时,会添加货到付款;金额为订单总额。
标签被拒绝时
DHL 的回复会以波兰语显示在订单上。你最可能看到的有:
| 消息 | 处理方法 |
|---|---|
| Nieprawidlowe dane autoryzacyjne | API 密钥 或 API 密码 错误——常见原因是填入了 dhl24.com.pl 的登录信息,而不是 WebAPI 密钥。在连接中填写 DHL 提供的 WebAPI 信息并保存。 |
| Błędy walidacji przesyłki: Usługa niedostępna dla danego kraju. | 连接的服务无法配送到订单所在国家。请使用国际服务的连接创建标签,例如 Connect shipment 或 International shipment。 |
| Błędy walidacji przesyłki: Przy zwrocie pobrania wymagane jest ubezpieczenie przesyłki. | 货到付款包裹必须投保。在连接的 附加服务 中选择 Insurance,然后重新创建标签。 |
| Błędy walidacji przesyłki: Podany numer punktu serwisowego jest błędny bądź niedostępny dla zadanych usług | 订单上的 DHL 网点有误,或不接受此服务。在订单页面选择其他网点,并使用 Shipment delivered to point 连接创建标签。 |
| Błędy walidacji przesyłki: Zawartość pola Preawiz Odb Nr Tel musi być liczbą. | 客户的电话号码包含数字以外的字符。在订单上更正,只保留数字。 |
| Błędy walidacji przesyłki: Wartość w polu Telefon jest za krótka (minimalna liczba znaków to 8). | 客户的电话号码太短。在订单上更正。 |
| Błędy walidacji przesyłki: Niepoprawny kod pocztowy dla wybranego kraju. | 邮编在收货国家不存在。在订单的收货地址中更正。 |