#簡介
通過聚客微信開放接口,第三方的微信點餐服務可以和聚客收銀系統連接起來,實現客人點餐后直接送廚,訂單也直接錄入收銀系統。
#點菜流程


#連接方式
客戶端和服務器通過websocket保持長連接,當有新訂單時服務器推送給收銀客戶端。
#下單接口
服務器接收到訂單后,主動下發給客戶端,使用json格式。
###服務器發送
|Name|Required|Type|Description|
|---|---|---|---|
|command|true|string|sendorder|
|serial|true|string|服務端訂單號,客戶端記錄該訂單號防止重復下單|
|time|true|int|下單時間,UTC格式|
|type|true|int|0-在桌點菜;1-外賣;2-預訂|
|chk_name|false|string|單名/整單備注|
|table_id|true|int|桌號,外賣訂單則為-1|
|table_name|false|string|桌名,只用于顯示|
|amount|true|double|訂單金額|
|payment|true|int|1 –未支付,2-微信支付 3-會員余額 4-支付寶|
|address|false|string|外賣地址|
|phone|false|string|外賣電話|
|cus_name|false|string|外賣客戶姓名|
|cus_num|false|int|客人數|
|arrive_time|false|int|外賣的送貨時間或者預訂桌臺的時間|
|order_list|true|array|菜品列表|
|id|true|int|菜品id|
|name|false|string|菜品名稱,自定義菜需要|
|num|true|double|菜品數量|
|pu|true|int|菜品的規格|
|cdm|true|int|如果是調味品,則為所屬菜品的id|
|unit|false|string|規格名稱,只用于顯示|
|req|false|string|附加要求|
|pr|false|double|菜品單價|
|ttl|false|double|小計。使用微信支付的模式下使用該字段,否則價格由客戶端計算|
**JSON樣例**
{"command":"sendorder","customer_num":2,"order_list":[{"id":7001,"num":1,"pu":1,"cdm":6001,"req":"不放辣"}],"table_id":1,"employee":"101"}
###返回結果
|Name|Type|Description|
|---|---|---|---|
|command|string|sendorder|
|serial|int|
|result|int|200,送廚成功|
|||錯誤分為2類,可自動恢復的(>0)和不可恢復的:(小于0的錯誤需提示客戶聯系商家)|
|||101,數據庫連接錯誤|
|||102,桌子正在操作|
|||-1,找不到桌子|
|||-2,有菜品沽清|
#沽清菜品
客戶端啟動時發送沽清菜品列表給服務端。當重新設置了沽清時也上傳給服務端。
###客戶端發送
|Name|Type|Description|
|---|---|---|
|command| string| soldouts|
|type| int| 0- 全部, 1-僅更新修改的部分|
|soldouts| 數組| 沽清菜品|
| id| int| 菜品ID|
| pu| int| 沽清的規格(-1或不存在則表示所有規格均沽清)|
| num| int| 剩余份數|