取餐消息提醒推送

1.接口说明

名称	描述
功能	向企业推送取餐消息
HTTP方法	POST
请求方	美团企业版平台
响应方	第三方平台
url	第三方提供
method	peican.reminder.pick

2.重要提示

1、取餐消息提醒推送仅作为消息通知功能，不关注下游服务业务处理结果。下游服务接收通知解析数据成功后，建议异步进行业务处理，及时response如下格式请求响应：
   {"status": 0,"msg": "消息接收成功","data": {}}
2、下游服务接收到通知，请求响应返回数据包含"status"字段，且值为"0"，认为下游服务接收通知成功，其他值均认为接收通知失败。
3、消息通知通过HTTP或HTTPS请求发送，为了避免请求长时间不被响应，设置了超时时间，目前超时时间为5秒，请求超时认为下游服务接收通知失败。
4、建议提供HTTP接口，HTTPS会进行SSL验证，可能存在证书验证不通过的情况。
5、消息推送失败会重试推送，消息通知不保证顺序，请下游服务做好幂等处理。
6、下游服务接收通知失败，美团企业版会重试推送3次，每次时间间隔如下：
   {"第一次重试间隔":"60秒", "第二次重试间隔":"310秒", "第三次重试间隔":"600秒"}

3.公共参数

详见：公共参数说明-公共请求参数

4.业务请求参数

名称	类型	是否必填	示例	说明
data	pickUpMealReminderInfo	是		取餐消息推送数据

pickUpMealReminderInfo

pickUpMealReminderInfo字段说明

名称	类型	是否必填	示例	说明
amount	Integer	是	200	订单总金额，单位：分
take_time_begin	Long	是	1668599100	员工可取餐开始时间
personal_pay_price	Integer	是	100	个人支付金额，单位：分
corporate_pay_price	Integer	是	100	企业支付金额，单位：分
pay_time	Integer	是	1668598583	支付成功时间
staff_id	Long	是	684921	此订单对应的美团企业版员工ID
cabinet_no	String	是	A02-007	取餐码
pick_url	String	是	https://sqt.meituan.com/peican/c/order/cabinet.html?rule_plan_id=1	取餐详情页面
delay_time	Integer	否	0	取餐延迟提醒延迟时间，单位：秒
event_type	String	是	PickUpMealReminderEvt	事件类型 PickUpMealReminderEvt：取餐提醒，指到达取餐时间或到达延迟时间的提醒，包含延迟/非延迟2种。非延迟时delay_time字段为0，延迟提醒时延迟时间为delay_time字段 PickUpMealOverDueMealReminderEvt：超时提醒，指到达取餐结束时间且未取餐时触发的提醒 PickUpMealCompleteReminderEvt：取餐完成提醒，指打开柜子进行取餐时的提醒
order_id	Long	是	287734175571626	订单ID
items	List<GoodsInfo>	是		订单包含的商品信息
hidden_price	Boolean	是	true	是否隐藏菜价
receive_time	Long	是	1668599100	收餐时间

GoodsInfo

GoodsInfo字段说明

名称	类型	是否必填	示例	说明
amount	Integer	是	100	商品单价，单位：分
count	Integer	是	1	商品数量
name	String	是	小炒肉	商品名

5.示例结果

业务请求(加密前的数据)

{
  "method": "peican.reminder.pick",
  "ts": 1668674170,
  "entId": 100749,
  "data": {
    "amount": 101,
    "take_time_begin": 1668599100,
    "personal_pay_price": 0,
    "address": "新地址",
    "pick_url": "https://sqt.waimai.test.sankuai.com/peican/c/order/cabinet.html?rule_plan_id=1744",
    "corporate_pay_price": 101,
    "pay_time": 1668598534,
    "hidden_price": false,
    "event_type": "PickUpMealOverDueMealReminderEvt",
    "staff_id": 684921,
    "cabinet_no": "A02-006",
    "order_id": 287734175571626,
    "items": [
      {
        "amount": 100,
        "count": 1,
        "name": "水晶葡萄1234"
      },
      {
        "amount": 1,
        "count": 1,
        "name": "冰露"
      }
    ],
    "receive_time": 1668599100
  }
}

业务响应

{
    "status": 0,//当且仅当status=0,被认为下游接收通知成功
    "msg": "成功",
    "data": {}
}

{
    "status": 1,//status!=0,均认为下游接收通知失败
    "msg": "参数校验失败",
    "data": {}
}