[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格式不正確" } ~~~