"api工厂" 使用手册

api接口开箱即用,云后台管理,助力前端,解放后端开发;

不懂编程也能独立开发应用,小步快跑,快速创业!

旨为更懂你!

商家配送服务插件教程

启用插件


  1. 如果你是免费会员户,有点小遗憾,暂时无法使用api工厂的插件功能;
  2. 如果你是专业版会员,那么登录后台,左侧菜单 “工厂设置” --> “插件管理” ,找到 “配送服务” 插件,在线购买开通即可;
  3. 如果你是增值版会员,那么无需做任何操作,你可以免费使用所有的插件功能;


启用模块


左侧菜单 “工厂设置” --> “模块管理” ,找到 “配送服务”  模块,启用模块后刷新页面,你将可以在左侧菜单“配送服务”中看到配送相关的菜单,

image.png


使用说明


配送设置


image.png


有新的配送订单提醒配送员


  • 开启抢单模式
  • 配置“抢单模版消息编号” + “抢单模版消息内容”


配置好上述信息以后,有新的配送订单产生,配送员即可接收到信息提醒,点击信息即可快速进入小程序(前提是配置了“小程序页面路径”)


如果配送员设置了区域编号,那么只有当前订单所在区域(shopIdZt)内的配送员才能收到消息


系统自动派单


如果开启了“自动派单”,那么配送单在一定时间内没有被配送员主动抢单,那么系统会自动将订单分配给可接单的其他配送员。


按配送距离收取配送费


假如有这么一个需求,1公里内免费配送,1 ~ 5 公里,需要收取5元配送费,5 ~ 10 公里需要收取 30元配送费,那么应该如何设置呢?


创建收费规则


首先,你需要创建配送费收取规则,如下图:


image.png


前端展示配送费


前端编码,根据用户配送地址、商家地址,计算配送距离,然后根据下面的前端接口,获取匹配的配送费记录:


image.png


《前端接口文档》


返回示例:


{
  "code": 0,
  "data": [
    {
      "dateAdd": "2020-09-01 11:51:08",
      "distance": 1,
      "fwf1Min": 0,
      "fwf1Name": "基础服务费",
      "fwf1Number": 0,
      "fwf1Type": 0,
      "fwf2Min": 0,
      "fwf2Name": "运费",
      "fwf2Number": 0,
      "fwf2Type": 0,
      "id": 143,
      "userId": 2,
      "ztDiscounts": 0
    },
    {
      "dateAdd": "2020-09-01 11:52:04",
      "distance": 5,
      "fwf1Min": 0,
      "fwf1Name": "基础服务费",
      "fwf1Number": 5,
      "fwf1Type": 0,
      "fwf2Min": 0,
      "fwf2Name": "运费",
      "fwf2Number": 0,
      "fwf2Type": 0,
      "id": 144,
      "userId": 2,
      "ztDiscounts": 0
    },
    {
      "dateAdd": "2020-09-01 11:52:14",
      "distance": 10,
      "fwf1Min": 0,
      "fwf1Name": "基础服务费",
      "fwf1Number": 30,
      "fwf1Type": 0,
      "fwf2Min": 0,
      "fwf2Name": "运费",
      "fwf2Number": 0,
      "fwf2Type": 0,
      "id": 145,
      "userId": 2,
      "ztDiscounts": 0
    }
  ],
  "msg": "success"
}

创建订单接口指定服务费规则


创建订单接口,需要新增一个参数: peisongFeeId

传值即为上一步中接口读到的配送费规则记录对应的 id 字段



image.png


配送员管理


image.png


工作状态


0 可接单 1 休息 2 在路上 3 服务中


身份类型


0 禁用 1 配送员/骑手 2 管理员(可派单)


订单配送流程


指定订单是需要配送的


如果需要使用配送流程,也就是说用户下单以后,系统自动会生成一个配送订单,继而可以自动 / 手动 / 抢单 的方式分配给对应的配送员进行配送。那么,您必须在创建订单的时候,指定该订单是需要自动配送的:


创建订单接口,指定参数:autoPeisong = true


image.png


系统自动生成配送订单


创建订单时候如果指定了autoPeisong=true,那么在下述几个环节,系统会自动创建配送订单:

  • 货到付款的订单,下单立即创建配送单
  • 用户完成支付时候创建配送单
  • 管理员后台设置为已支付创建配送单
  • 管理员在后台使用用户余额支付订单


系统生成配送订单的同时,也会生成并记录这个配送订单的订单明细(何时创建、何时接单、何时开始配送、何时完成配送等等);同时商城订单状态会被设置为已发货状态


所以,此类订单,除了要根据商城订单的状态,还需要根据对应的配送订单的状态来给用户展示整体订单的情况。


订单列表 / 订单明细会同时返回两个状态:

  • status

-1 关闭订单 0 待支付 1 已支付待发货 2 已发货待确认 3 确认收货待评价 4 已评价

  • peisongStatus

1 待接单; 2 待取货(餐); 3 配送中; 4 已完成; 5 已取消; 6 预留; 7 预留; 8 预留; 9 退回中; 10 已退回;


➌新订单通知所有配送员


根据“配送设置”里的新订单提醒配置,提醒相应的配送员去接单。


➍配送员抢单


“配送设置” 中开启抢单模式的情况下,可以通过前端配送订单可抢单列表接口,读取到所有待接单的订单,配送员根据自己的实际情况考虑是否接单,调用接单接口,完成抢单操作:


image.png


image.png


➎超时未抢单系统自动派单


开启自动配单后,超时配送单,系统自动派单给配送员


➏管理员手动派单


配送员管理里的管理员,可以将某个配送单,手动的分配给某个配送员


image.png


配送服务


通过前端相对应的接口,完成最终的配送服务


image.png

Copyright © 杭州于芯科技有限公司

浙ICP备15041833号