0.3下行接口消息

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

平台主动生成并向下推送的接口称为“下行接口”,下行接口采用推送方式。

平台生成的订单、支付、预订等订单、支付信息会通过下行接口推送到门店系统。

注意:MQ推送的消息只包含必要的消息内容,没有对应的业务详情数据,各主题消息可能需要额外的调用来获取消息的详情(DLL接口中已封装处理,不需要额外的调用)。

下行接口包含所有业务模块需要向下推送的消息,需要根据推送消息的主题对应各业务处理流程。消息主题说明如下表格:

主题业务归属描述消息详情后续业务调用
do-order订单堂食、外卖已确认订单文档1.11.3/do_confirm
do-state订单订单状态发生变化,如:取消
do-new订单未确认订单,采用门店接口确认模式时才会发送些消息文档1.11.3/do_confirm
do-sync订单堂食桌台账单同步1.7/do_sync_tablebill
cash-request支付桌台秒付账单请求文档2.52.2/cash_post_bill
cash-pay支付秒付、快捷支付完成后推送文档2.52.3/cash_post_cash
bk-new预订预订单推送文档7.17.2/bk_state
sys-notify通知系统发送的通知,如网络断开等信息
inv-state电票开票状态变化通知文档12.312.3/invoice_get_detail


下行推送消息格式

1.do-order

{
    "type": "do-order",
    "timeout": "2019-07-22 20:10:08",
    "data": {
        "msid": "20243",
        "id": "8600051098",
        "time": "2019-07-22 18:10:08"
    }
}
id:订单id。订单数据格式详见1.1

2. do-sync
{
    "type": "do-sync",
    "timeout": "2019-07-22 18:30:03",
    "data": {
        "msid": "20243",
        "table": "778",
        "bzid": "201907220012",
        "time": "2019-07-22 18:10:03"
    }
}
table:桌台
bzid:收银系统账单号
注:bzid/table参数可能都有,优先使用bzid匹配账单数据。如没有bzid则使用table桌台匹配账单。

3.sys-notify
{
    "type": "sys-notify",
    "timeout": "2019-07-22 18:30:03",
    "data": {
        "msg": "网络连接断开,正在尝试重连",
        "cate": "net_error"
    }
}
cate目前可能为:net_error,net_restored

4.invoice

{
    "type": "inv-state",
    "timeout": "2020-03-25 12:10:35",
    "data": {
        "id": "49",
        "time": "2020-03-25 10:10:35"
    }
}
id:电票记录id,通过id调用12.3获取开票详情