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
}
]
}
1947
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
