文档

# 物流助手

# 商户侧接入说明

物流助手，帮助有物流需求的开发者，快速高效对接多家物流公司。对接后用户可通过QQ服务通知接收实时物流状态，提升用户体验。

# 产品优势

# 小程序开发者

  1. 节省开发成本：通过QQ统一对接多家物流公司，平均1-2周调通接口，减少以往逐一对接多家物流的开发成本；
  2. 实时跟进订单：可通过接口调取或通过事件接收订单的实时路由状态，跟踪最新路由情况；
  3. 提升用户回访：关键物流状态会通过QQ服务通知发送给用户，用户点击后可回访小程序查看该订单;
  4. 利于数据保护：无需担心数据洞穿，利于保护和积累你的数据；
  5. 接口完全免费：快递费为你与快递公司签约时收取，QQ不收快递费及接口费；

# 用户

查收物流状态：用户在已调通物流接口的QQ小程序内的订单，可以通过服务通知收到QQ官方发送的订单物流状态。

# 小程序接入步骤

  1. 登录QQ小程序管理后台，点击「物流助手」-「开通」，开通物流助手；
  2. 绑定已与你有合作的物流公司账号；
  3. 按照本文档完成接口开发；
  4. 下单时调用物流助手API即可。

# 已经支持的快递公司基本信息

快递公司名称 快递公司ID 服务类型ID及名称 是否支持现付 现付的BizID 快递模式
百世快递 BEST 1（标准快递） 否 - 加盟
中国邮政速递物流 EMS 6（标准快递）
9（快递包裹） 否 - 直营
承诺达特快 OTP 1（标准快递） 是 OTP_CASH 直营
品骏物流 PJ 1（标准快递） 是 QQ_PJ_ST_DEFUALT 直营
顺丰速运 SF 1（顺丰即日）

2（顺丰次晨）
3（顺丰标快）
4（顺丰特惠） | 是 | SF_CASH | 直营
圆通速递 | YTO | 0（普通快递）
1（圆准达） | 否 | - | 加盟
韵达快递 | YUNDA | 0（标准快件） | 否 | - | 加盟
中通快递 | ZTO | 0（标准快件） | 否 | - | 加盟

# 打印面单

小程序开发者下单之后，可以选择以下几种方式来打印电子面单：

  1. 安装QQ打单PC软件；
  2. 使用 getOrder 拉取电子面单 html，使用热敏打印机打印；
  3. 使用快递公司的接口；
  4. 使用 getOrder 拉取电子面单的 waybill_data，自行构造面单并打印。

# 相关接口

# 相关事件

# 快递侧接入说明

物流助手，帮助有物流需求的开发者，快速高效对接多家物流公司。对接后用户可通过QQ服务通知接收实时物流状态，提升用户体验。

# 产品优势

  1. 承接QQ生态订单：通过QQ统一接口，一次性服务QQ生态内有寄件需求的商户。
  2. 提升用户回访：关键物流状态会通过QQ服务通知发送给用户，用户点击后可回访快递公司小程序查看该订单的物流状态或进行后续操作。

# 接入说明

如果你的小程序类目为“快递业与邮政-寄件/收件类目”，并计划面向QQ生态提供物流服务，请邮箱联系我们，开发完成后即可申请作为物流公司接入QQ物流助手。

  • 联系邮箱：Logistics@tencent.com
  • 邮件标题：公司全称(如XX快递)+符合上述类目的小程序APPID+申请接入QQ物流助手

# 接入准备

# 1. 小程序

用户收到轨迹更新消息后，可以间接跳转到快递小程序的轨迹详情页。至少需要提供两个页面：

  1. 快递轨迹详情页，路径可以参考pages/info/info?from=qq&no=12345678901234。QQ做跳转时，会传入运单号。
  2. 快递投诉页面

# 2. 小程序事件服务

事件服务用于接收QQ的推送，目前有审核商户、查询余额、下单、取消运单等事件。

# 3. 面单模板和示例

标注各个区域的尺寸、字号等。

# 相关接口

# 相关事件

# 打单软件

# 物流助手-打单软件

# 介绍

商户可以通过打单软件，自助打印面单

# 使用说明

  1. 通过 updatePrinter API 更新打印员。
  2. 打印员扫码登录、选择商户。
  3. 配置热敏打印机（PC端需安装打印机驱动，并选择203dpi分辨率）。
  4. 拉取面单，打印需要的面单；或启用自动打印，新订单下单成功即会自动打印。

# 最新版本下载地址

Windows

支持 Windows XP 及以上版本。

# 更新日志

# v1.0.0 (2019.01.16)

  1. 支持打印员扫码登录。
  2. 支持不同快递配置独立打印机。
  3. 支持手动拉取订单，保存或打印面单。
  4. 支持自动拉取订单、自动打印面单。