如何将 Apaczka 与 easySales 连接:完整设置指南
将 Apaczka 连接到 easySales:创建 WEB API 集成,每个连接选择一项服务,设置发件人、取件和标签格式,并处理 Apaczka 返回的消息。
连接 Apaczka 能为你带来什么
Apaczka 是一个波兰的发货平台:一个 Apaczka 账户就能让你使用 InPost、DPD、DHL、Orlen Paczka、Poczta Polska 等多家承运商。连接 easySales 后,它可以一键为订单创建发货标签——从订单列表或订单页面均可——并把跟踪号写入订单。
开始之前,有两点需要了解:
- 每张标签都从你的 Apaczka 账户扣费。 创建标签时,Apaczka 会从你在 apaczka.pl 的余额中扣除运费,因此开始发货前,账户里需要有足够的余额。
- 一个连接对应一项服务。 一个连接会用你在其中选择的服务发送所有标签——InPost Paczkomat、DPD Kurier 等。如果要使用多项服务,就为每项服务分别创建一个连接。
开始之前
有余额的 apaczka.pl 账户
标签费用从你的 Apaczka 余额中扣除,所以首次发货前请先充值。
Apaczka 中 WEB API 的访问权限
你要在那里创建集成,以获得 App ID 和 App Secret。
你要使用的发货服务
确定你使用哪些承运商——例如 InPost 自提柜和一个送货上门的快递——因为每项服务都需要单独的连接。
第 1 步 — 在 Apaczka 中创建集成
- 登录你在 apaczka.pl 的账户。
- 在菜单中打开 WEB API,点击 Dodaj integrację(添加集成)。
- 输入来源名称,例如
easySales,然后保存。 - Apaczka 会显示该集成的 App ID 和 App Secret。请保持页面打开——下一步要把这两项粘贴到 easySales 中。
第 2 步 — 在 easySales 中连接 Apaczka
进入 整合方式 → 快递员,搜索 apaczka,在 Apaczka 卡片上点击 连接——如果之前已经连接过,则点击 编辑。
填写前几个字段,然后点击 取得详细资料:
| 字段 | 填写内容 |
|---|---|
| 别名 |
一个在多个连接中选择时容易辨认的名称——用服务名称就很合适,例如 Apaczka InPost lockers。
|
| 应用 ID | 第 1 步中创建的集成的 App ID。 |
| API 密钥 | 同一集成的 App Secret。 |
| 服务 | 此连接使用的发货服务。点击 取得详细资料 后才可选择。 |
取得详细资料 会向 Apaczka 验证这两个密钥,并解锁表单的其余部分,包括 保存。每次打开连接时都会显示这个按钮,每次保存前都需要先点击它。
第 3 步 — 选择服务
服务 列出了 Apaczka 提供的所有服务。选择此连接要使用的服务,并确认你的 Apaczka 账户可以使用该服务。
| 订单配送到 | 可选择的服务示例 |
|---|---|
| InPost 自提柜(Paczkomat) | InPost Paczkomat——Allegro Smart 订单可选 Allegro SMART Paczkomat InPost |
| Orlen Paczka 自提点 | Orlen Paczka Punkt-Punkt |
| DPD Pickup 自提点 | DPD Pickup Punkt-Punkt |
| 客户地址 | InPost Kurier、DPD Kurier 或其他快递服务 |
第 4 步 — 发件人、取件和标签格式
| 字段 | 填写内容 |
|---|---|
| 发件人姓名、发件人街道、发件人邮政编码、发件人城市 | 包裹的发出地址。Apaczka 在波兰境内取件。 |
| 发件人国家 |
用英文输入 Poland。
|
| 发件人电子邮件、发件人电话 | Apaczka 和快递员联系你的方式。 |
| 银行账户 | 接收货到付款款项的账户,填写 26 位账号。没有它,所有货到付款标签都会被拒绝。 |
| 每次生成 AWB 后自动安排快递取件 | 每张标签都会预约一次快递上门取件。默认勾选。 |
| 取件时间 | 快递员可以上门的时间,在 09:00 到 16:00 之间,且间隔至少两小时。留空表示 09:00–16:00。 |
| AWB格式 | A4 适用于办公打印机,A6 适用于热敏标签打印机。 |
第 5 步 — 选项、包裹类型和投递点
| 字段 | 作用 |
|---|---|
| 选项 | 添加到此连接每张标签上的 Apaczka 附加服务,例如周六配送。 |
| 包裹类型 | 发货的类型。留空时使用 PACZKA(包裹)。 |
| 投递点 | 适用于从网点寄出的服务时显示。搜索你交寄包裹的自提柜或网点。其地址会作为发件地址发送。 |
在这些字段下方是备注模板——作为包裹描述发送给 Apaczka 的文字,截取为 50 个字符——、打印设置以及 显示高级选项,其中 根据产品包裹数量生成包裹 会为订单中每个产品的每个包装各生成一个包裹。完成后点击 保存。
第 6 步 — 为每项服务添加一个连接
如果要使用第二项服务发货,打开连接并点击 克隆。easySales 会保存一份副本,密钥和发件人信息相同,名称后面带有“(cloned)”。打开副本,点击 取得详细资料,重命名,选择另一项服务并保存。
每个连接在表单上方都有自己的按钮,创建标签时也会作为单独的选项出现。
创建标签
- 快速创建:从订单列表创建,使用连接中保存的全部设置。重量为订单重量向上取整,最少 1 kg;包裹尺寸来自订单的尺寸模板,没有尺寸模板的订单按一个 30 × 30 × 30 cm 的包裹发货。
- 从订单页面创建:你可以修改地址或自提柜、重量、包裹数量和尺寸以及货到付款金额,选择 Apaczka 的附加服务,查看预估费用,并决定是否为这个包裹预约上门取件。
之后,订单上会显示承运商的跟踪号以及指向 Apaczka 跟踪页面的链接。在 easySales 中删除标签,也会在 Apaczka 中取消该发货。
标签被拒绝时
Apaczka 的回复会以 Apaczka 的原话显示在订单上,位于 Apaczka error: 之后。你最可能看到的有:
| 消息 | 处理方法 |
|---|---|
| Brak wystarczających środków na koncie | 你的 Apaczka 余额不足。请在 apaczka.pl 充值。 |
| Wprowadzono niepoprawny numer konta bankowego w usłudze pobranie | 货到付款订单,但连接中没有填写 银行账户。请添加 26 位账号。 |
| Doręczenie do punktu nie jest realizowane | 配送到自提柜的订单使用了快递服务。请使用自提柜连接创建标签。 |
| Nie wybrano paczkomatu doręczenia | 订单没有自提柜,却使用了自提柜服务。请在订单页面选择自提柜,或使用快递连接。 |
| Nieprawidłowy punkt odbiorczy | 订单中的自提点属于另一家承运商。请使用该承运商的连接。 |
| Opcja [Przesyłka wieloelementowa] jest niedostępna | 自提柜服务每张标签只接受一个包裹。请以单个包裹创建标签。 |
| Liczba znaków … nie może przekraczać 50 znaków | 姓名或街道超过 50 个字符。请在订单页面缩短。 |
| Numer telefonu … niepoprawny | 自提柜需要波兰手机号码。请在订单中更正客户电话。 |
| App not found. | 应用 ID 有误。请从 apaczka.pl 的 WEB API 中重新复制。 |