关于我们

饿了么开放平台消息推送消息体结构定义

发布时间:2025-05-27

 

个人零费用代理店+,日收入3000+,可兼职做

订单消息1.请参阅OOrder结构体定义,获取订单接口 eleme.order.getOrder2.OOrder.groups.items中name = 商品名称-规格[属性+属性+..] = name-newSpecs.name[attributes.name+attributes.name+...],示例: 厚芋泥波波奶茶-大杯(蔗糖换0卡糖)[少冰+五分糖]

订单状态变更消息订单状态变更结构体说明:

字段名 字段类型 字段说明
orderId String 订单号
state String 订单状态,参见OOrder结构体的OOrderStatus枚举定义
shopId Number 店铺id
updateTime Number 状态变更的时间戳,单位秒
role Number 驱动状态发生变更的操作者角色

 

role角色定义如下:

角色 常量值
下单用户 1
饿了么系统 2
饿了么商户 3
饿了么客服 4
饿了么开放平台系统 5
饿了么短信系统 6
饿了么无线打印机系统 7
饿了么风控系统 8
饿了么订单完结 9

 

完整的推送消息示例:{ "appId":62933118, "requestId": "10135", "type": 12, "message": "{\"orderId\":\"100027500485933656\",\"state\":\"settled\",\"shopId\":968861,\"updateTime\":1482161481,\"role\":3}", "shopId": 968861, "timestamp": 1482161482053, "signature": "A6A1E1FD9D880E184EEC8BFF19DE45D6", "userId": 62864532 }

取消单退单消息取消单退单消息结构体说明:

字段名 字段类型 字段说明
orderId String 订单号
refundStatus String 退单状态,参见OOrder结构体中的OOrderRefundStatus退单状态枚举定义
reason String 退单操作原因描述
shopId Number 店铺id
goodsList List 退单商品列表,参考ORefundOrder结构体中的goodsList定义
refundType String 退单类型,参见ORefundType退单类型状态枚举定义
totalPrice Double 退款金额
updateTime Number 消息发送时间戳,单位秒

 

完整的推送消息示例:

{ "appId":62933118, "requestId": "7637", "type": "30", "message": "{\"orderId\":\"1201961795738011871\",\"refundStatus\":\"applied\",\"reason\":\"用户申请退单\",\"shopId\":150008082,\"updateTime\":1508419376,\"refundType\":\"normal\",\"totalPrice\":16.03,\"goodsList\":[{\"name\":\"黑椒牛柳意大利面[重辣]\",\"quantity\":1,\"price\":5.0},{\"name\":\"冰糖雪梨\",\"quantity\":1,\"price\":0.03},{\"name\":\"狮子头\",\"quantity\":1,\"price\":5.0},{\"name\":\"奶茶[去冰+半塘]\",\"quantity\":2,\"price\":3.0}]}", "shopId": 150008082, "timestamp": 1481694496373, "signature": "A1178A435FB4D4DFE239747E03CC81A4", "userId": 62864532 }

商户售中部分取消(type=39)
使用场景:商家缺货可以选择售中部分取消,饿了么测试/沙箱店铺不支持售中部分退。正式环境线上店铺可以找饿了么业务经理帮忙配置的,配置后即支持部分退。

{ "signature": "3226101BE96F215D80834C86EC330B10", "requestId": "2306272810468325256", "appId": 69259646, "shopId": 510198800, "type": 39, "message": "{\"goodsList\":[{\"name\":\"香辣嗦螺-约500g\",\"price\":12.32,\"quantity\":1,\"skuId\":\"300000********3340\",\"uniqueId\":\"1c1176fd5-****-****-8226-233********6\",\"vfoodId\":20000********833}],\"orderId\":\"80525********549051\",\"reason\":\"商家部分售中退 \",\"refundImages\":[],\"refundStatus\":\"successful\",\"refundType\":\"part\",\"shopId\":510****00,\"totalPrice\":12.94,\"updateTime\":1687881570}", "userId": "699142********09500", "timestamp": 1687881570499 }

/template/Home/AllNew/PC/Static