Odoo18.0 顺丰快递

适用于：15.0 16.0 17.0 18.0，不同版本功能有所不同, 详询客服。

顺丰速运作为国内快递业的标杆企业，使用的频率可谓非常之高。对odoo国内生态而言，怎么能少了如此重要的一个对接方案呢。本文将展示如何使用顺丰速递模块来完成国内快递业务的对接。

先决条件

需要安装以下python库：

autils == 0.3.12
sf-sdk >= 2.0.0.8

丰桥对接

要使用顺丰模块，首先我们要注册一个丰桥(顺丰API开放平台)账号，然后拿到客户编码、校验码和月结号。

1. 首先，我们进入丰桥首页，点击开发者对接，新建一个应用。

   

2. 填入应用名称，开发者语言和应用描述，是否设置沙箱白名单保持默认选项，点击完成。

   

3. 完成应用创建之后，点击查看API，关联我们需要的API。

   

4. 顺丰模块需要的API列表如下：

   • 云打印面单接口
   • isv获取商家自定义模板列表
   • 下订单接口
   • 订单结果查询接口
   • 订单取消接口
   • 订单筛选接口
   • 路由查询接口

5. 回到应用，点击应用详情，获取顾客编码，月结卡号和校验码。

   

完成上面5步我们就完成了顺丰对接的基本设置。

模块配置

接下来，我们来配置我们的顺丰模块。

1. 首先，我们在设置-一般设置-销售-发货设置中，勾选顺丰速运：

   

   然后保存，这样就安装好了顺丰模块。

2. 在库存-设置-送货方式中点击顺丰速运：

   

3. 打开顺丰速运设置，把月结卡号、顾客编码和校验码填入到基础设置中。

   

4. 在设置中选择，自己想要使用的电子面单编码：

   

至此，我们就完成了顺丰模块的基本配置。

使用手册

下面我们来详细介绍顺丰模块的具体功能。

丰桥平台要求API续测试3次成功以后才可以接入生产，因此我们在开始使用的时候应用首先使用沙箱校验码，完成测试以后再换成生产校验码。

1. 销售订单添加顺丰快递

我们创建一个销售订单，例如卖了一个笔记本电脑，然后添加送货方式，选择顺丰速运：

然后我们点击确认订单，生成发货单：

发货单已经默认选择了顺丰，然后我们选择合适的顺丰产品和货物描述，点击验证，完成出库。之后我们就可以在信息栏中可以看到生成了电子面单。

2. 取消订单

在物流跟踪旁边点击取消按钮，可以取消订单。

3. 物流跟踪

当我们每次打开发货单时，模块都会帮我们自动更新订单的当前路由信息。我们可以手动点击更新按钮，实时获取最新的物流信息。也可以点击右上角的物流跟踪按钮到顺丰官网进行查询。

4. 自定义顺丰源单号

我们提供了三种源单号的生成方式：

• 使用发货单号作为顺丰订单的源单号，即SO/OUT/XXX类似的单号直接作为顺丰的源单号。
• 使用发货单的源单号作为顺丰订单的源单号，即PO0001/SO0001等源单据的单号作为顺丰订单号
• 使用随机字符串作为顺丰订单的源单号，即使用发货单号+4位随机字符串的方式生成顺丰订单号。例如WH/OUT/00015-r9jc。

5. 自定义发货地址类型

我们同时提供了三种发货地址的设置方式：

• 使用当前公司地址作为发货地址： 适用于统一发货地址的发货方式。
• 使用发货仓库地址作为发货地址： 适用于公司地址和发货仓库不在一块且有多个仓库的发货方式。
• 使用固定地址作为发货地址： 指定固定的发货地址作为订单的发货地址。

另外，我们也支持自定义地址的格式，如同销售订单的地址格式自定义一样。

6. 跨境支持

对于跨境业务，顺丰要求必须申报货物价值，因此，我们加入了申报货物价值的支持。

如果您的发货地或收货地址在境外，此项为必填。

7. 语言支持

我们同时支持多语言设置，可以根据系统改变或指定固定的语言格式。

8. 批量打印面单

为了方便用户统一下单和获取电子面单，本模块增加了批量打印电子面单的功能。

版本要求：15.7.7+,16.8.0+，17.0.1.0+，18.0.1.0+

FAQ

1. 网站下单时预估价格没有显示

请检查发货地址和目的地址是否合法，可以根据后台日志提示进行诊断。

2. 技术支持

关注公众号OdooHub，联系客服获取在线技术支持。