如何将 Foxpost 与 easySales 连接:完整设置指南
将 Foxpost 连接到 easySales:Foxpost 账户中的 Webapi 信息、包裹尺寸和标签格式、自提柜配送与送货上门,以及标签上可能出现的消息。
连接 Foxpost 能为你带来什么
Foxpost 是匈牙利的包裹配送网络,既可以配送到其 FOXPOST 自提柜,也可以送货上门。连接 easySales 后,它可以从订单列表或订单页面为订单创建发货标签,把 Foxpost 的跟踪号写入订单,并发送到订单来源的 marketplace 或网店,同时跟踪配送状态。
开始之前,有两点需要了解:
- 只有订单上带有 Foxpost 自提柜时,包裹才会寄到自提柜。 快速创建会把包裹寄到客户选择的自提柜。订单上没有 Foxpost 自提柜时,标签会按送货上门创建,寄往客户地址——不会报错。对于缺少自提柜的自提柜订单,请从订单页面创建标签,并在那里选择自提柜。
- 电话号码必须是匈牙利手机号码。 Foxpost 只接受像 +36301234567 这样的号码,不能有空格。easySales 会在发送标签前检查号码。
开始之前
Foxpost 企业账户
在 foxpost.hu,可在 Beállítások 下找到 API 信息。
三个 Webapi 值
Basic auth username、Basic auth password 和 API-key。
匈牙利电话号码
Foxpost 只接受以 +36 开头的匈牙利手机号码。
第 1 步 — 从 Foxpost 复制 API 信息
- 在 foxpost.hu 登录你的企业账户,打开 Beállítások。
- 页面顶部的 Webapi információk 区块包含三个值:Basic auth username、Basic auth password 和 API-key。
- 如果 API-key 为空,点击 Új generálása 生成一个。复制这三个值。
第 2 步 — 在 easySales 中连接 Foxpost
进入 整合方式 → 快递员,搜索 foxpost,在 Foxpost 卡片上点击 连接——如果之前已经连接过,则点击 编辑。
填写表单:
| 字段 | 填写内容 |
|---|---|
| 别名 |
一个在多个连接中选择时容易辨认的名称,例如 Foxpost Budapest。
|
| 帐户姓名 | Foxpost 中的 Basic auth username。 |
| 密码 | Foxpost 中的 Basic auth password。 |
| 令牌 | Foxpost 中的 API-key。 |
| AWB格式 | 标签 PDF 的尺寸:A5、A6、A7 或 _85X85(85 × 85 mm),与你的打印机匹配。 |
| 包裹尺寸 | 此连接每个包裹的 Foxpost 尺寸,从 XS 到 XL。其他尺寸的包裹请另建一个连接。 |
点击 保存。easySales 会向 Foxpost 验证帐户姓名和密码:Account connected. 表示两者正确,Invalid credentials. 表示其中一项有误。
如果要用第二种包裹尺寸发货,或从第二个 Foxpost 账户发货,请再添加一个连接:打开连接并点击 克隆,或者在 Foxpost 卡片的 ⋮ 菜单中选择 连接另一个快递帐户。
创建标签
- 快速创建:从订单列表创建,使用连接中保存的全部设置。每张标签对应一个包裹,尺寸为连接的 包裹尺寸。包裹寄往订单上的 Foxpost 自提柜;如果订单上没有自提柜,则寄往客户地址。
- 从订单页面创建:你可以选择包裹的去向——在 选择配送类型 中选择 自提柜 或 送货上门——在 选择自提柜 或 搜索自提柜 中选择自提柜,并在创建标签前更正客户的姓名、电话号码、电子邮件、街道和城市。
订单为货到付款时,会添加货到付款;金额为订单总额。在订单页面,你还可以为非货到付款的订单添加货到付款金额,并把送货上门的包裹标记为易碎。
之后,订单上会显示 Foxpost 的跟踪号,配送状态随 Foxpost 的跟踪信息更新。
标签被拒绝时
原因会显示在订单上。你最可能看到的有:
| 消息 | 处理方法 |
|---|---|
| Phone number invalid. Must be a Hungary phone number starting with +36. | 客户的电话号码不是 +36301234567 格式的匈牙利手机号码。请在订单中更正,不要有空格。 |
| Failed to create AWB. Reason: CANT_BE_NULL | Foxpost 要求的某个字段为空——最常见的是客户姓名。请补全订单的配送信息。 |
| Failed to create AWB. Reason: MAX_LENGTH | 某个字段超出 Foxpost 允许的长度,例如城市名称超过 25 个字符。请在订单中缩短。 |
| Failed to create AWB. Reason: INVALID_ZIP | 邮政编码不是匈牙利的四位邮政编码。请在订单的收货地址中更正。 |
| Failed to create AWB. Reason: INVALID_EMAIL | 客户的电子邮件地址无效。请在订单中更正。 |
| Failed to create AWB. Reason: INVALID_APM_ID | Foxpost 无法识别该自提柜。请从订单页面创建标签,并重新选择自提柜。 |