6.1统一消息通知

优质
小牛编辑
122浏览
2023-12-01

说明

统一的线上订单、支付等下发接口。

可以用这一个协议来接收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