快递集成

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

如何将 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 信息

  1. 在 foxpost.hu 登录你的企业账户,打开 Beállítások。
  2. 页面顶部的 Webapi információk 区块包含三个值:Basic auth username、Basic auth password 和 API-key。
  3. 如果 API-key 为空,点击 Új generálása 生成一个。复制这三个值。

第 2 步 — 在 easySales 中连接 Foxpost

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

easySales 的快递员页面,搜索 foxpost 后显示已连接的 Foxpost 卡片。
整合方式 → 快递员,搜索 foxpost。

填写表单:

easySales 中的 Foxpost 连接:连接名称、帐户名、已隐藏的密码、令牌、标签格式 A6 和包裹尺寸 S。
三个 Webapi 值、标签格式和包裹尺寸。
字段 填写内容
别名 一个在多个连接中选择时容易辨认的名称,例如 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 无法识别该自提柜。请从订单页面创建标签,并重新选择自提柜。
你可能在订单上看到的消息

常见问题

在 foxpost.hu 上你的 Foxpost 企业账户中,位于 Beállítások → Webapi információk:Basic auth username 是帐户姓名,Basic auth password 是密码,API-key 是令牌。如果 API-key 为空,请点击 Új generálása。

订单上没有 Foxpost 自提柜,所以快速创建把包裹寄往了客户地址。对于缺少自提柜的自提柜订单,请从订单页面创建标签,选择 自提柜 并选择自提柜。

如果订单上带有客户的 Foxpost 自提柜,快速创建就会这样做。否则请从订单页面创建标签:在 选择配送类型 中选择 自提柜,然后选择自提柜。

Foxpost 只接受以 +36 开头、不含空格的匈牙利手机号码——例如 +36301234567。以 06 开头的号码和固定电话号码会被拒绝。请在订单中更正号码。

可以。每个连接只有一个 包裹尺寸,因此每种尺寸建一个连接:打开连接,点击 克隆,选择另一种尺寸,并为副本另起一个名称。

帐户姓名或密码与你的 Foxpost 账户不符。请从 Beállítások → Webapi információk 重新复制 Basic auth username 和 Basic auth password,然后保存。

不会。请在 FOXPOST automata 的 Csomagfeladás → Üzleti partnereknek 下交寄包裹,或与 Foxpost 预约取件。

在 easySales 中删除标签会将其从订单中移除。如果要取消包裹本身,请在交寄前在你的 Foxpost 账户中删除它。

本指南对你有帮助吗?