快递集成

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

如何将 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 中创建集成

  1. 登录你在 apaczka.pl 的账户。
  2. 在菜单中打开 WEB API,点击 Dodaj integrację(添加集成)。
  3. 输入来源名称,例如 easySales,然后保存。
  4. Apaczka 会显示该集成的 App ID 和 App Secret。请保持页面打开——下一步要把这两项粘贴到 easySales 中。

第 2 步 — 在 easySales 中连接 Apaczka

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

easySales 的快递员页面,已按 Apaczka 筛选,Apaczka 卡片显示为已连接。
整合方式 → 快递员,按 Apaczka 筛选。

填写前几个字段,然后点击 取得详细资料:

easySales 中 Apaczka 连接的顶部:别名、应用 ID、API 密钥,以及设置为 InPost Paczkomat 的服务。
应用 ID、API 密钥,以及此连接使用的唯一服务。
字段 填写内容
别名 一个在多个连接中选择时容易辨认的名称——用服务名称就很合适,例如 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 连接的发件人部分,包含华沙(Warszawa)地址、银行账户、自动安排快递取件、取件时间和 AWB 格式。
发件人、货到付款账户和取件时段。
字段 填写内容
发件人姓名、发件人街道、发件人邮政编码、发件人城市 包裹的发出地址。Apaczka 在波兰境内取件。
发件人国家 用英文输入 Poland。
发件人电子邮件、发件人电话 Apaczka 和快递员联系你的方式。
银行账户 接收货到付款款项的账户,填写 26 位账号。没有它,所有货到付款标签都会被拒绝。
每次生成 AWB 后自动安排快递取件 每张标签都会预约一次快递上门取件。默认勾选。
取件时间 快递员可以上门的时间,在 09:00 到 16:00 之间,且间隔至少两小时。留空表示 09:00–16:00。
AWB格式 A4 适用于办公打印机,A6 适用于热敏标签打印机。
发件人、取件和标签格式

第 5 步 — 选项、包裹类型和投递点

Apaczka 连接的选项、包裹类型和投递点字段,投递点选择了一个 InPost 自提柜。
自提柜服务会询问你在哪里交寄包裹。
字段 作用
选项 添加到此连接每张标签上的 Apaczka 附加服务,例如周六配送。
包裹类型 发货的类型。留空时使用 PACZKA(包裹)。
投递点 适用于从网点寄出的服务时显示。搜索你交寄包裹的自提柜或网点。其地址会作为发件地址发送。
选项、包裹类型和投递点

在这些字段下方是备注模板——作为包裹描述发送给 Apaczka 的文字,截取为 50 个字符——、打印设置以及 显示高级选项,其中 根据产品包裹数量生成包裹 会为订单中每个产品的每个包装各生成一个包裹。完成后点击 保存。

第 6 步 — 为每项服务添加一个连接

如果要使用第二项服务发货,打开连接并点击 克隆。easySales 会保存一份副本,密钥和发件人信息相同,名称后面带有“(cloned)”。打开副本,点击 取得详细资料,重命名,选择另一项服务并保存。

easySales 中的两个 Apaczka 连接,一个用于 InPost 自提柜,一个用于 DPD 快递,每个都在表单上方有自己的按钮。
每项服务一个连接,并排显示。

每个连接在表单上方都有自己的按钮,创建标签时也会作为单独的选项出现。

创建标签

  • 快速创建:从订单列表创建,使用连接中保存的全部设置。重量为订单重量向上取整,最少 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 中重新复制。
你可能在订单上看到的消息

常见问题

在 apaczka.pl 的 WEB API 下:点击 Dodaj integrację,输入来源名称并保存。该集成会显示 App ID 和 App Secret;把它们粘贴到 easySales 的 应用 ID 和 API 密钥 中。

只有在 取得详细资料 向 Apaczka 验证密钥之后,保存 才会出现。请先点击 取得详细资料——重新打开连接进行修改时也一样。

不能。一个连接只使用在 服务 中选择的一项服务发货。使用 克隆 为另一项服务创建第二个连接;创建标签时,每个连接都会作为单独的选项出现。

你在 apaczka.pl 的余额不足以支付这次发货。Apaczka 会从你的账户中扣除每张标签的费用,请在 Apaczka 中充值后重新创建标签。

缺少连接中的 银行账户。Apaczka 需要接收货到付款款项的 26 位账号;没有它,所有货到付款标签都会被拒绝。

会,只要勾选了 每次生成 AWB 后自动安排快递取件:每张标签都会在你设置的 取件时间 范围内预约下一个工作日取件。如果你自己交寄包裹,请取消勾选。

快递服务无法配送到自提柜。请使用服务与订单相符的连接创建标签——InPost 自提柜用 InPost Paczkomat,Orlen 自提点用 Orlen Paczka Punkt-Punkt。

该发货也会在 Apaczka 中取消。

订单重量向上取整,最少 1 kg,以及订单尺寸模板中的尺寸。没有尺寸模板的订单按一个 30 × 30 × 30 cm 的包裹发货。如需发送其他数值,请从订单页面创建标签。

本指南对你有帮助吗?