0.3下行接口消息
优质
小牛编辑
131浏览
2023-12-01
平台主动生成并向下推送的接口称为“下行接口”,下行接口采用推送方式。
平台生成的订单、支付、预订等订单、支付信息会通过下行接口推送到门店系统。
注意:MQ推送的消息只包含必要的消息内容,没有对应的业务详情数据,各主题消息可能需要额外的调用来获取消息的详情(DLL接口中已封装处理,不需要额外的调用)。
下行接口包含所有业务模块需要向下推送的消息,需要根据推送消息的主题对应各业务处理流程。消息主题说明如下表格:
主题 | 业务归属 | 描述 | 消息详情 | 后续业务调用 |
do-order | 订单 | 堂食、外卖已确认订单 | 文档1.1 | 1.3/do_confirm |
do-state | 订单 | 订单状态发生变化,如:取消 | 无 | 无 |
do-new | 订单 | 未确认订单,采用门店接口确认模式时才会发送些消息 | 文档1.1 | 1.3/do_confirm |
do-sync | 订单 | 堂食桌台账单同步 | 无 | 1.7/do_sync_tablebill |
cash-request | 支付 | 桌台秒付账单请求 | 文档2.5 | 2.2/cash_post_bill |
cash-pay | 支付 | 秒付、快捷支付完成后推送 | 文档2.5 | 2.3/cash_post_cash |
bk-new | 预订 | 预订单推送 | 文档7.1 | 7.2/bk_state |
sys-notify | 通知 | 系统发送的通知,如网络断开等信息 | 无 | 无 |
inv-state | 电票 | 开票状态变化通知 | 文档12.3 | 12.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获取开票详情