6.1统一消息通知
说明
统一的线上订单、支付等下发接口。
可以用这一个协议来接收1.1,1.4,2.1,7.3等多个需要轮询的协议,并且使用“长连接”,消息接收能做到准实时(延时缩小到1秒左右)
目前支持下发的业务类型名称如下:
do-new:未确认的新订单,数据对应协议1.4
do-order:已确认的新订单,数据对应协议1.1
cash-request: 桌台拉账单请求,数据对应协议2.1中state=0
cash-pay: 线上支付完成通知,数据对应协议2.1中state=2,3
bk-new: 新预订订单,数据对应协议7.3
do-state:订单状态变化,主要用于外卖订单状态变化时通知线下
接口请求流程:
1.线下发起请求后,如果没有数据,则平台不直接返回,而是继续会等待相应数据,如果中间有数据直接返回,没有数据时最长90秒返回。
2.线下请保证通讯超时不少于90秒
3.线下收到平台返回后(有数据进入业务处理流程),马上重新获取连接,无需等待5秒
注意:
1.消息下发以后就算消费1次,如果获得消息一直不处理,当消息计数超过3以后,这条消息将删除,不再下发
请求地址
http://api.dc78.cn/Api/que_list
请求方式
GET
请求参数
set=do-order,cash-request,cash-pay
可以设置请求set参数来过滤线下需要的业务消息,如果不设置set参数,默认返回do-order,cash-request,cash-pay三个分类的消息
invoice=1 设置该参数备注(memo字段)与发票信息(invoice字段)分别单独显示,不设置invoice参数,默认将发票和备注信息合并到(memo字段)显示返回
{
"status": "1",
"list": [
{
"cate": "do-new",
"list": [
{
"id": "1776951",
"msid": "1559",
"time": "2016-11-01 10:52:38",
"date": "20161101",
"type": "0",
"cate": "10",
"phone": "15606132502",
"cust": "张三丰",
"state": "0",
"count": "1",
"table": "2001",
"cfmtime": "1970-01-01 08:00:00",
"cfmcode": "",
"cfmuser": "",
"pscount": "",
"memo": "",
"addr": "",
"payid": "0",
"paytype": "0",
"queue_id": "do-new_1776951_0",
"invoice":"发票标题:苏州果盘网络技术有限公司,纳税人识别号:1111,类型:公司"
}
]
},
{
"cate": "cash-pay",
"list": [
{
"id": "2631012",
"state": "2",
"type": "1",
"table": "2001",
"mbextid": "",
"mbaccid": "452220",
"mbcardno": "4522202",
"mblevel": "3",
"cate": "dopay",
"src": "wx",
"doid": "1776850",
"bzid": "",
"amt": "36.00",
"discount": "0.00",
"payamt": "36",
"pay_co": "0",
"pay_mc": "32.4",
"pay_pt": "3.6",
"pay_wx": "0.00",
"pay_ali": "0",
"time": "2016-11-01 10:25:14",
"trid": "",
"queue_id": "cash-pay_2631012_0",
"invoice":"发票标题:苏州果盘网络技术有限公司,纳税人识别号:1111,类型:公司"
}
]
},
{
"cate": "do-state",
"list": [
{
"id": "6570429",
"state": "-1",
"queue_id": "do-state_6570429x-1_0"
},
{
"id": "6571255",
"state": "-1",
"queue_id": "do-state_6571255x-1_0"
},
{
"id": "6571276",
"state": "-2",
"queue_id": "do-state_6571276x-1_0",
"refund":[
{
"type":"1", // 1:部分退款 2:全部退款
"qty":"1", // 数量
"price":"17" // 菜品价格
"amt":"17", // 退款总金额
"dishes_name":"鱼香肉丝",
"msg":"菜品部分退款",
"gdsid":"2121"
}
]
}
]
}
],
"request_time": "2016-11-01 11:41:11",
"server_time": "2016-11-01 11:41:12",
"server_name": "wx4#"
}
2017-08-09,增加do-state消费分类,用于推送外卖平台订单状态变化消息
2018-06-11,增加退款类型,state=-2 推送菜品退款信息
请求方式
INI
请求参数
[action] | 描述 |
action=que_list |
返回
[result]
status=1
list=array:2
[result_list_0]
cate=do-new
list=array:1
[result_list_0_list_0]
id=1776951
msid=1559
time=2016-11-01 10:52:38
date=20161101
type=0
cate=10
phone=15606132502
cust=张三丰
state=0
count=1
table=2001
cfmtime=1970-01-01 08:00:00
cfmcode=
cfmuser=
pscount=
memo=
addr=
payid=0
paytype=0
queue_id=do-new_1776951_0
[result_list_1]
cate=cash-pay
list=array:1
[result_list_1_list_0]
id=2631012
state=2
type=1
table=2001
mbextid=
mbaccid=452220
mbcardno=4522202
mblevel=3
cate=dopay
src=wx
doid=1776850
bzid=
amt=36.00
discount=0.00
payamt=36
pay_co=0
pay_mc=32.4
pay_pt=3.6
pay_wx=0.00
pay_ali=0
time=2016-11-01 10:25:14
trid=
queue_id=cash-pay_2631012_0
[result] | 描述 |
status=1 | |
list=array:2 | |
[result_list_0] | 描述 |
cate=do-new | |
list=array:1 | |
[result_list_0_list_0] | 描述 |
id=1776951 | |
msid=1559 | |
time=2016-11-01 10:52:38 | |
date=20161101 | |
type=0 | |
cate=10 | |
phone=15606132502 | |
cust=张三丰 | |
state=0 | |
count=1 | |
table=2001 | |
cfmtime=1970-01-01 08:00:00 | |
cfmcode= | |
cfmuser= | |
pscount= | |
memo= | |
addr= | |
payid=0 | |
paytype=0 | |
queue_id=do-new_1776951_0 | |
[result_list_1] | 描述 |
cate=cash-pay | |
list=array:1 | |
[result_list_1_list_0] | 描述 |
id=2631012 | |
state=2 | |
type=1 | |
table=2001 | |
mbextid= | |
mbaccid=452220 | |
mbcardno=4522202 | |
mblevel=3 | |
cate=dopay | |
src=wx | |
doid=1776850 | |
bzid= | |
amt=36.00 | |
discount=0.00 | |
payamt=36 | |
pay_co=0 | |
pay_mc=32.4 | |
pay_pt=3.6 | |
pay_wx=0.00 | |
pay_ali=0 | |
time=2016-11-01 10:25:14 | |
trid= | |
queue_id=cash-pay_2631012_0 |