dohko环境：http://172.16.0.55:8078

生产环境：餐厅内部(或者集团内部)pos-client安装程序所在IP:PORT

1、批量新增或修改桌台数据

执行操作

餐饮软件批量将桌台传入订多多

新增：根据appID+posTableID查询数据库，没有对应桌台。

修改：根据appID+posTableID查询数据库，有对应桌台。

请求地址：/addOrUpdate.htm?tables=请求参数

请求方式method=post

请求参数：

[

{

"appID":"yst",

"dddTableID":0,

"posTableID":"555555",

"posTableName":"桌台15",

"areaName":"C区",

"tableType":1,

"maxPeople":2,

"isChanged":0,

"status":0

}

]

返回结果：

{

"code":"000",

"success":true,

"message":"请求成功",

"data":[

{

"id":5,

"appID":"yst",

"dddTableID":0,

"posTableID":"555555",

"posTableName":"桌台15",

"areaName":"C区",

"tableType":1,

"maxPeople":2,

"isChanged":0,

"status":0

}

]

}

2、查询门店所有桌台

请求地址： /query.htm?appID=yst

appID：门店登陆用户名返回结果：

{

"code":"000",

"success":true,

"message":"请求成功",

"data":[

{

"id":1,

"appID":"yst",

"dddTableID":419,

"posTableID":"111111",

"posTableName":"桌台5",

"areaName":"B区",

"tableType":1,

"maxPeople":2,

"isChanged":0,

"status":0

}

]

}

3：开台/加桌请求

执行操作

<1：餐饮软件主动开台(新增订单)

每次一单一桌(orderID唯一UUID)

a、如果桌台已被占用，创建消费成功的散客单。

b、桌台未占用，创建客到状态的预订单。

<2：餐饮软件开台预订单(修改订单)(orderID：订单的orderCode)

开台：订单下有此桌台，即开台操作。

加桌：订单下没有此桌台，即加台操作。

流程

桌台为占用状态(指预订、客到、预留状态)：开散客订单，状态为消费成功1006

桌台没占用状态(指预订、客到、预留状态)：开散客订单，(订单状态：客到状态1002)，支付成功修改为消费成功状态1006。

订多多订单参数

接单人：预订台

餐段：为订多多当前时间的餐段，如果为空闲时间段，顺延至下一餐段。

就餐时间：为当前时间

就餐人数：桌台的最低就餐人数

请求示例(POST方式)：

返回结果示例：

{'code':'000','message':'成功','data':{'orderID':'1234567891234567891','tableID':123}}

参数说明：

参数描述

appID餐厅应用ID(订多多开放服务提供)

orderID预订单唯一标识，餐饮软件主动开台需要传入uuid

对应订多多字段标识：orderCode

tableID桌位号唯一标识

people就餐人数(非必填)

requestID请求id

orderDateTIme下单日期时间

(格式:yyyyMMddHHmm)(非必传)

返回参数说明：

参数描述

code全局状态码

4：换台/对调请求

执行操作

换桌台\对调

如果两个订单ID值相等是换桌，如果不一样是对调

输入示例(POST)：

返回结果示例：

{'code':'000','message':'成功','data':{'orderID':'abcde34778855','torderID':'abc15368984122','otableID':123,'ttableID':456}}

参数说明：

参数描述

appID餐厅应用ID(订多多开放服务提供)

orderID预订单唯一标识

cmd1：换桌2：对调

torderID目标订单(注意：换桌时候torderID和orderID传相等的值)

otableID原桌位号唯一标识

ttableID目标桌位唯一标识

requestID请求id

返回参数说明：

参数描述

code全局状态码

5：撤台请求

执行操作

1：餐饮软件主动开台的散客订单

撤台每次一单一桌(订单orderID唯一)

2：餐饮软件撤台预订单(预订状态，未开台)

每次一单一桌(对于一单多桌情况，同一订单号调用多次，每次撤台不同桌位)

3：当预订单由客到状态撤单变为预订状态后，预订台，允许再次撤单(POS不允许)。

输入示例(POST)：

返回结果示例：

{'code':'000','message':'成功','data':{'orderID':'1234567891234567891','tableID':123}}

参数说明：

参数描述

appID餐厅应用ID(订多多开放服务提供)

orderID预订单唯一标识

tableID桌位号唯一标识

requestID请求id

返回参数说明：

