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