快递集成

如何将 DHL24 与 easySales 连接:完整设置指南

如何将 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 访问权限

  1. 通过 DHL 的联系表单向 DHL eCommerce 申请 DHL24 WebAPI 访问权限,类别选择 WebAPI - uzyskanie dostępu(WebAPI - 获取访问权限)。
  2. DHL 会发给你 WebAPI 密钥及其密码。你的 dhl24.com.pl 账户的登录名和密码在这里无效。
  3. 准备好你的 DHL 客户编号(SAP):你与 DHL 所签合同的 7 位数编号。

第 2 步 — 在 easySales 中连接 DHL24

进入 整合方式 → 快递员,搜索 dhl24,在 DHL24 卡片上点击 连接——如果之前已经连接过,则点击 编辑。

填写连接信息:

easySales 中的 DHL24 连接:别名、API 密钥、隐藏显示的 API 密码和 DHL 客户账户编号。
DHL 提供的 WebAPI 密钥和密码,以及你的客户编号。
字段 填写内容
别名 一个在多个连接之间选择时容易认出的名称,例如 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 上门取件的地址:

DHL24 连接的发件人部分:联系人姓名、联系电话、地址、城市 Warszawa 和邮编。
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. 邮编在收货国家不存在。在订单的收货地址中更正。
订单上可能出现的消息

常见问题

填写 DHL24 WebAPI 密钥及其密码,由 DHL 应申请发放——不是你的 dhl24.com.pl 账户的登录信息。请通过 DHL 的联系表单申请,类别为 WebAPI - uzyskanie dostępu。

你的 DHL 客户编号(SAP),即你与 DHL 所签合同的 7 位数编号。它不是银行账号。

DHL 没有接受 API 密钥 或 API 密码。在连接中填写 DHL 提供的 WebAPI 信息,保存后重新创建标签。

DHL 只对已投保的包裹接受货到付款。在连接的 附加服务 中选择 Insurance,然后重新创建标签。

创建一个使用国际服务的连接,例如 Connect shipment 或 International shipment:打开你的连接,点击 克隆,选择服务并为副本另起一个名称。用它为国外订单创建标签。

使用 运输服务 为 Shipment delivered to point 的连接。快速创建会使用客户选择的网点;在订单页面,在 选择配送类型 中选择 自提柜 并选定网点。

可以,前提是尚未为该货件预约快递取件。在 easySales 中删除后,DHL 那边也会删除;请在 DHL24 中确认它已被删除。

不会。请在 DHL24 中预约取件,或与 DHL 约定定期取件。

本指南对你有帮助吗?