如何将 FanCourier 连接到 easySales:完整配置指南
把 FanCourier 连接到 easySales:表单上的每个字段、为什么服务类型决定运单能否发出、如何管理多个帐户,以及 FanCourier 每种拒绝提示的含义。
连接 FanCourier 能带来什么
连接 FanCourier 后,easySales 会为订单生成运单、打印面单、跟踪包裹、取消发货,退货时还能呼叫快递员上门取件——你完全不需要打开 FanCourier。
本指南覆盖整个连接流程,并从旧文档从未提到的字段开始——服务类型——因为正是它决定了运单能否发出。
开始之前
一个开通 API 访问的 FanCourier 帐户
FanCourier 会为它签发帐户 ID、用户名和密码。如果还没有,卡片 ⋮ 菜单中的注册一项会说明如何申请。
备好帐户 ID
它是数字客户编号,不是用户名。每次请求都会带上,一旦填错就会以 The client id do not exists... 中止一切。
合同中使用的服务
你需要知道该连接上的订单是货到付款还是预付,以及哪种 FanCourier 服务覆盖它们。正是这个字段决定运单能否发出。
每套选项一个连接
每个连接只有一种服务、一组凭据、一套选项。两个仓库或两种付款方式就意味着两个连接——在这里不止一个连接很常见。
第 1 步 — 打开快递员页面
进入 整合方式 → 快递员,搜索 fancourier。在新版导航中,同一页面位于 整合方式 → 配送 → 快递员。
在 FanCourier 卡片上点击 连接。如果你还没有 FanCourier 合同,卡片的 ⋮ 菜单里有 注册 一项,会说明如何申请。
第 2 步 — 填写凭据并点击取得详细资料
填写 别名、帐户ID、用户名 和 密码,然后点击 取得详细资料。
别名 只属于你——它永远不会传给 FanCourier。生成运单时你要按这个名称来选择连接,所以请用发货仓库或所用服务来命名。
第 3 步 — 选择服务类型
这是表单中最重要的字段,也是大多数本可避免的错误的根源。
下面的 投递点 字段很容易被误解:
第 4 步 — 连接的其余部分
| 字段 | 作用 |
|---|---|
| 别名 | 必填。你为这个帐户起的名称。生成运单时按它选择连接,它永远不会传给 FanCourier。 |
| 帐户ID |
必填。你 FanCourier 帐户的数字客户编号。每次请求都会带上它;填错会返回 The client id do not exists...
|
| 用户名 和 密码 | 必填。FanCourier 为 API 访问签发的凭据。easySales 会自行登录并在需要时续期,之后无需再次连接。 |
| 服务类型 | 该连接生成的每张运单所使用的 FanCourier 服务。参见上一步——正是这个字段决定运单能否生成。 |
| 投递点 | 你交寄包裹的 FANbox。只在 FANbox 服务下使用。 |
| AWB格式 | A4 或 A6——FanCourier 生成面单的尺寸,A6 是热敏标签尺寸。它会发给 FanCourier,不是打印机设置。 |
| 周六交货 | 为该连接的每张运单加上 FanCourier 的周六派送服务。 |
| 打开包裹 | 加上 FanCourier 的开箱验货服务,收件人可在付款前查看内容。 |
| 运费付款人 | FanCourier 向谁收费:发件人 或 收件人。退货连接还提供收件人和第三方。 |
| 将订单 ID 作为内部参考发送 | 把 easySales 的订单号作为包裹参考发给 FanCourier,这样在对方系统和发票上都能看到。 |
| 笔记模板 | 面单备注行上打印的内容。在 97 个字符处截断。 |
笔记模板 决定该连接生成的每张面单备注行上打印的内容。上方的按钮会插入订单及其商品的值——订单号、发票序列、数量和 SKU、仓库位置。
第 5 步 — 打印设置和高级选项
两部分默认折叠,都不是必填。
| 设置 | 作用 |
|---|---|
| 纸张大小 / 缩放类型 | 只有通过 easySales Printer 连接打印时才生效,并且只针对这个快递。它们会覆盖打印机自身的默认值。这与 AWB格式 不同:面单长什么样由 FanCourier 决定,这两项决定它如何落到纸上。 |
| 成本中心 | 最多 40 个字符,随该连接的每张运单发送。FanCourier 会把它显示在发票上,因此这是按店铺、仓库或销售渠道拆分快递费用最简单的方式。 |
| 根据产品包裹数量生成包裹 | 按订单中每件商品的包裹数量合计运单上的包裹数,而不是始终发送一个。 |
| 自动呼叫快递 | 仅退货连接可用。退货运单一生成就请求 FanCourier 上门取件。 |
多个 FanCourier 帐户
一个连接只保存一组凭据、一种服务和一套选项。如果你从两个仓库发货,或者既有货到付款订单又有预付订单,就需要两个连接——在这里这是常态,而不是例外。
要添加连接,打开 FanCourier 卡片的 ⋮ 菜单并选择 连接另一个快递帐户。要复制现有连接,打开它并点击 克隆:所有设置都会复制一份,名称后会加上 " (cloned)",之后请改掉。
每个连接都保留自己的凭据、服务、选项和笔记模板,并在生成运单时以 别名 显示。
退货运单
在 FanCourier 卡片上,表单有两个标签页:配送账户 和 退回账户。退货连接就是普通连接,外加包裹寄回的地址。
退货标签页上有两个字段的行为不同:
- 运费付款人 额外提供 收件人 和 第三方。选择第三方后会出现 第三方名称 字段,FanCourier 会向该名称收费。
- 自动呼叫快递 位于 显示高级选项 中。开启后,退货运单一生成,easySales 就会请求 FanCourier 派人上门取件。
生成运单
| 位置 | 得到什么 |
|---|---|
| 订单列表上的 快速创建 | 选择 FanCourier,再按名称选择连接。立即生成一张运单,使用该连接上的全部设置。 |
| 订单页面上的 创建 AWB | 同样的功能,另加连接无法保存的内容:信封、包裹、总重量、尺寸和代收金额。 |
| 订单列表中选中多个订单 | 每笔订单一张运单,全部使用同一个连接。 |
当 FanCourier 拒绝运单时
消息原样来自 FanCourier,并显示在订单上。几乎所有被拒都出于下列原因之一。
| FanCourier 的提示 | 该怎么做 |
|---|---|
COD (cash on delivery) is required for this service type
|
订单没有需要代收的金额,而连接上的服务是货到付款服务。请改用服务支持预付包裹的连接——大多数合同里是 Standard。 |
COD (cash on delivery) is forbidden for this service type
|
反过来的情况:订单有代收金额,而该服务不接受代收。 |
The cash on delivery field can only be filled if the client accepts card payment
|
你的 FanCourier 合同不允许以该订单的方式代收款项。这需要在 FanCourier 一侧解决,而不是在 easySales 里。 |
Not allowed to create awb
|
FanCourier 拒绝的是帐户本身——通常是合同被暂停或运单额度用尽。 |
The client id do not exists...
|
连接上的 帐户ID 不是 FanCourier 认可的客户编号。 |
Locality is invalid
|
FanCourier 不认识订单上的城市。请在订单中更正地址——注意布加勒斯特的分区会自动作为 Bucuresti 发送,所以问题不在分区。
|
The recipient.address.zip code must not be greater than 6 characters.
|
订单上的邮编过长。罗马尼亚邮编为六位数字。 |
awbGeneration.info.options.fanBoxDropOffOrPickupOptionRequired
|
使用了 FANbox 服务却没有交寄地点。请在连接上设置 投递点,或把订单发往自提柜。 |
The selected info.service is invalid.
|
连接上保存的服务在你的 FanCourier 帐户中已不存在。点击取得详细资料,从刷新后的列表中重新选择。 |
The info.observation must not be greater than 255 characters.
|
笔记模板生成的文本太长,请缩短。 |
An error occurred
|
FanCourier 的通用错误,没有更多信息。值得重试一次;如果每笔订单都出现,就需要 FanCourier 处理该帐户。 |
These credentials have expired
|
无需处理。easySales 会自行重新登录并重发请求。 |
取消运单
easySales 可以删除 FanCourier 运单,并原样返回对方的答复。