{'code':'000','message':'成功','data':{'orderID':'1234567891234567891','orderStatus':1003}}

撤单后订单状态

1001：预订

1003：撤单

如果是1001预订状态

POS端还不允许删除此单，可以继续开台

参数描述

code全局状态码

6：撤销预订台开台的订单

执行操作

客户端根据是预订台开台的订单调用此接口

预订台开台的订单，POS调用撤销后，将重置为预订的状态

输入示例(POST)：

返回结果示例：

{'code':'000','message':'成功','data':{'orderID':'1234567891234567891','tableID':123}}

参数说明：

参数描述

appID餐厅应用ID(订多多开放服务提供)

orderID预订单唯一标识

tableID桌位号唯一标识

requestID请求id

返回参数说明：

{'code':'000','message':'成功','data':{'orderID':'1234567891234567891','orderStatus':1003}}

参数描述

code全局状态码

7：桌位订单结算请求

只取需要的字段更新订单信息

1：修改订单桌台的金额、就餐人数

2：修改订单桌台的状态为1006成功

输入示例：

请求接口(POST)：

返回结果示例：

{'code':'000','message':'成功','data':{'orderID':'1234567891234567891','tableID':123}}

输入参数说明:

参数描述

appID餐厅应用ID(订多多开放服务提供)

orderID预订单唯一标识

tableID桌位唯一标识

posOrderNumber结账单号

orderMoney实收金额

posPayMoney应收金额

posCardMoney储值余额

pointsMoney积分余额

people就餐人数

posOrderTime结账时间(yyyyMMddHHmmss)

othermoney其他结帐方式及金额

如：

1=529(应收与PosPayMoney相同)

2=70(现金)

3=60(储值卡)

4=80(会员卡)

5=77(折扣)

6=80(午餐券)

7=90(代金券)

8=12(抹零)

requestID请求id

mergeTableIDs合并结账桌台列表，orderID传入"[mergeOrder]"

如果传入此参数的时候，找到当餐POS开台桌台(不用加此where orderID=#{orderID}条件)

将传入桌台列表修改为消费成功，这里会将合并桌台的一个桌台的消费金额设置为传入的金额，其他桌台设置为0元。

menuSkuList传入菜品列表格式

skuID：单品ID，skuQty：单品数量，skuAmount：单品总额

menuSkuList=[

{

"skuAmount":20.5,

"skuID":1,

"skuQty":2

},

{

"skuAmount":20.5,

"skuID":1,

"skuQty":2

}

]

mergeTableIDskuList对应mergeTableIDs参数，传入菜品列表格式

skuID：单品ID，skuQty：单品数量，skuAmount：单品总额

mergeTableIDskuList=[

{

"tableID":1,

"skus":[

{

"skuAmount":20.5,

"skuID":1,

"skuQty":2

},

{

"skuAmount":20.5,

"skuID":1,

"skuQty":2

}

]

},

{

"tableID":2,

"skus":[

{

"skuAmount":100,

"skuID":5,

"skuQty":3

}

]

}

]

返回参数说明：

参数描述

code全局状态码

8、批量新增或修改菜品数据

执行操作

餐饮软件批量将菜品传入订多多

1新增：根据appID+posSkuID+posUnitName查询数据库，没有对应菜品。

2修改：根据appID+posSkuID+posUnitName查询数据库，有对应菜品。

请求地址：/menu/batchMod.htm?menuSkuList=请求参数

请求方式method=post

请求参数：

[

{

"appID":"pos555",

"posSkuID":"3",

"dddSkuID":0,

"posMenuName":"pos麻婆豆腐",

"posUnitName":"pos大份",

"posMenuTypeName":"pos川菜",

"posMenuCode":"pos003",

"isChanged":1,

"status":0

}

]

返回结果：

{

"code":"000",

"success":true,

"message":"请求成功"

}

9、查询门店所有菜品

请求地址： /menu/query.htm?appID=yst

appID：门店登陆用户名返回结果：

{

"code":"000",

"success":true,

"message":"成功",

"data":[

{

"id":17,

"appID":"pos555",

"posSkuID":"3",

"dddSkuID":645,

"posMenuName":"pos麻婆豆腐",

"posUnitName":"pos大份",

"posMenuTypeName":"pos川菜",

"posMenuCode":"pos003",

"isChanged":1,

"status":0

}

]

}