[TOC=2]
## 枚举变量
>[info] 订单相关的枚举变量说明(前端类似下拉框)
> 需要用到变量的时候，请自行比对。
### 劳务费计算方式参数如下(charging_method)：
| 可选值 | 说明 |
| --- | --- |
| total | 总价包干 |
| per_unit | 按件计算 |
| per_day | 按天计算 |
| null | 电话议价 |
### 订单类型参数如下(type)：
| 可选值 | 说明 |
| --- | --- |
| bid | 招标 |
| phone_reservation | 电话预约 |
| online_reservation | 在线预约 |
### 订单状态说明(status)：
| 可选值 | 说明 |
| --- | --- |
| pending | 待支付，如果雇主需要付费才能招工，会进入此状态 |
| processing | 处理中，如果是招标单，表示招标中；如果是预约单，表示等待工人确认 |
| succeed | 成功，已选择招标候选，或预约已被确认 |
| finished | 已完成，或者工人没来都算作完成状态 |
| cancelled | 已取消，超时未成功招工或预约被拒绝 |
| timeout | 招标或预约未及时处理，雇主的单没有选人，民工没有及时同意预约，都算超时 |
| refused | 预约被拒绝 |
### 订单额外状态说明(sub_status)：
| 可选值 | 说明 |
| --- | --- |
| normal | 正常 |
| absence | 招工成功但工人没来 |
| labour_cancelled | 工人取消 |
### 取消招工原因说明(cancel_reason)：
| 可选值 | 说明 |
| --- | --- |
| just_trying | 只是试一下 |
| no_need | 不需要了 |
| dislike_labour | 不想找这个工人 |
| better_platform | 从其它渠道找到工人了 |
| others | 其它原因 |
| time | 时间不合适 |
| price | 价格不合适 |
| cant_contact | 没有联系上 |
| null | 民工取消 |
### 支付方式说明(pay_method):
>[info] 后台暂时只设置微信支付，前端仅能微信支付。
| 可选值 | 说明 |
| --- | --- |
| wechat | 微信支付 |
## 订单列表
>[info] 当前页默认第 1 页，页码默认10 条。需要修改的话，自己传参数替换。
>订单状态详情见枚举变量。 processing 表示招工中(默认)， succeed 表示招工成功， finished 表示未评价的订单
~~~[api]
get:/order/list
int:current_page=1#当前页
int:page_number=10#页码
string:status=processing#订单状态
<<<
success
{
"code": 0,
"data": [
list:[{
"id": 1,
"title": "标题",//标题
"description": "描述",//描述
"employer_name": "雇主名",//雇主姓名
"employer_phone": "雇主电话",//雇主手机号
"employer_id": 2,//雇主id
"labour_id": null,//民工id
"job_category_name": "工种名称",//工种名
"job_name": "工作/蔬菜名",//工种/蔬菜名
"specifications": [],//具体工种内容
"address": [],//详细上工地址
"reservation_time": "2017-01-01 01:01:01",//上工时间
"labour_number": 3,//招工人数
"charging_method": "total",//计费方式
"cost": 1000,//劳务费用
"with_shuttle": false,//是否接送 false 不接送 true 接送
"memo": "",//订单备注信息
"type": "bid",//订单类型 详情见 枚举变量
"status": "pending",//订单状态 详情见 枚举变量
"sub_status": "normal",//订单额外状态 详情见 枚举变量
"cancel_reason": null,//取消招工原因
"employer_rated": false,//是否评价 false 未评价 true 已评价
"labour_rated": false,//民工是否评价 false 未评价 true 已评价
"extra": [],//订单其他信息
"publish_time": null,//订单发布时间
"finish_time": null,//订单完成时间
"create_time": "2018-01-26 17:34:09",//订单创建时间
"update_time": "2018-01-26 17:34:09",//订单修改时间
"labour_info": null,//民工资料
"reservations": []
}],
"current_page": 1,//当前页
"page_number": 10,//页码
"processing": 0,//招工中订单数
"succeed": 0,//招工成功订单数
"finished": 0//未评价订单数
]
}
<<<
success2
{
"code": 0,
"data": {
"list": [
{
"id": 8,//订单id
"title": "暂无title",//订单标题
"description": "32132323",//订单描述
"employer_name": "232",//用工人姓名
"employer_phone": "13551344444",//用工人手机号
"employer_id": 3,//雇主id
"labour_id": 2,//被选中民工id
"job_category_name": "推粪包沟",//工种名
"job_name": "71212",//工作名、蔬菜名
"specifications": [//工作详细内容
{
"工作量": "32323袋/立方",
"包装方式": "60公斤袋装",
"服务内容": "推粪撒粪",
"粪肥类型": "干鸡粪"
}
],
"address": [//上工地址
{
"id": 2,
"area": "化龙区域",//所在区域名
"city": "潍坊市",//市名
"name": "232",//用工人姓名
"town": "化龙镇",//镇名
"phone": "13551344444",//用工人手机号
"area_id": 399,//所在区域id
"user_id": 3,//用户id
"village": "马庄村",//村名
"district": "寿光市",//市名
"province": "山东省",//省名
"is_default": false//是否默认地址
}
],
"reservation_time": "2018-03-02 00:00:00",//上工时间
"labour_number": 23,//招工人数
"charging_method": "total",//计费方式
"cost": 32132300,//劳务费用
"with_shuttle": true,//是否接送 true 接送 false 不接送
"memo": "23",//其他信息
"type": "bid",//订单类型 详情见枚举变量
"status": "processing",//订单状态 详情见枚举变量
"sub_status": "normal",//订单子状态 详情见枚举变量
"cancel_reason": null,//取消原因 详情见枚举变量
"employer_rated": false,//雇主是否评价 false 未评价 true 已评价
"labour_rated": false,//民工是否评价 false 未评价 true 已评价
"extra": "",//订单其他信息
"publish_time": "2018-02-27 15:57:04",//发布时间
"finish_time": null,//订单完成时间
"create_time": "2018-02-27 15:56:59",//订单创建时间
"update_time": "2018-02-27 15:57:04",//订单更新时间
"pay_id": 8,//订单支付id
"order_number": "Z151971822478586",//订单支付编号
"reservations": [//抢单人信息
{
"id": 3,//民工id
"phone": "13551347777",//民工手机号
"name": "2652",//民工姓名
"avatar": null,//民工头像地址
"birthday": null,//民工生日
"gender": "secret",//性别
"member_number": 323233,//队伍人数
"rate1": 85,//评分1
"rate2": 85,//评分2
"rate3": 85,//评分3
"job_categories": null,//服务的工种
"price": 0//参考报价
},
{
"id": 2,
"phone": "15181474781",
"name": "王大锤",
"avatar": null,
"birthday": null,
"gender": "secret",
"member_number": 3213,
"rate1": 85,
"rate2": 85,
"rate3": 85,
"job_categories": null,
"price": 0
}
],
"labour_info": {//被选中的民工信息
"id": 2,
"phone": "15181474781",
"name": "王大锤",
"avatar": null,
"birthday": null,
"gender": "secret",
"member_number": 3213,
"rate1": 85,
"rate2": 85,
"rate3": 85,
"job_categories": null,
"price": 0
}
}
],
"current_page": 1,//当前页
"page_number": 1,//页码
"processing": 6,//招工订单数
"succeed": 0,//成功订单数
"finished": 0//未评价订单数
}
}
~~~
## 历史订单
>[info] 历史订单查询的是所有的订单
~~~[api]
get:/order/history
int:current_page=1#当前页
int:page_number=10#页码
<<<
success
{
"code": 0,
"data": [
{
"id": 1,
"title": "标题",//标题
"description": "描述",//描述
"employer_name": "雇主名",//雇主姓名
"employer_phone": "雇主电话",//雇主手机号
"employer_id": 2,//雇主id
"labour_id": null,//民工id
"job_category_name": "工种名称",//工种名
"job_name": "工作/蔬菜名",//工种/蔬菜名
"specifications": [],//具体工种内容
"address": [],//详细上工地址
"reservation_time": "2017-01-01 01:01:01",//上工时间
"labour_number": 3,//招工人数
"charging_method": "total",//计费方式
"cost": 1000,//劳务费用
"with_shuttle": false,//是否接送 false 不接送 true 接送
"memo": "",//订单备注信息
"type": "bid",//订单类型 详情见 枚举变量
"status": "pending",//订单状态 详情见 枚举变量
"sub_status": "normal",//订单额外状态 详情见 枚举变量
"cancel_reason": null,//取消招工原因
"employer_rated": false,//是否评价 false 未评价 true 已评价
"labour_rated": false,//民工是否评价 false 未评价 true 已评价
"extra": [],//订单其他信息
"publish_time": null,//订单发布时间
"finish_time": null,//订单完成时间
"create_time": "2018-01-26 17:34:09",//订单创建时间
"update_time": "2018-01-26 17:34:09",//订单修改时间
"labour_info": null,//民工资料
"reservations": []
}
]
}
~~~
## 创建订单(招标订单)
>[info] 创建订单，需要填写值的就必须填写。不需要填写值的可以填写，也可以不用填写，可以填空字符串。
>订单标题和描述 建议通过蔬菜和工种拼接，没有可以填空字符串。描述不知道填什么就填写空字符串。
>用工地址 建议直接将选出的一行数据 存到 address 里面
~~~[api]
post:/order/create
*string:title=标题#订单标题
*string:description=描述#订单描述
*string:employer_name=雇主姓名#雇主姓名
*string:employer_phone=13333333333#雇主手机号
*string:job_category_name=工种名#工种名
*string:job_name=工作名#工作名/蔬菜名
*json:specifications=[{}]#具体的工作内容
*json:address=[{}]#用工详细地址
*date:reservation_time=2017-01-01 11:22:22#上工时间
*int:labour_number=1#招工人数
*string:charging_method=total#劳务费计算方式
*int:cost=1#劳务费用
*boolean:with_shuttle=true#是否接送
string:memo=其他信息#其他说明
*string:type=bid#订单类型
*json:extra=[{}]#订单其他信息
<<<
success
{
"code": 0,
"data": {
"id": "8"//订单id
}
}
<<<
error
{
"msg": "参数错误",
"code": -1
}
~~~
## 创建订单(选人或者电话预约)
>[info] 招标单 类型只能是 phone_reservation 电话单 或者 online_reservation 在线预约单
>民工 id 必填 且大于 0
>订单标题和描述 建议通过蔬菜和工种拼接，没有可以填空字符串。描述不知道填什么就填写空字符串。
~~~[api]
post:/order/labour
*string:title=标题#标题
*string:description=描述#描述
*string:employer_name=用工人姓名#用工人姓名
*string:employer_phone=13333333333#用工人手机号
*string:job_category_name=工种名#工种名
*string:job_name=工作名#工作名
*string:specifications=[{}]#工作详细内容
*json:address=[{}]#上工地址
*string:type=phone_reservation#招工类型
*int:labour_id=1#民工id
<<<
success
{
"code": 0,
"data": {
"id": "1"//订单id
}
}
<<<
error
{
"code": -1,
"msg": "民工id格式不正确"
}
~~~
## 支付费用合计
~~~[api]
post:/order/planning
*int:order_id=1#订单id
<<<
success
{
"code": 0,
"data": {
"fee": 500,//应付费用
"discount": 0,//信用抵扣
"pay_by_balance": 100,//红包抵扣
"pay_by_points": 100,//积分抵扣
"pay_cost_points": 100,//积分抵扣
"fee_real": 300,//实际应付
"balance": 100,//可用红包金额
"point": 100,//可用积分
"order_id": 1,//订单id
"average": 59,//信用评分
"balance_max_deduction": 1000,//红包最多抵扣
"points_max_deduction": 1000//积分最多抵扣
}
}
<<<
error
{
"code": -1,
"msg": "参数错误"
}
~~~
## 去支付
~~~[api]
post:/order/pay
*int:order_id=1#订单id
*string:pay_method=wechat#支付方式，具体参数见枚举变量
<<<
success
// 成功返回 不需要支付任何费用，费用被抵扣完。
{
"code": 0,
"data": {
"order_id": 3//订单id
}
}
<<<
success
//成功返回 需要微信支付
{
"code": 0,
"data": {
"order_id": 3//订单id
//.. 支付相关参数
}
}
<<<
error
{
"code": -1,
"msg": "参数错误"
}
~~~
## 查询支付状态
~~~[api]
get:/order/read
*int:order_id=1#订单id
<<<
success
{
"code": 0,
"data": {
"status": "processing"//订单状态 详细值 见枚举变量
}
}
<<<
error
{
"code": 0//订单号码错误
}
~~~
## 招标单(选人)
~~~[api]
post:/order/selectPerson
*int:order_id=1#订单id
*int:labour_id=1#民工id
<<<
success
{
"code": 0
}
<<<
error
{
"code": -1,
"msg": "招工已经结束"
}
~~~
## 结束订单
>[info] 结束原因 参考 枚举变量
~~~[api]
post:/order/finished
*int:order_id=1#订单id
stirng:sub_status=normal#结束原因
<<<
success
{
"code": 0
}
<<<
error
{
"code": -1,
"msg": "招工已经结束"
}
~~~
## 取消订单
~~~[api]
post:/order/cancel
*int:order_id=1#订单id
sting:cancel_reason=null#取消原因
<<<
success
{
"code": 0
}
<<<
error
{
"code": -1,
"msg": "招工已经结束"
}
~~~
## 创建电话预约单
>[info]首页发布订单 phone_type 填写 home 工种流程发布填写 jobs
>首页发布只需要填写，民工 id 和类型，其他后台默认填写
>再次约他，也可以这样来创建订单
~~~[api]
post:/order/phone
*string:phone_type=home#发布订单类型
*string:title=标题#标题
*string:description=描述#描述
*string:employer_name=用工人姓名#用工人姓名
*string:employer_phone=13333333333#用工人手机号
*string:job_category_name=工种名#工种名
*string:job_name=工作名#工作名
*string:specifications=[{}]#工作详细内容
*json:address=[{}]#上工地址
*string:type=phone_reservation#招工类型
*int:labour_id=1#民工id
<<<
success
{
"code": 0,
"data": {
"id": "1"//订单id
}
}
<<<
error
{
"code": -1,
"msg": "民工id格式不正确"
}
~~~
- 使用须知
- 共用数据
- 数据库
- 管理员
- 管理--登录注册
- 管理--个人资料
- 管理--工种相关
- 管理--工作相关
- 管理--蔬菜分类
- 管理--订单相关
- 管理--用户相关
- 管理--消息相关
- 管理--banner
- 管理--认证相关
- 管理--蔬菜改版
- 雇主端
- 雇主--登录注册
- 雇主--个人资料
- 雇主--设备相关
- 雇主--控制设备
- 雇主--用工地址
- 雇主--我的收藏
- 雇主--工种相关
- 雇主--我的订单
- 雇主--我的红包
- 雇主--评价订单
- 雇主--消息相关
- 雇主--积分相关
- 雇主--民工列表
- 雇主--banner
- 雇主--邀请注册
- 雇主--分享民工
- 民工端
- 民工--登录注册
- 民工--个人资料
- 民工--我的红包
- 民工--订单相关
- 民工--我的订单
- 民工--评价订单
- 民工--消息相关
- 民工--积分相关
- 民工--认证相关
- 民工--工种相关
- 民工--会员相关
- 民工--分享相关
- 民工--服务区域
- 民工--服务技能
- 民工--邀请注册